Prerequisites
First, you will need to install the Perspectium DataSync Express application.
For domain-separated instances, you must be in the global domain to install the application.
With Lithium 9.1.0 and newer, setting up your properties will automatically create a shared queue and a bulk share using this shared queue so you can immediately start sharing data. Details and screenshots below relate to Lithium 9.1.0 and newer. For older versions, you will not be prompted and will need to create your shared queue and bulk share manually.
The shared queue created will be named psp.out.replicator.<instance_name>_core. For example psp.out.replicator.acme_core. This shared queue's Integration Mesh URL and credentials along with the encryption key will be updated each time you update these respective configurations in Perspectium > Control and Configuration > Properties. That is, if you update the Integration Mesh username in Perspectium properties, this shared queue's user will also be updated.
The bulk share created will use this shared queue, default to the incident table and be named First Bulk Share YYYY-MM-DD HH:MM:SS (in your local date and time, for example First Bulk Share 2024-09-15 11:37:51). You can change this to a different table and then click Execute Now to run the bulk share.
You will need a Perspectium application (such as the DataSync Agent) subscribed to this queue to consume messages and save to your target destination such as a supported database.
If you happen to delete your bulk share using this shared queue, you can go back into Perspectium > Control and Configuration > Properties and resave your properties and the bulk share will automatically be recreated for you.
If you are already have the Perspectium application installed and are upgrading to Lithium 9.1.0 and newer and already have shared queues defined, this will not create this default shared queue or bulk share. This is intended for new installations of the Perspectium application so as to interfere with your current sharing setup.
Procedure
To set the initial configurations after installing the DataSync Express app into your instance, follow these steps:
Switch to the Perspectium DataSync Express Application Scope
The DataSync Express app requires your ServiceNow instance to be in its scope during registration.
NOTE: This action is only required for users with the admin role since admin users have the ability to choose different application scopes (non-admin users will automatically be in the DataSync Express scope).
Navigate to the Perspectium DataSync Express application
In the Filter Navigator of the Application Navigator, type in “perspectium” to find the Perspectium DataSync Express application:
Navigate to the Setup module and complete Setup
Navigate to Perspectium DataSync Express > Setup to access the Setup page. Then, read through and complete the setup for DataSync Express by clicking Confirm at the bottom of the page.
Complete Setup
The action will take a few seconds to complete. You will be notified on screen with a success message once the setup has been complete.
Once the setup has complete, the Setup module will be made inactive and the other modules of the Perspectium DataSync Express application will be enabled so you can start using the application.
Set up application properties
Setup your application properties to start using the application.
Set up table access
If you plan to share attachments, modify table access to allow the DataSync application access to read attachment records.