Subscribe allows you to read in data into your DataSync Express instance, notably to synchronize your instance with another instance that is sharing data as well as receiving information back from your DataSync Agent when it runs into issues.
Subscribe requires the PerspectiumGlobal script include due to the Cross-Scope Access Policies Restrictions mentioned below. Contact Perspectium Support to obtain this script include and add it to your instance following the instructions listed below.
To use subscribe, you must first specify a subscribed queue.
Cross-Scope Access Policies Restrictions
Because of scope app limits, subscribing to table records into ServiceNow (i.e. subscribing to records shared from another instance) is limited due to cross-scope access policies. See https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0782299 for more details as subscribe will not be able to update certain fields such as sys_mod_count or number i.e. if subscribing to incidents from another instance, it will not have the same number on this instance as on the sharing instance.
Instead, subscribe will get errors like the following:
Access to api 'setValue(number)' from scope 'x_perr2_datasync' has been refused due to the api's cross-scope access policy.
Access to api 'setValue(sys_mod_count)' from scope 'x_perr2_datasync' has been refused due to the api's cross-scope access policy.
All other fields will update properly.
We have a PerspectiumGlobal script include you will need to import into the Global application scope for Subscribe to work properly in your instance. This script include is provided outside the Perspectium DataSync Express scoped application and is added to your instance using Import XML.
To install this script include:
- Contact Perspectium Support for the PerspectiumGlobal script include.
- Change your Application scope to Global if not already in the Global application scope.
- Go to System Definition > Script Includes in your ServiceNow instance.
- Right-click on a column header (such as Name) and choose Import XML.
- Verify the PerspectiumGlobal script include is in your instance by searching it by name in the list view of Script Includes.
Once installed, your subscribe will be able to update these restricted fields. No configuration changes are needed in the DataSync Express app.