Recipients

This section describes additional procedures related to recipients. For background information on recipients, see reference section.

 

Recipient Users

This section describes procedures updating and deleting recipient users.

Update a Recipient User

  • The recipient users are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  • The Recipients list displays.
  1. Select the recipient user whose information must be updated.
  • The details displays.
  1. Update the required fields under General.
  1. To update the devices associated with a user, select the required device, click Edit and do one or more of the following:
  • Edit the required details in the Recipient User Devices dialog box, and click OK.
  • To add new recipient user devices, click Add under the Recipient User Devices tab.
  • To remove a device, select the required device and click Remove.
  1. Under Groups Membership, click Add.
  • The Group Membership dialog box displays.
  1. Select the group to which you want to add this recipient user as a member and click Move to move the selection to the text box on the left.
  1. Click OK.
  1. To remove the recipient user from a group, select the group and click Remove.
  1. Click Save .
  • The user is saved with the updated details.

Delete a Recipient User

  • The recipient users are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  1. Select the recipient user to be deleted.
  1. Click Remove .
  • A confirmation message displays.
  1. Click Yes.
  • The recipient user is deleted.

NOTE 1:
The deleted recipient user cannot be used for new messages and will be removed from all message templates. However, the recipient user will continue to be displayed as a recipient in active and expired messages for an accurate historical view.
NOTE 2:
(Applicable only for MNS license users) If the deleted recipient user was also a system user, then the system user will not receive further messages.

 

Recipient Groups

This section describes additional recipient group related procedures.

Create Recipient Groups

  1. Click Add Group .
  1. Select General and enter the name of the group.
  1. Select Members and click Add.
  • The Groups Membership dialog box displays.
  1. Select the recipients to be associated with the group and click Move to move the selection to the text box on the left.
    NOTE 1: Add a maximum of 1000 recipients to a recipient group.
    NOTE 2: Click Filter to narrow the search based on the recipient type. Refer to steps 6 and 7 in the Updating a Recipient Group section for detailed instructions.
  1. Click OK.
  • The Members list is updated with the selected recipients.
  1. Select Groups Membership and click Add.
    NOTE 1: Refer a group to another group to build larger structures. However, it is not possible to have recursive groups where groups refer to each other.
    NOTE 2: For detailed instructions on groups membership, see Create/Import Recipient User OR Create Recipient Devices.
  1. Click Save .
  • The recipient group is created.

Update a Recipient Group

  • The recipient groups are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  • The list of recipients displays.
  1. Select the recipient group to be updated.
  • The details displays.
  1. Select General and update the Name.
  1. Select Members, click Filter to select the recipient type to be viewed.
  1. (Optional) Enter a keyword in the Search field.
  1. (Optional) To add a recipient to a group, do the following:
    a. Click Add: The Group Membership dialog box displays.
    b. Select the recipient and click Move to move the selection to the text box on the left.
    c. Click OK.
  1. (Optional) To remove a recipient from the group, select the required recipient from the Members list and click Remove.
  1. (Optional) To add the group to other recipient groups, do the following:
    a. Select Groups Membership.
    b. Click Add: The Group Membership dialog box displays.
    c. Select the group to which you want to add this group.
    d. Click Move to move the selection to the text box on the left.
    e. Click OK.
  1. (Optional) To remove the group from another recipient group, select the recipient group and click Remove.
  1. Click Save .
  • The recipient group is saved with the updated details.

Delete a Recipient Group

  • The recipient groups are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  • The list of recipients displays.
  1. Select the Recipient Group to be deleted.
  1. Click Remove .
  • A confirmation message displays.
  1. Click Yes.
  • The recipient group is deleted.

 

Recipient Devices

This section describes additional recipient device-related procedures.

Update/Delete a Recipient Device

  • The recipient devices are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor displays.
  1. Open the Recipients expander.
  • The list of recipients displays.
  1. Select the Recipient Device to be updated or deleted.
  1. (Optional) To update the recipient device, do the following:
    a. Select Groups Membership and click Add: The Group Membership dialog box displays.
    b. Select the group to which you want to add this recipient device and click Move to move the selection to the text box on the left.
    c. Click OK.
  1. (Optional) To remove the recipient device from a recipient group, do the following:
    a. Select the recipient group and click Remove.
    b. Click Save .
  1. (Optional) To delete the recipient device, do the following:
    a. Click Remove : A confirmation message displays.
    b. Click Yes.
  • The recipient device is saved with the updated details.
  • The recipient device is deleted.
    NOTE: The deleted recipient devices will still show up for already existing notifications but will be removed from all notification templates.

 

Recipient Locations

This section describes process of creating, updating and deleting recipient location procedures.

Create Recipient Locations

  • The locations are created. (Locations are referred to as aggregators on the management station. Refer to the Views chapter of Desigo CC.)
  1. Select Applications > Notification > Recipients.
  • The Recipient Editor tab displays.
  1. Open the Recipients expander.
  1. In the System Browser, select the view that has the locations to be added as recipients.
  • The location displays in the System Browser.
  1. Navigate to the required location and drag to the Recipients list.
  • The location is added to the list.
  1. Select General > Location, the recipient location name displays by default.
  1. Select Groups Membership and click Add.
  • The Group Membership dialog box displays.
  1. Select the group to which you want to add this recipient location as a member.
  1. Click Move to move the selection to the text box on the left.
  1. Click OK.
  1. Click Save .
  • The recipient location is saved.

Update/Delete a Recipient Location

  • The recipient locations are created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  1. Select the recipient location to be updated/ deleted.
  1. To update a recipient location, do the following:
    a. Select Groups Membership.
    b. Click Add to add the recipient location to a recipient group: The Group Membership dialog box displays.
    c. Select the group to which you want to add this recipient location as a member.
    d. Click Move to move the selection to the text box on the left.
    e. Click OK.
  1. (Optional) To remove the recipient location from a recipient group, do the following:
    a. Select the recipient group and click Remove.
    b. Click Save .
  1. (Optional) To delete a recipient location, do the following:
    a. Click Remove : A confirmation message displays.
    b. Click Yes.
  • The recipient location is saved with the updated details.
  • The recipient location is deleted.

 

Contact List

This section describes process of creating, updating and deleting the contact list.

NOTE:
The contact list is available only for Reno Plus and MNS license users.

Create Contact List

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  1. Click Contact List .
  • The contact list is added to the list of recipients.
  1. Select General, the name displays as Contact List by default.
  1. Select Members and click Add to add recipients to the contact list.
  • The Groups Membership dialog box displays.
  1. Select the recipients to be added to the contact list and click to move the selection to the text box on the left.
  1. Click OK.
  • The Members list is updated with the selected recipients.
  1. Click Save .
  • The contact list is saved.

NOTE 1:
Create only one contact list.
NOTE 2:
Multiple recipient groups can be associated under one contact list but cannot add a contact list to any recipient groups.

 

Update/Delete a Contact List

  • A contact list is created.
  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipients expander.
  • The Recipients list displays.
  1. Select the contact list to be updated or deleted.
  1. To update a contact list, do the following:
    a. Select Members.
    b. Click Add to add more recipients to the contact list: The Groups Membership dialog box displays.
    c. Select the recipients to be added to the contact list and click to move the selection to the text box on the left.
    d. Click OK: The Members list is updated with the selected recipients.
  1. (Optional) To remove a recipient from the contact list, do the following:
    a. Select the required recipient.
    b. Click Remove.
    c. Click Save : The contact list is saved with the updated details.
  1. To delete a contact list, do the following:
    a. Click Remove : A confirmation message displays.
    b. Click Yes.
  • The contact list is saved with the updated details.
  • The contact list is deleted.

 

Recipient User Device Types

This section describes the process for updating, and deleting recipient user device types and their corresponding modalities.

Update a Recipient User Device Type and Delivery Method

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the User Device Types expander.
  1. Under Device Types, select the user device type and update the required fields.
  1. Under Delivering Methods, select the delivery method and update the required fields.
  1. Click Save .
  • The user device type and delivering method are updated.

Remove a Recipient User Device Type and Delivery Method

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the User Device Types expander.
  • Under Device Types, the list of default user device types displays.
  1. To remove a recipient user device type, do the following:
    a. Under User Types, select the user device type to be removed.
    b. Click Remove: A confirmation message displays.
    c. Click Yes: The selected device type is removed.
  1. To remove a delivering method, do the following:
    a. Under Delivering Methods, select the delivering method to be removed from the list.
    b. Click Remove.
    c. A confirmation message displays.
    d. Click Yes: The selected delivery method is removed.
  1. Click Save .
  • The settings are saved.

 

Recipient User Languages

This section describes additional recipient user languages related procedures.

Update/Remove a Recipient User Language

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipient Languages expander.
  • The recipient languages list displays.
  1. Click the recipient language to be updated/deleted.
  1. To update the recipient user language, do the following:
  • Edit the name.
  • Select the desired Culture for the language from the drop-down list.
  • (Available only for MNS license users) Select a speech voice for the recipient language from the Speech voice drop-down list.
  1. To delete the recipient user language, do the following:
  • Select the language to be removed.
  • Click Remove: A confirmation message displays.
  • Click Yes.
  • The selected language is removed.
  1. Click Save .
  • The updates are saved.

 

Text-to-Speech Engine for Notification

This feature is available only for MNS license users.

Notification can convert textual content to audible content and play that content on audio-only devices. Each recipient language that supported by Notification requires the installation of a text-to-speech engine to ensure proper pronunciation in that language.

Notification is tested and confirmed to work with voices from the following vendors:

  • Acapela
  • NeoSpeech

Refer to the text-to-speech installation manual of the vendor for details on installing its corresponding text-to-speech engine.

The table below lists the recommended voices for the supported languages:

Language

Recommended Voice

English

VW Paul

French

Louise

German

Klaus

In addition to the recommended voices, other voices from the installed vendor can be used with Notification. For more information, refer to Installing New Voices.

The speech voice can be configured for all recipient languages.

Install New Voices

  • The voices to be installed are either an x64 bit version or compatible with x64 bit programs.
  • The voices are SAPI compliant and compatible with .NET 4.0, specifically with Speech Synthesizer for .NET 4.0.
  1. Refer to the text-to-speech installation manual of the vendor for details on installing more voices.
  1. Open the SAPI user Interface (UI) from C:\Windows\System32\Speech\SpeechUX\sapi.cpl.
  • The installed voices are displayed in the Voice selection drop-down list in the Text to Speech tab of the Speech Properties dialog box.
    NOTE: If Notification was running during installation of a voice, the project in the System Management Console (SMC) must be restarted to view the voices in the Notification UI.

Configure a Speech Voice for Recipient Language

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Open the Recipient Languages expander.
  • The list of available recipient languages displays.
  1. To set the speech for a language, select the language and click Speech voice.
  1. Select the required speech from the drop-down list.
  1. Click Save .
  • The speech is configured for the selected language.

 

Import Recipients

This section contains procedures for importing recipients.

Import Recipients from XML

The import feature is disabled for Windows App client.

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Import tab.
  1. Select the Import from XML expander, click Browse.
  • The Open dialog box displays.
  1. Select the location where the xml file is stored.
  1. Select the xml file.
  1. Click Open.
  • The path of the xml file displays in the Import file field.
  1. Click Import.
    NOTE: XML format is meant for system to system import of recipients. The selected xml file is imported.

Import Recipients from XML using Command

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Extended Operation tab.
  1. Click Import XML to enable the import options.
  1. In the File Path field, enter the local XML file path of the server.
  1. Click Send.
  • The XML file specified in the file path is imported.

Import Recipients from XML using Reactions

  1. Select Applications > Logics > Reactions.
  • The Reaction Editor tab displays.
  1. Drag the Recipients node from Applications > Notification > Recipients onto the Action expander of the Output expander.
  1. From the Property drop-down list, select Import XML[Commands.XMLImport.Request.Import].
  1. Select the ImportXML[ImportXML] command to execute.
  1. In the ServerFilePath field, enter the local XML file path of the MNS server.
  1. Open the Triggers expander, and from the drop-down list, select the appropriate logical operator (AND, OR).
  1. Open the Time and Organization mode expander.
  1. Click Add to add a new time row and enter a new time or schedule that periodically triggers the Import XML command.
  1. Click Save As and enter the name and description for the Import XML reaction.
  • The new Import XML reaction displays in the System Browser.

Configure Mappings for CSV Import

Before configuring the CSV mapping, the user first needs to determine three properties of the CSV files that the user is importing:

  • Header row: The first row in a CSV file may contain column names. If a header row is present, columns can be referenced by name in the CSV mapping. Otherwise, columns will need to be referenced by their index (position) in the CSV file.
  • Delimiter: A certain character that delimits two values in a CSV file. Notification supports commas, semicolons, spaces and tabs as delimiter.
  • Quotation mark: Surrounding individual values with quotation marks allows the use of delimiter characters within values. Notification supports single quotes and double quotes as quotation marks.
    NOTE 1:
    CSV files exported from Excel by default have the following properties:
    Header row: Yes
    Delimiter: Comma
    Quotation mark: Double quote.
    NOTE 2:
    If the character used as quotation mark appears within quoted values, the character must be escaped by doubling the corresponding character. This escaping process is typically performed by the process that creates a CSV file from a data source.
  1. Do the following to create a new import mapping:
    a. Click New: The Create mapping as dialog box displays.
    b. Enter a name for mapping in the Create mapping as dialog box.
    c. Click OK: The Mapping field is populated with the name specified for the mapping.
    d. Select the Header row check box if the user want to specify a title for the CSV file.
    e. Select a separator from the Delimiter drop-down list.
    f. In the Columns section, map a CSV Column with a notification property. For mapping, select a CSV column option from the CSV Column drop-down list and select a notification property for the corresponding CSV Column option from the Notification Property drop-down list. For example, Column 1(A) of CSV Column can be mapped to First Name of the Notification Property. You can correlate the alphabet A from the mapping column with the Microsoft Excel column header A, if Microsoft Excel is used to view the CSV file. Also, assign an individual recipient to the recipient group. To do this, select the appropriate CSV column from the CSV Column drop-down list and map to the recipient group from the Notification Property drop-down list.
    NOTE 1: The recipient group to be used during import of CSV file must be first created in theNotification.
    NOTE 2: The individual recipient will not be assigned to the recipient group if the corresponding value of the group in the CSV is either of the given values— "", " ", "0", "NO", or "FALSE". For values other than those mentioned above, the individual recipient will be assigned to the recipient group.
    g. Select a quotation type from the Quotations drop-down list.
    h. Click Save.
  • The mapping is configured.
    NOTE: This configured mapping can be saved for future use.
  1. Do the following to edit an existing mapping:
    a. From the Mapping drop-down list, select the mapping.
    b. Edit the required fields.
    c. Click Save.
  1. To select an existing mapping, select it from the Mapping drop-down list.
  1. Do the following for saving an existing mapping under a new name:
    a. Select the mapping from the Mapping drop-down list.
    b. Click Save as: The Save mapping as dialog box displays.
    NOTE: By default, Copy of [Mapping Name] displays in the Save mapping as dialog box.
    c. Enter a new name for the corresponding mapping.
    d. Click OK.
    e. Click Save.

Import Recipients from CSV

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Import tab.
  1. Open the Import from CSV expander.
  1. Click Browse.
  • The Open dialog box displays.
  1. Select the location where the CSV file is stored.
  1. Select the CSV file.
  1. Click Open.
  • The path of the CSV file displays in the Import file field.
  1. Select the Delete absent recipients check box to delete the recipients in the Notification that are not present in the CSV file.
    NOTE 1: Recipients created manually through the recipient UI will never be deleted during CSV import.
    NOTE 2: The mapping name is used as one of the criteria to delete recipient users hence when user deletes the mapping, a warning message displays.
  1. Click Import.
  • The selected CSV file is imported.
    NOTE: If imported recipient users need to be updateable through subsequent imports, the Unique ID property under the Notification property needs to be mapped to a CSV column that contains values that uniquely identify recipient users, like an employee ID.

Import Recipients from CSV using Command

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Extended Operation tab.
  1. Click the Import CSV link to enable the import options.
  • The Delete Users, Mapping, File Path fields and Send displays.
  1. Select the appropriate value (Yes or No) from the Delete Users check box.
  1. Enter the mapping to be used for the CSV import in the Mapping field.
  1. In the File Path field, enter the local CSV file path of the MNS server.
  1. Click Send.
  • The CSV file specified in the file path is imported.

Import Recipients from CSV using Reaction

  1. Select Applications > Logics > Reactions.
  • The Reaction Editor tab displays.
  1. Drag the Recipients node from Applications > Notification > Recipients onto the Action expander of the Output expander.
  1. Select Import CSV[Commands.CSVImport.Request.Import] from the Property drop-down list.
  1. Select ImportCSV[ImportCSV] command to execute.
  1. Select the appropriate value (Yes or No) from the DeleteAbsentUsers list box.
  1. Enter the mapping to be used for the CSV import in the Mapping field.
  1. In the ServerFilePath field, enter the local CSV file path of the MNS server.
  1. Open the Triggers expander.
  1. From the drop-down list, select the appropriate logical operator (AND, OR).
  1. Open Time and Organization Mode expander.
  1. Click Add to add a new time row and enter a new time or schedule that periodically triggers the Import CSV command.
  1. Click Save As and enter the name and description for the Import CSV Reaction.
  • The new Import CSV Reaction displays in the System Browser.

Configure Mappings for an Active Directory Import

  1. To create a new import mapping, click New.
  1. In the Create mapping as dialog box that displays, enter a name for mapping and click OK.
  • The Mapping field is populated with the name specified for the mapping.
  1. In the Columns section, map an Active Directory property with a Notification property by either selecting an Active Directory property from the drop-down list or by entering an Active Directory property manually in the Active Directory Property field. For example, First name of the Active Directory Property can be mapped to First Name of Notification Property.
    NOTE: Each Active Directory property has a real name and a display name, for example, givenName is the real name of an Active Directory property with display name as First name. The properties listed in the Active Directory Property drop-down list are the display names of the real Active Directory properties. If user wants to use any property not listed in the drop-down list then type the real name of the Active Directory property. In order to get the real name of the Active Directory property, a tool which shows real Active Directory property name and its display name must be used, for example, Remote Server Administration Tools for Windows 7.
  1. Click Save.
    NOTE: An error message displays if there are invalid entries in the Active Directory properties mapping. In such scenarios, click OK. Rectify the error and click Save.
  • The mapping is configured.
  1. Do the following for editing an existing mapping:
    a. Select the mapping from the Mapping drop-down list.
    b. Edit the required fields.
    c. Click Save.
  1. To select an existing mapping, select it from the Mapping drop-down list.
  1. Do the following for saving an existing mapping under a new name:
    a. Select the mapping from the Mapping drop-down list.
    b. Click Save As: The Save mapping as dialog box displays.
    NOTE: By default, Copy of [Mapping Name] displays in the Save mapping as dialog box.
    c. Enter a new name for the corresponding mapping.
    d. Click OK.
    e. Click Save.

Import Recipients from Active Directory

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Import tab.
  1. Open the Import from Active Directory expander.
  1. Enter the Active Directory server's address in the Server field.
  1. Click Connect.
  • The list of the departments available in the corresponding Active Directory displays in the Available departments section.
  1. Select the departments to be imported.
    NOTE: Search for the department by typing in the department’s name in the Search field.
  1. For importing departments, select an individual department from the Available departments section and click to move the department to the Departments to import section.
  1. To move departments from the Departments to import section to the Available departments section, select an individual department from the Departments to import section and click to move the department to the Available departments section.
  1. Select the Delete absent recipients check box to delete the recipients in the Notification that are not present in the Active Directory.
    NOTE 1: Recipients created manually through the recipient UI will never be deleted during Active Directory import.
    NOTE 2: The mapping name is used as one of the criteria to delete recipient users hence when user deletes the mapping, a warning message displays.
  1. Click Import.
  • The selected departments are imported.

NOTE:
If imported recipient users need to be updateable through subsequent imports, the Unique ID property under Notification Property needs to be mapped to an Active Directory Property that contains values that uniquely identify recipient users, like an employee ID.

Import Recipients from Active Directory using Command

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Extended Operation tab.
  1. Click the Import AD link to enable the import options.
  • The AD Server, Delete Users, Departments, Mapping fields and Send button display.
  1. Enter the Active Directory server address in the AD Server field.
  1. Select the appropriate value (Yes or No) from the Delete Users list to delete recipients from Notification that are not present in the Active Directory.
  1. Enter the department name to import. Multiple department names can be entered by using the comma separator.
  1. Enter the mapping to be used for importing the Active Directory in the Mapping field.
  1. Click Send.
  • The selected departments are imported.

Import Recipients from Active Directory using Reaction

  1. Select Applications > Logics > Reactions.
  • The Reaction Editor tab displays.
  1. Drag the Recipients node from Applications > Notification > Recipients onto the Action expander of the Output expander.
  1. Select Import from Active Directory[Commands.ADImport.Request.Import] from the Property drop-down list.
  1. In the ADServer field, enter the server address of the Active Directory to import.
  1. Select the appropriate value (Yes, No) from the DeleteAbsentUsers list box.
  1. In the Departments field, enter the department name.
    NOTE: Multiple department names can be entered by using a comma separator.
  1. In the Mapping field, enter the mapping to be used for the AD import.
  1. Open the Triggers expander. From the drop-down list, select the appropriate logical operator (AND, OR).
  1. Open the Time and Organization Mode expander.
  1. Click Add to add a new time row and enter a new time or schedule that periodically triggers the Import From Active Directory command.
  1. Click Save As and enter the name and description for the Import Active Directory Reaction.
  • The new Import Active Directory Reaction displays in System Browser.

Delete a CSV Mapping

  • One or more CSV mappings are present.
  1. Select the mapping from the Mapping drop-down list.
  1. Click Delete.
  • The selected mapping is deleted.

Delete an Active Directory Mapping

  • One or more Active Directory mappings are present.
  1. Select the mapping from the Mapping drop-down list.
  1. Click Delete.
  • The selected mapping is deleted.

 

Export Recipients

This section describes additional procedures exporting recipients.

Export Recipients to XML

The Export feature is disabled for Windows App client.

  1. Select Application > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Export tab.
  1. Open the Export to XML expander.
  1. Select the recipients to be exported and click to move the selection to the Selected for export text box.
    NOTE: Search recipients to narrow down the list by typing in the recipient name.
  1. Click Export.
  • The Save dialog box displays.
  1. Select the location where the XML file must be saved.
  1. Enter a file name.
  1. Click Save.
    NOTE: XML format is meant for system to system export of recipients.
  • The recipients are exported in XML format.

Export Recipients to XML using Command

  1. Select Applications > Notification > Recipients.
  1. Click the Export XML link.
  • The Recipients Editor tab displays.
  1. Select the Extended Operation tab.
  1. Click the Export XML link to enable the export options.
  • The File Path field and Send display.
  1. In the File Path field, enter the local file path of the MNS server where the XML file must be saved.
  1. Click Send.
  • All the recipients in the Notification are exported to the XML file specified in the file path.

Export Recipients to XML using Reaction

  1. Select Applications > Logics > Reactions.
  • The Reaction Editor tab displays.
  1. Drag the recipients node from Applications > Notification > Recipients onto the Action expander of the Output expander.
  1. Select Export XML[Commands.XMLExport.Request.Export] from the Property drop-down list.
  1. Select ExportXML[ExportXML] command to execute.
  1. In the ServerFilePath field, enter the local file path of the MNS server where the XML file must be saved.
  1. Open the Triggers expander. From the drop-down list, select the appropriate logical operator (AND, OR).
  1. Open the Time and Organization Mode expander.
  1. Click Add to add a new time row and enter a new time or schedule that periodically triggers the Export XML command.
  1. Click Save As and enter the name and description for the Export XML reaction.
  • The new Export XML reaction displays in the System Browser.

Configure Mappings for CSV Export

Before configuring the CSV mapping, the user first needs to determine three properties of the CSV files:

  • Header row: The first row in a CSV file may contain column names. If a header row is present, columns can be referenced by name in the CSV mapping. Otherwise, columns will need to be referenced by their index (position) in the CSV file.
  • Delimiter: A certain character that delimits two values in a CSV file. Notification supports commas, semicolons, spaces and tabs as delimiter.
  • Quotation mark: Surrounding individual values with quotation marks allows the use of delimiter characters within values. Notification supports single quotes and double quotes as quotation marks.
    NOTE 1: CSV files exported from Excel by default have the following properties:
    Header row: Yes
    Delimiter: Comma
    Quotation mark: Double quote.
    NOTE 2: If the character used as quotation mark appears within quoted values, the character must be escaped by doubling it. This escaping process is typically performed by the process that creates a CSV file from a data source.
  1. Do the following to create a new export mapping:
    a. Click New: The Create mapping as dialog box displays.
    b. Enter a name for the mapping and click OK: The name displays under Mapping.
    c. (Optional) Select the Header row check box if the exported CSV file must contain a header row.
    d. Select a separator from the Delimiter drop-down list.
    e. In the Columns section, map a Notification Property with a CSV Column. From the Notification Property drop-down list, select a Notification property and enter a CSV column option for the corresponding Notification property in the CSV column drop-down list.
    f. From the Quotations drop-down list, select a quotation type.
    g. Click Save.
  • The mapping configuration is saved.
    NOTE: This configured mapping can be saved for future use.
  1. Do the following to edit an existing mapping:
    a. Select the mapping from the Mapping drop-down list.
    b. Edit the required fields.
    c. Click Save.
  1. To select an existing mapping, select it from the Mapping drop-down list.
  1. Do the following to save an existing mapping under a new name:
    a.
    Select the mapping from the Mapping drop-down list.
    b. Click Save As.
    c. The Save mapping as dialog box displays.
    NOTE: By default, Copy of [Mapping Name] displays in the Save mapping as dialog box.
    d. Enter a new name for the corresponding mapping.
    e. Click OK.
  1. Click Save.

Export Recipients to CSV

  1. Select Application > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Export tab.
  1. Expand Export to CSV and select the recipients to be exported and click to move the selection to the Selected for export text box.
    NOTE: Search recipients to narrow down the list by typing in the recipient name.
  1. Select a mapping configuration if present or create a mapping configuration. Refer to the Configuring Mappings for CSV Export section for more information.
  1. Click Export.
  • The Save dialog box displays.
  1. Select the location where the CSV file must be saved.
  1. Enter a file name and click Save.
  • The recipients are exported in CSV format.

Export Recipients to CSV using Command

  1. Select Applications > Notification > Recipients.
  • The Recipients Editor tab displays.
  1. Select the Extended Operation tab.
  1. Click the Export CSV link to enable the export options.
  • The Mapping, File Path field and Send button display.
  1. Enter the mapping to be used for the CSV export in the Mapping field.
  1. Select the File Path field, enter the local file path of the MNS server where the CSV file must be saved.
  1. Click Send.
  • The recipients are exported in CSV format.

Export Recipients to CSV using Reaction

  1. Select Applications > Logics > Reactions.
  • The Reaction Editor tab displays.
  1. Drag the recipients node from Applications > Notification > Recipients onto the Action expander of the Output expander.
  1. From the Property drop-down list, select Export to CSV [Commands.CSVExport.Request.Export].
  • The ExportCSV[ExportCSV] command displays under Command column.
  1. Enter the mapping to be used for the CSV export in the Mapping field.
  1. In the ServerFilePath field, enter the local file path of the MNS server where the CSV file must be saved.
  1. Open the Triggers expander.
  1. From the drop-down list, select the appropriate logical operator (AND, OR).
  1. Open the Time and Organization Mode expander.
  1. Click Add to add a new time row and enter a new time or schedule that periodically triggers the export to CSV command.
  1. Click Save As and enter the name and description for the export to CSV reaction.
  • The new export to CSV reaction displays in the System Browser.

 

Preload Content onto Media Controllers

This procedure is available only for MNS license users.

  • One Media Controller device is available to recipients.
  • Media Files are imported to the Media Library.
  • System Manager is in Engineering mode.
  1. In System Browser, select Application View.
  1. Select Applications > Notification > Recipients.
  1. Select the Media Controller tab.
  1. Click Add new item .
  1. Select the Media Library Root Node.
  1. Select the Folder Node.
  1. Drag the media file to the Files field.
  1. Drag the Media Controller device, displayed in the dialog box below the Media Library root node, to the Media Controller field.
  1. Click Save .
  1. Select Applications > Notification.
  1. Select the Extended Operation tab.
  1. Click Preload.
  • A success message displays.