# ServiceNow

> ServiceNow integration with Test Manager via UiPath Test Manager Connect for lifecycle management in Automation Suite.

:::important
You can integrate Test Manager with ServiceNow only through UiPath Test Manager Connect. Visit [Test Manager Connect](https://docs.uipath.com/test-manager/automation-suite/2.2510/user-guide/uipath-test-manager-connect) to check the resources you can use to create an integration with ServiceNow and other ALM tools, via Planview<sup>®</sup>.
:::

Integrate ServiceNow™ with UiPath Test Manager to manage and automate tests throughout the development lifecycle. With this integration, you can include automated testing directly into your agile planning or directly assign automation to test cases created in ServiceNow™ Test Management 2.0.

## Prerequisites

* UiPath Test Manager administrator account.
* UiPath Test Manager Connector.
* ServiceNow™ account including either Agile Development or Test Management v2 plugin. Alternatively, you can use both plugins for this integration.

## Create an Integration User Account in ServiceNow™

Create a new user account and assign specific roles to it, to make API requests to Test Manager.

1. Log in to your ServiceNow™ instance.
2. Navigate to **Organization** &gt; **Users** &gt; **New** to create a new user for the UiPath® Test Management application.
3. Configure new user account settings with the following conditions:
   * Choose a **User ID**,**First name**,**Last name** and **Password**.
   * Keep the User ID and password at hand for later use.
   * Select **Web services access only** and **Internal Integration User**, as these are required for the integration to work.
4. Go to the **Roles** tab and select **Edit**.
5. Assign the following roles to the newly created user:
   * **import_set_loader**
   * **import_transformer**
   * **scrum_admin**
   * **x_uipa_tm_integrat.admin**

     ![ServiceNow integration user role assignments](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126405-0e89c271-d8aec191.webp)
6. Select **Save** to return to the user form.
   :::important
   If you have REST API role access restrictions in your ServiceNow™ configuration, you need to assign additional roles. For example, `nc_platform_rest_api_access` and `rest_service`.
   :::

## Configure a ServiceNow™ Connection

Configure the ServiceNow connection in Test Manager to enable defect synchronization between your Test Manager project and your ServiceNow instance.

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** &gt; **Integration**.
4. Select **New Connection** and select **ServiceNow** from the dropdown.
5. Configure the following connection settings:
   * **Name**: Enter a name for your ServiceNow™ connection.
   * **Description** (Optional): Add a description for reference.
   * **Server URL**: Add the ServiceNow™ server URL. For example: `https://environment.service-now.com/`.
   * **User**: Enter the User ID you have configured for your integration user account.
   * **Password**: Enter the associated password.
   * **Defect Type**: Select a defect type from the dropdown. For now, you can only choose **Defect**.

     ![ServiceNow connection settings form in Test Manager](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125746-f1e88725-d0946d67.webp)
6. Select the connection to expand the panel and copy the **API Key** for later use.
7. Open the **Application Navigator** in ServiceNow™ and use the search function to find **UiPath® Test Integration**. If prompted to switch the application scope, select the one you are currently working with.
8. Configure the following integration settings:
   * **Integration URL**: Add the UiPath® Test Manager URL.
   * **API Key**: Paste the API key.
   * **Logging level**: Select **info** to from the dropdown. The default value is **debug**.
   * **ServiceNow integration user for UiPath® Test Manager**: Enter the User ID you have configured for your integration user account.

     ![UiPath Test Integration settings in ServiceNow](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125794-7fd49a93-d30da562.webp)
9. Select **Save**.

## Managing ServiceNow™ Connections

The following table lists the actions that you can take to manage your ServiceNow<sup>TM</sup> connections.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Action  
     Description  
     Procedure  
  
 
 
  
    Edit 
     Edit your connection settings.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Select the Settings button to open Project Settings. 
         In the Integration list, select a ServiceNow connection to expand the panel. 
         Select Edit to configure the connection. 
         Select Save to confirm. 
      

  
  
    Delete 
     Delete the selected connection and its associated requirements.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Select the Settings button to open Project Settings. 
         In the Integration list, select a ServiceNow connection to expand the panel. 
         Select Delete to remove the connection. 
         Select Ok to confirm. 
      

  
 

## Related articles

[Defect synchronization](https://docs.uipath.com/test-manager/automation-suite/2.2510/user-guide/defect-synchronization#defect-synchronization)

## Result

The ServiceNow integration user account and connection are configured. Requirements and defects are synchronized between Test Manager and ServiceNow according to the configured integration settings.

The following remain fully managed within Test Manager and are not synchronized with ServiceNow:

* Test cases
* Test steps
* Test sets
* Test results