Subscribe allows you to read in data into your DataSync Express instance, notably receiving information back from your DataSync Agent when it runs into issues.
To use subscribe, you must first specify a subscribed queue.
Here are the ways in which you can use the Subscribe module to configure your ServiceNow subscribe instance.
Global subscribe is a Subscribe definition that when created, will allow all incoming messages to be subscribed. If there is an existing subscribe definition for a specific table, its definition will override the global definition.
About before and after subscribe scripts
You can use before/after subscribe scripts to customize how the data will be consumed and stored in your subscribing ServiceNow instance.
Before subscribe scripts
These scripts are created with server-side JavaScript and will execute right before a record insert or update, allowing the chance to modify the record before persisting. Within your before subscribe script, you have access to the following variables:
Variable | Description |
|---|---|
| current | Record that is being inserted or updated |
| qcurrent | Record within the psp_in_message table (pulled from the Perspectium Mesh). Use the message's key value to determine its source. |
| ignore | Can assign a value of true in order to stop the execution of the subscribe |
After subscribe scripts
These scripts are also created with server-side JavaScript and will execute right after a record from a sharing instance is synced on the subscribing instance. Within your after subscribe script, you have access to the following variables:
Variable | Description |
|---|---|
| current | Record that was inserted, updated or deleted, the destination record |
Create before and after subscribe scripts
Here's how to create these scripts:
- Go to Perspectium DataSync Express > DataSync Express > Subscribe.
- In the resulting page, find and select the subscribe record that you want to configure.
- In the resulting subscribe record, click the Filter and Enrichment tab. You should see the Before subscribe script and After subscribe script fields.
- Use the available fields to enter your desired scripts. See below for some examples. Once you're done, click Update.
