NPrinting recipients are people, directories or e-mail addresses that you want to send output to. With NPrinting you can create recipients manually or import them from a variety of sources including:
When importing recipients, you can:
You can save import parameters and create Recipient Import Tasks which will periodically check the data source for new and modified recipients and load these into NPrinting.
Download the NPrinting Training environment which may be found here NPrinting Training Material contains all files show in this tutorial. Extract the NP_Training.zip into the C:\NPrintingTraining folder.
NOTE: do NOT modify the recipient import file such that additional sheets are added. The file is a single sheet only. NPrinting does not support the use of a multi sheet xlsx recipient import file.
Recipients have the new Details tab that contains the following fields:
All these fields are usable in email messages and can be set manually or imported by the Recipient Imports entity.
Manage recipient filters manually:
When sending reports to a recipient, all active recipient, task and report filters will be applied in the order: Task - Recipient – Report. Filters in an entity are applied sequentially in the listed order from top to bottom.
Filters created in the Recipient are not public and so, not available for independent application.
NPrinting can import recipients from a variety of sources including text and Excel files, directory services using LDAP, as well as from Access, SQL Server, Oracle and many other databases through an ADO connection. When you import recipients, you need to map the information NPrinting needs to the columns in your recipient source. Once you do this, you can save your import parameters. You can then create an "Import Recipients" Task which you can schedule to check your recipient source regularly and import new and modified recipients.
We use an Excel file for simplicity in this example, but the steps are essentially the same for all sources.
Here we select the File Format of the source for our recipients. Use the ADO connection for databases other than MS Access.
Click on Next to confirm your selection.
Set the Data Formats parameters for the file you are importing. In this case:
Map the columns in your Excel file to the NPrinting fields to create your recipients. A description of the function of various NPrinting fields and the syntax for them is in the NPrinting Help file under the heading "Import recipients with filters & groups". See also: Filter Syntax, Parameters, and Options for Importing Recipients
The only mandatory field is the Recipient Name (FullName) so be sure to map it. If you don't map an Excel column it will not be imported. You can also map CC and BCC adresses.
Click on the Save and Close icon to save the Recipient Import entity. It contains all the parameters you set in the previous steps.
Click on the Save and Close icon.
Run your task without sending any output to see if any error messages are registered in the log file.