---
title: Connecting Neurons for SOM to Jira
slug: neurons-for-itsm/admin-user-help/enu/latest/connecting-neurons-for-som-to-jira
createdAt: 2026-07-14T19:16:34.218Z
---

Perform the following procedures to connect Neurons for SOM to your Jira instance.

::::ExpandableHeading
## Credentials and Initial Setup

1. Log into ITSM as an Administrator and open the **Ticket Sharing and Synchronization** (TSS) workspace.
2. Select **New Ticket Sharing and Synchronization**.
3. Enter the** Integration Name** (example: Jira).
4. Select **Incident **from the **Business Object Name** menu.
5. Select **Enabled **from the Status menu.
6. In the **Service Name** field, find and select Jira.
7. Save.

:::Paragraph{indent="1"}
Four new tabs now appear after the **Credentials **tab: **Filters**,** Field Mapping**, **Data Mapping**, and **Data Rules**.
:::

8. The **Credentials **tab now contains three additional fields:
   1. **Service URL**: Relevant Jira instance URL (example: https\://customer version.atlassian.net/rest/api/2).
   2. **Username**: Jira account username (example: JiraUsername\@company.com).
   3. **Auth Token**: Token provided by Jira (example: Token1232323232323).
9. Click **Save**.
::::

:::ExpandableHeading
## Filters Tab

1. In the **Filters **tab, click **New Connector Service Filters**.
2. In the **New Connector Service Filters** dialog, select **Summary **from the **Incident Field Name** menu.
3. In the** Incident Field Value** field, enter Trojan.
4. **Operation with next Filter** determines how filtering works with other filters. Select the appropriate operator (AND or OR) (example: add a “Ransomware Detected” filter).
5. When all appropriate filters have been added, Save.
:::

:::ExpandableHeading
## Field Mapping Tab

1. In the **Field Mapping** tab, click **New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping **dialog, select **Urgency **for the** Incident Field Name**.
   2. Enter priority for the **Jira Field Name**. This field is in lowercase in Jira.
   3. Select **Poll this field for any changes**.
   4. Save.
2. Click** New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping** dialog, select **Summary **for the** Incident Field Name**.
   2. Enter summary for the **Jira Field Name** . This field is in lowercase in Jira.
   3. Enter summary for the **Service Field Depth**.
   4. Select **Poll this field for any changes**.
   5. Save.
3. Click** New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping** dialog, select **Provide default value** (to switch field mapping from Jira to ISM).
   2. Enter project for the** Jira Field Name**.
   3. Enter ESM for the **Default Value**.
   4. Enter project^key for the** Service Field Depth**.
   5. Save.
4. Click** New Connector Service Field Mapping**.
   1. In the** New Connector Service Field Mapping** dialog, select **Description **for the **Incident Field Name**.
   2. Enter description for the **Jira Field Name**. Note: This field is in lowercase in Jira.
   3. Enter description for the **Service Field Depth**.
   4. Save.
5. Click** New Connector Service Field Mapping**.
   1. In the** New Connector Service Field Mapping **dialog, select **Status **for the **Incident Field Name**.
   2. Enter status for the **Jira Field Name**. Note: This field is in lowercase in Jira.
   3. Select **Poll this field for any changes**.
   4. Save.
6. Click** New Connector Service Field Mapping**.
   1. In the** New Connector Service Field Mapping** dialog, select **Provide default value** (to switch field mapping from Jira to ISM).
   2. Enter issuetype for the **Jira Field Name**.
   3. Enter Task for the **Default Value**.
   4. Enter issuetype^name for the **Service Field Depth** field.
   5. Save.
:::

::::ExpandableHeading
## Data Mapping Tab

1. In the **Data Mapping** tab, click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. In the **New Connector Service Field Mapping **dialog, select **Incident=Urgency \:: Jira=priority** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Low for the **Incident Field Value**.
:::

:::Paragraph{indent="1"}
c. Enter Low for the **Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

2. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Urgency \:: Jira=priority** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Low for the** Incident Field Value**.
:::

:::Paragraph{indent="1"}
c. Enter Lowest for the** Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Urgency \:: Jira=priority** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter High for the **Incident Field Value** .
:::

:::Paragraph{indent="1"}
c. Enter High for the **Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Urgency \:: Jira=priority** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter High for the **Incident Field Value**..
:::

:::Paragraph{indent="1"}
c. Enter Highest for the **Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Urgency \:: Jira=priority** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Medium for the** Incident Field Value**.
:::

:::Paragraph{indent="1"}
c. Enter Medium for the **Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Status\:: Jira=status** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Active for the** Incident Field Value**.
:::

:::Paragraph{indent="1"}
c. Enter In Progress for the** Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Status\:: Jira=status** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Logged for the **Field Value**.
:::

:::Paragraph{indent="1"}
c. Enter To Do for the** Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

3. Click **New Connector Service Data Mapping**.

:::Paragraph{indent="1"}
a. Select **Incident=Status\:: Jira=status** for the **Connector Service Field**.
:::

:::Paragraph{indent="1"}
b. Enter Closed for the** Incident Field Value.**
:::

:::Paragraph{indent="1"}
c. Enter Done for the** Jira Field Value**.
:::

:::Paragraph{indent="1"}
d. Select **Stop polling after this value**.
:::

:::Paragraph{indent="1"}
e. Save.
:::
::::

::::ExpandableHeading
## Data Rules Tab

1. In the Data Rules tab, select **New Connector Service Field Constraint**.

:::Paragraph{indent="1"}
a. In the **Field Mapping Value** menu, select **Incident=Status \:: Jira=Status\[Closed,Done]**.
:::

:::Paragraph{indent="1"}
b. In the **Business Object Field Name** menu, select **CauseCode**.
:::

:::Paragraph{indent="1"}
c. Enter Hardware for the **Business Object Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

2. Click** New Connector Service Field Constraint**.

:::Paragraph{indent="1"}
a. In the **Field Mapping Value** menu, select **Incident=Status \:: Jira=Status\[Closed,Done]**.
:::

:::Paragraph{indent="1"}
b. In the **Business Object Field Name** menu, select **Resolution**.
:::

:::Paragraph{indent="1"}
c. Enter Completed for the** Business Object Field Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::
::::

:::ExpandableHeading
## Additional Operations

1. Click the **Additional Operations** tab. If the tab is not visible, you may have to refresh or go to List View and select your TSS again.
2. Select the following options:
   - **Push Comments added in HEAT to Jira**
   - **Pull Comments added in Jira to HEAT**
   - **Push Attachments added in HEAT to Jira**
   - **Pull Attachments added in Jira to HEAT**
3. In the **Comment Business Object** menu, select **Journal#Notes**.
4. Save.
:::

::::ExpandableHeading
## Comment Field Mapping

1. Click the** Comment Field Mapping** tab. If the tab is not visible, you may have to refresh or go to List View and select your TSS again.
2. Click **New Comment Field Mapping**.

:::Paragraph{indent="1"}
a. In the **Incident Field Name** menu, select **Notes**.
:::

:::Paragraph{indent="1"}
b. Enter Description for the** Jira Field Name**.
:::

:::Paragraph{indent="1"}
c. Save.
:::

3. Click on New Comment Field Mapping.

:::Paragraph{indent="1"}
a. In the **Incident Field Name** menu, select **Source**.
:::

:::Paragraph{indent="1"}
b. Leave the **Jira Field Name** blank.
:::

:::Paragraph{indent="1"}
c. Enter Other for the **Incident Default Value**.
:::

:::Paragraph{indent="1"}
d. Save.
:::

4. Click on New Comment Field Mapping.

:::Paragraph{indent="1"}
a. In the **Incident Field Name** menu, select **Subject**.
:::

:::Paragraph{indent="1"}
b. Enter Summary for the **Jira Field Name**.
:::

:::Paragraph{indent="1"}
c. Save.
:::
::::