# Integrate ServiceNow with ARM

## Step 1: Store Your ServiceNow Credentials in ARM

1. Log in to your ARM account.
2. Navigate to the **Admin** module and click the **Credentials** tab.

   ![Credential Tab](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FCoMnQkOqs89CyPwMUFSf%2Fimage.png?alt=media\&token=c8ed587f-3894-4328-b9a8-fda493a871f2)
3. Click **Create Credential** from the right navigation.

   ![Create Credential](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fa7bu5gLPfK6R9CiQ2F7K%2Fimage.png?alt=media\&token=2c8dfbae-743a-47e8-b596-2fae84a927ad)
4. In the popup:
   * Enter a **Credential Name**
   * Set **Credential Type** to *User name with Password*
   * Input your **ServiceNow username** and **password**
   * Ensure you're using your **username**, not your login email
5. Click **Save**

   ![Credential Entry](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FHTlOwqtQwNefJDvlivqC%2Fimage.png?alt=media\&token=fd0bee76-a984-41c2-a28d-081d3821bc55)

***

## Step 2: Integrate ServiceNow with ARM

1. Log in to ARM (if not already logged in).
2. Go to **Admin > My Account**
3. Click **New ALM System** under the **ALM Management** section

   ![New ALM System](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fs21H7a2X7vFJOVJYiLWv%2Fimage.png?alt=media\&token=5d49b290-ffb1-42ac-8111-987eb2208576)
4. Set **ALM Type** as *SERVICENOW*

   ![ALM Type](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FaUKeRiOUJW68leHUtd4K%2Fimage.png?alt=media\&token=27bea45f-f826-4e26-85ff-3c29e212ae8a)
5. Enter:
   * A **Label Name**
   * Your ServiceNow **subdomain URL** (e.g., `https://[subdomain].service-now.com`)
   * The **credentials** stored in Step 1
6. Click **Test Connection** to validate
7. Click **Save** to complete the integration

> Once integrated, you can log bugs/issues to ServiceNow directly from ARM.

{% hint style="danger" %}
**Note:** ServiceNow OAuth integration is supported only for **Cloud versions**. Contact **<support@autorabit.com>** to enable this feature.
{% endhint %}

***

## Configuring ServiceNow Work Items in ARM

### EZ-Commit Integration

1. In the **EZ-Commit** screen under **Post Commit**:

   * Check **Update ALM Workitem Status**
   * Select:
     * **ALM Type:** SERVICENOW
     * **ALM Label, Project, Sprint,** and **Work Item**
     * **Status** to be updated

   ![EZ Commit Config](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FFQeVL5MHekhCAWPiXVqX%2Fimage.png?alt=media\&token=4960af9b-926c-44f8-876e-2522379c7e08)
2. Upon commit, work item status will be reflected in ServiceNow.

***

### CI Job Integration

#### Applicable to:

* Package from Version Control
* Deploy from Version Control
* Deploy from SFDX branch to Salesforce Org
* Install Unlocked Package from VCS

1. In **Build** section of CI Job creation:

   * Check **Map ALM Project (Ex: ServiceNow)**

   ![CI Job Build](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FWXH66d36ztkB95CjH2Mt%2Fimage.png?alt=media\&token=77e76487-8fbd-4567-b652-65a24d9c396a)
2. Go to **ALM** section:

   * Set:
     * **ALM Type:** SERVICENOW
     * **Label** and **Projects**

   ![ALM Projects](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F96hFkfUDStL4gfWdOqtR%2Fimage.png?alt=media\&token=04a6bf8a-4886-43e5-8db5-304c47d162ca)
3. Choose:

   * One or all **Active Sprints**

   ![Sprint Selection](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fb8thG18zbqp3QB6NU1wV%2Fimage.png?alt=media\&token=7f962de0-0a6a-4dad-928a-98cdd3be5182)
4. Select:

   * **Work Item Type** (or all)

   ![Work Item Type](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F5dgkxBQEEqwBRERle45W%2Fimage.png?alt=media\&token=9f4f422f-0225-487e-9294-8c55a67c2141)
5. Update the **Status** for selected work item types

   ![Status Update](https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FDAnB23sDS4SwI2ExEybz%2Fimage.png?alt=media\&token=e23663af-06f6-4df1-a2dd-4fcae8939975)