Description
Use the Mapper Scripts page to create or edit the contents of mapper scripts in the system. This page contains information on all mapper scripts in the system, and a user must be granted permission by a superuser in order to access and view this page.
Access
AdminCenter > Other Setup > Mapper Scripts
You must have the necessary security permissions to access the Mapper Scripts page.
Technical Manual
Viewing the Mapper Scripts List
The Mapper Scripts list page contains a list of mapper scripts. If the list is longer than one page, use the page links located below the list of mapper scripts to navigate through the list.
Mapper Script | Enter text into the search-as-you-type field to search for a specific mapper script or to narrow the list. |
---|---|
Add | Select to add a new mapper script to the system. The Mapper Scripts details page will appear, opening a blank record to create a new mapper script. See "Adding and Editing Mapper Scripts" below. You can also select Copy on an existing mapper script to add a new mapper script using the existing script's details; see below. |
Export Table | Select the button to trigger a download of the mapper scripts as a ZIP file. A text file is created for each mapper script record, using the mapper script name as the file name and the script contents as the file contents. These text files are added to a folder, which is added to the ZIP file that is then pushed to the browser as a download. Repeated text file names are avoided by appending numbers to the file name as necessary. File names are scrubbed of invalid characters. The ZIP file name will be the current date and time, followed by "_ms.zip." |
Show __ entries | To modify the number of items on the page, adjust the value of the field. The system defaults to 10 per page and displays the total number of items based on your search. |
Mapper Script | Select the name of the mapper script in order to view and/or edit specific details about the script on the Mapper Scripts details page. See "Adding and Editing Mapper Scripts" below. |
Copy | Select to open a new mapper script record with the selected mapper script's details. |
Adding and Editing Mapper Scripts
On the Mapper Scripts list page, select the Add button or select the name of the mapper script to open the Mapper Scripts details page, where you can view and edit or add mapper scripts. To edit the record, highlight or delete text already displayed, then modify as desired.
Name | Enter the name of the mapper script in the field. This field is required. |
---|---|
Edit Mapper Script | Select the button to add or edit mapper script information on the Edit Mapper Script pop-up. The Script Usage section on the Edit Mapper Script pop-up displays Inbound Hosts Using Script, Outbound Hosts Using Script, and Hosts Forwarding Messages with this Script, which shows whether or not they are using the mapper script. If inbound hosts are not using mapper scripts, it will display a "This script is not used for inbound messages by any host" message. If outbound hosts are not using mapper scripts, it will display a "This script is not used for outbound messages by any host" message. If the mapper script is not used for forwarding any host, it will display a "This script is not used for forwarding by any host" message. Previous Versions: Select the button to view previous versions of the mapper script. Script Contents: Enter text into the field to configure the mapper script contents. Save: Select to save the added mapper script contents to the Mapper Scripts details page. To save changes made on the Edit Mapper Script pop-up, you must select Save on the Mapper Scripts details page. Cancel: Select to return to the Mapper Scripts details page without saving any changes. |
Create Time | Displays the time the mapper script was created. |
Last Edited Time | Displays the last time the mapper script was edited. |
Script Usage | This section displays Inbound Hosts Using Script, Outbound Hosts Using Script, and Hosts Forwarding Messages with this Script, which shows whether or not they are using the mapper script. This is configured on the Edit Mapper Script pop-up. If inbound hosts are not using mapper scripts, it will display a "This script is not used for inbound messages by any host" message. If outbound hosts are not using mapper scripts, it will display a "This script is not used for outbound messages by any host" message. If the mapper script is not used for forwarding any host, it will display a "This script is not used for forwarding by any host" message. |
Alerts & Comments | Select the button to view any alerts and comments added to the mapper script on the Alerts & Comments page. If there are no alerts or comments, a "No Alerts & Comments Defined" message will be displayed. Add: Select to add alerts and/or comments to the script on the Alerts & Comments pop-up. Enter text into the field, or select the ... button to add quick comments on the Quick Comments pop-up.
Select Save on the Alerts & Comments pop-up to save changes made to the pop-up, or select Cancel to close the window without saving any changes. Select OK on the Alerts & Comments pop-up to save changes made to the page, or select Cancel to close the pop-up without saving any alerts or comments. |
Save | Select to record changes and return to the Mapper Scripts list page. |
< Back to List | Select to return to the Mapper Scripts list page without saving any changes. |