---
title: "ServiceNow <> Jira Integration (Legacy)"
canonical: "https://docs.perspectium.com/space/earlierReleases/1442140/ServiceNow+%3C%3E+Jira+Integration+(Legacy)"
format: markdown
---
This is a legacy feature so it has restricted permissions for Perspectium employees only - it is intended for internal use with customers on a need-by-need basis. 

> Macro (toc)

# Update Sets

To begin integrating SIAM for Jira into your ServiceNow instance, you must first install the Perspectium update sets - request the download links from [support@perspectium.com](mailto:support@perspectium.com). 

The update sets should be installed in this order:

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

Once the update sets have been installed the Perspectium app in the ServiceNow menu will show the **Jira SIAM Integration** tab:

![image](media://4040198d-e0f1-4e93-bf3a-f70497dbb1fc)

<span style="color: #000000">Click on </span>**<span style="color: #000000">Properties</span>**<span style="color: #000000"> under the </span>**<span style="color: #000000">Jira SIAM Integration tab</span>**<span style="color: #000000">. Once the page is loaded you should be seeing:</span>

![image](media://5909e126-78da-43b5-83a1-d1618d31da4b)

<span style="color: #333333">In the </span>**<span style="color: #333333">Configure the default Jira Project</span>**<span style="color: #333333"> 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.</span>

# Subscribe Queue

If you are planning on subscribing to data from Jira to ServiceNow, you need to set up a subscribe queue.

To set up this subscribed queue, you need to know:

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.

![image](media://9d75be45-1ffe-4d99-bfbc-ca2cd55b352d)

> ⚠️ **NOTE: **<span style="color: #000000">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.</span>

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. 

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** box is checked, and that under **Additional Settings**, the **Table Map** and **Target Queue** fields have values.

![image](media://d9c95987-0783-4d1c-b8c2-bda0e771f797)

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 psp.in.siam.client.jira 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.

<span style="color: #333333">You will receive the above requirements from Perspectium Support. You will then need to enter this information into the </span>**<span style="color: #333333">Endpoint URL</span>**<span style="color: #333333">, </span>**<span style="color: #333333">Queue user</span>**<span style="color: #333333">, and </span>**<span style="color: #333333">Queue user password</span>**<span style="color: #333333"> fields in the </span>**<span style="color: #333333">psp.in.siam.client.jira</span>**<span style="color: #333333"> Shared queues. Then, </span>**<span style="color: #333333">Update</span>**<span style="color: #333333"> button in the top right of the shared queue view to save the settings.</span>

![image](media://ef346558-9fb6-46b1-9692-3f72a1ad581a)

### Creating Dynamic Shares

<span style="color: #333333">To create your own share for other tables, click the </span>**<span style="color: #333333">Dynamic Shares</span>**<span style="color: #333333"> module under the Perspectium application menu. Click </span>**<span style="color: #333333">New</span>**<span style="color: #333333"> to move on to the dynamic share form. Select the desired table to share and check the </span>**<span style="color: #333333">active</span>**<span style="color: #333333"> box. Then, choose your trigger conditions and move to the </span>**<span style="color: #333333">Additional Settings</span>**<span style="color: #333333"> section of the form. Select the table map that contains Jira and the table name. Select the Target queue </span>**psp.in.siam.client.jira**<span style="color: #333333">.</span>

![image](media://47091539-5af2-4146-8cf7-1844d51fdaea)

<span style="color: #333333">Make sure to use the code as seen in the image for the </span>**<span style="color: #333333">Before share script</span>**<span style="color: #333333">. This code will make sure any updates, comments, or attachments will be deferred until the record has been ebonded. Here is the code again:</span>

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

# <span style="color: #333333">Outbound and Inbound Table Maps</span>

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 [support@perspectium.com](mailto:support@perspectium.com)