User Tools

Site Tools


ServiceNow Installation and Configuration

1. Update Sets

To begin integrating SIAM for Jira into your ServiceNow instance you must first install the Perspectium update sets. For the latest update sets, visit the Update Set Releases page and request the download links from For more information on installing or updating the update sets, visit the first time install or updating pages.

The update sets should be installed in this order:

  1. Perspectium for ServiceNow update set
  2. Perspectium Common Endpoint
  3. Perspectium Common Document to integrate (i.e. Common Incident, Common Change, etc.)
  4. Perspectium SIAM for Jira update set

Once all three update sets have been installed the Perspectium app in the ServiceNow menu should show the Jira SIAM Integration tab:
Now click on properties under the Jira SIAM Integration tab. Once the page is loaded you should be seeing:
In the Configure Default Jira Project field enter the Project key value of the Jira Project you wish to share and subscribe to. Make sure that value you enter exactly matches the identifier for the project in Jira.

2. Subscribe Queue

If you are planning on subscribing to data from Jira to ServiceNow a subscribe queue needs to be set up. For general information on setting up subscribe queues in ServiceNow, you can refer to the ServiceNow Subscribed Queues page.
The information you will need to set up this subscribed queue:

  1. Name of the queue
  2. Endpoint url
  3. Queue user
  4. Queue user password

The endpoint url, queue user, and queue user password will be provided by Perspectium support. The name of the queue is usually in the form psp.out.servicenow.yourinstancename.

Note: If you are using two different endpoints for replicator and Jira SIAM, you must set up your Jira SIAM subscribe to use the endpoint url you are using for SIAM.

3. Dynamic Share and Shared Queue

After the SIAM base and SIAM for Jira update sets have been installed, a dynamic share and a shared queue should have been created. Visit the Dynamic share and Shared Queues pages for general information on both of these features.
To verify that the dynamic share has been created:

  1. Click on the dynamic share link in the under the Jira Siam Integration tab in the Perspectium App.
  2. This should open up to a table where an Incident dynamic share should have been created.
  3. Click on this dynamic share and verify that the Active field is checked, and that under Additional settings the Table Map and Target Queue fields have values.

To verify that the Shared Queue has been created:

  1. Click on the shared queues link under the Replicator tab in the Perspectium App.
  2. This should open up a table where a shared queue named should have been created.
  3. Click on this Shared Queue and verify that it is active.
  4. Stay in this Shared Queues view to complete the Dynamic Share and Shared queue configuration.

To complete the configuration you will need:

  1. The SIAM endpoint url
  2. The Queue user for your SIAM endpoint.
  3. The Queue user password for your SIAM endpoint.

These will all be given to you by Perspectium Support. You will then need to enter this information into the Endpoint URL, Queue User, and Queue user password fields in the Shared queues. Once this is done click the update button in the top right of the shared queue view and these settings should be saved.

Creating Dynamic Shares

To create your own share for other tables click the Dynamic Shares module under the Perspectium application menu. Click the new button to move on to the dynamic share form. Select the desired table to share and select the active checkbox. Then choose your trigger conditions and move to the “Additional Settings” section of the form. Select the table map that contains Jira and the table name. Select the Target queue See the dynamic share page for more information.

Below is the code for the “Before share script”. This code will make sure any updates, comments, or attachments will be deferred until the record has been ebonded:

if (psp_action == 'update' && current.correlation_id == ''){
	psp_action = 'deferred';

4. Outbound and Inbound table maps

Just like Shared and Dynamic queues, an inbound table map and an outbound table map should have been created after the SIAM update sets were installed. The Inbound table map will handle the conversion of Jira common incidents into ServiceNow incidents. The outbound table map will handle the conversion of ServiceNow Incidents into Jira common incidents. To verify that these have been created:

  1. Click the link for the Inbound Maps under the Jira SIAM Integration tab.
  2. Verify that Common Incident to Incident for Jira exists in this table.
  3. Click the link for the Outbound Maps under the Jira SIAM Integration tab.
  4. Verify that Incident to Common Incident (Jira) exists in this table.

If either of these maps is missing please contact

servicenow_install_for_jira.txt · Last modified: 2018/10/09 16:45 by josephm