Confirm ServiceNow Compatibility

All Perspectium applications delivered through update sets are continuously updated and rigorously tested to ensure support for the latest versions of the ServiceNow platform.

The following versions are currently supported:

• Xanadu
• Washington DC
• Vancouver
• Utah
• Tokyo
• San Diego
• Rome
• Quebec
• Paris
• Orlando

• New York

• Madrid
• London

Perspectium tests n-2 compatibility of its application with each new release of ServiceNow e.g. the current version of the Perspectium app and the previous two major releases prior to this release are tested with the newest version of the ServiceNow application after its general availability (GA) release date. Once we have completed testing, we will update the documentation here to reflect compatibility and any known issues.

For more information about the latest ServiceNow versions and the features supported for those versions, see ServiceNow versions.

↑ Go to top of page

Request download link from Perspectium

Once you've confirmed ServiceNow compatability, the first step in setting up the Perspectium application is to reach out to support@perspectium.com and request the download link for the current version of Perspectium. You will be sent a file in a zipped format representing an exported update set XML file. Save the file in your browser's designated Downloads folder. After saving the downloaded zip file, unzip it using your preferred method.

Install DataSync for ServiceNow 

To enable the syncing of data from your ServiceNow instance to other Perspectium-supported endpoints, you will first need to install the Perspectium application (DataSync for ServiceNow). The installation process involves first previewing and then committing Perspectium update sets in your ServiceNow instance.

To install the Perspectium application:

1. Log into your ServiceNow instance and navigate to System Update Sets > Retrieved Update Sets or simply type Retrieved Update Sets in the Filter Navigator on the upper left side of the screen.
   
   
2. In the resulting form, click Import Update Set from XML under the Related Links section.
   
   
3. Upload the Perspectium for ServiceNow update set (.xml file) provided by Perspectium Support (as previously mentioned, you need to request this file) and click Upload.
   
   
4. Click the name of the update set you uploaded in Step 3.
   
   
5. In the resulting form, click Preview Update Set in the top right corner, and close the pop-up after it finishes running.
   
   
6. Check if there are any errors or warnings—if errors or warnings have occurred, they will appear in the list at the bottom of the form under the Update Set Preview Problems tab.
   
   We recommend that you check the box next to each error or warning and choose the Accept remote update option. If you have made changes or customizations you have made to Perspectium components (not typical), then select Skip remote update for those updates.
   
   To view previously configured fields and updates that may be affected for each error or warning, click Show local field and/or Show local update. For more information, see preview a remote update set.
   
   
7. Once you have addressed any errors or warnings, click Commit Update Set in the top right corner of the form, and close the pop-up after it finishes running.
   
   
   

↑ Go to top of page

Upgrade your Perspectium Application 

To ensure that you're up-to-date on all of the latest features and enhancements for DataSync, you can upgrade your DataSync for ServiceNow installation whenever new releases are available. To check which version of DataSync for ServiceNow you have installed on your instance, navigate to Perspectium > Control and Configuration > Properties and locate your current version listed under Perspectium Update Set Version. 

To upgrade your Perspectium application:

1. Log into any ServiceNow instances that have Perspectium update sets committed to them, and click Perspectium > Control and Configuration > Start / Stop All Jobs to stop running all Perspectium jobs on each instance.
   
   
2. Navigate to System Update Sets > Retrieved Update Sets or use the Filter Navigator in the top left side of the screen and type Retrieved Update Sets.
   
   
3. In the resulting form, click Import Update Set from XML under the Related Links section. 
   
   
4. Upload the update set (.xml file) provided by Perspectium Support and click Upload.
   
   
5. Click the name of the update set you uploaded in Step 4.
   
   
6. In the top right corner of the resulting form, click Preview Update Set and close the pop-up after it finishes running.
   
   
7. Check if there are any errors or warnings—if errors or warnings have occurred, they will appear in the list at the bottom of the form under the Update Set Preview Problems tab. Check the box next to each error or warning and choose whether to Accept remote update or Skip remote update. To view previously configured fields and updates that may be affected for each error or warning, click Show local field and/or Show local update. For more information, see preview a remote update set.
   
   
8. Once you have addressed any errors or warnings, click Commit Update Set in the top right corner of the form, and close the pop-up after it finishes running.

Run Perspectium Finish Install Scripts

After committing any Perspectium update sets to your ServiceNow instance (whether for the first time, or for an upgrade), the Finish Install scripts must be run in order for your Perspectium applications to function correctly. Finish Install will check if the Perspectium application is in the global scope, run jobs to install properties for the application, start running scheduled jobs, and reset dynamic share rules. By running the Finish Install script, you will not overwrite your current Perspectium properties. 

You must run the Finish Install script whether you are installing the Perspectium application for the first time or upgrading your Perspectium application version. The Finish Install scripts can also be run after committing multiple Perspectium update sets for ServiceNow.

To run the Finish Install scripts:

1. Log into your ServiceNow instance and navigate to Perspectium > Control and Configuration > Finish Install
   
   
2. At the bottom of the form, click Confirm 

 NOTE: With Lithium 9.1.0 and newer, within a few seconds after Finish Install has completed, you will be automatically directed to Perspectium Properties to configure your settings so that a shared queue and bulk share can be automatically created for you to start sharing. A message will appear on screen to notify you this is happening:

↑ Go to top of page

Set Initial Perspectium Properties in ServiceNow

After installing the Perspectium application, you will need to set your initial Perspectium properties to start using the Perspectium application.

To set your initial Perspectium and DataSync properties:

1. Log into your ServiceNow instance and navigate to Perspectium > Control and Configuration > Properties or use the Filter Navigator in the top left side of the screen and type Control and Configuration, then click Properties.
   Being this is the first time you are configuring your properties, a prompt will appear to notify you to configure both General and DataSync Settings so as to automatically create a shared queue and bulk share for you:
   
   
   
2. On the Properties page, click General Settings.
   
   
3. In the resulting form, fill out the fields with your Perspectium Integration Mesh username, password, and server URL, and click Save.
   You will be prompted to also enter your DataSync Settings to complete setting up the Perspectium application:
   
   
   
4. Click the back arrow to go back to the Properties page, and this time click DataSync Settings
   
   
5. In the resulting form, fill out the fields with your encryption and/or decryption keys (see NOTES for more information)
   
   
6. Scroll to the bottom of the page and click Save.
   Once you save your DataSync Settings, a bulk share will be created for you. The following message will be displayed and then you will be directed to the bulk share after a few seconds so you can execute it:

This bulk share will default to the incident table and use a shared queue (psp.out.replicator.<instance_name>_core) automatically created for you. You can update this to select any table you want, make any other changes to the bulk share and then choose the Execute Now option to execute the bulk share.

 NOTE: 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.

↑ Go to top of page

What's next?

The Perspectium application is comprised of various modules—explore how to navigate these modules and use available features that may be helpful to you.