Page Comparison

...

1. Setup OAuth in ServiceNow in your ServiceNow instance.

2. Create a new OAuth API endpoint for Workbench to access ServiceNow:
   

   

3. Set the “Name” Field to “MettleCI Workbench” and the “Redirect URL” to https://<workbench url>:<port>/api/auth/delegated/<N> where <workbench url>is the URL of your Workbench installation (usually your Development engine), <port> is the https port you are running on (often but not always 8443, check your <config.yml file if unsure), and <N>is the index of the WIM you plan to add (the default generic is 0 and if this is the first other WIM you are adding, the value here would be 1) and click “Submit”:
   

   

   
   Record the redirect URL for later use so you don’t have to derive it again. If your organization has installed multiple MettleCI Workbench application, you can add them all to the same ServiceNow Application Registration by adding multiple Redirect URLs. (comma separated)

4. Click on your newly created Application Registration:
   

   

5. Anchor
   ServiceNowRegisterConfig ServiceNowRegisterConfig

   Note down the “Client ID” and “Client Secret” field properties for later use:
   
   Image RemovedImage Added

You are done with the Service Now portion of the configuration, but you may want to keep this open until you have validated everything is working.

...

1. Access the MettleCI Workbench page to integrate with your Service Now Work Item Management system by logging in to MettleCI Workbench and select Issue Management from the Profile menu (top right)

   1. Image RemovedImage Added

2. On the Registered Issue Management Systems screen select the “+” to create a new Issue Management type.. Initially you will have only the “Default Generic Issue Manager” present, but you can add as many as you need to (including more than one of the same type if necessary) one at a time. It is recommended that you get one working before you add another.
   

   Image RemovedImage Added

3. On the Add Issue Management screen that appears

   Image RemovedImage Added

select Service Now from the Select Issue Management Type dropdown

...

• Field list

  • Name: Anything you like, but something that identifies your Service Now organisational instance would be a sensible choice

  • URL: The URI of your Service Now instance recorded earlier.

  • Client ID: Your Application (client) ID recorded earlier

  • Client Secret: Your client secret recorded earlier

  • Search Queries: This has no default, you will need to create at least one query. Consult with your ServiceNow administrators to determine what table(s) your organization uses, and thus, what table(s), then add or edit the query or queries as needed by using the “pencil” icon and “+” icon to edit what is queried or add a new table to query, respectively. The example uses change_task as the table, keyed on number with number: short_description as the summary shown to the user.

• OPTIONAL - In the Search Queries section of any query, you can add add a filter expression to limit what is returned. Note that this expression is not checked for correct syntax. Consult with your ServiceNow administrators to determine whether you need to filter (most organizations will not) and what columns/values to filter on.
  

  Image RemovedImage Added

• Submit (Save) the newly registered Service Now issue management system.

...

---
- id: 0
  type: "GENERIC"
  name: Default Generic Issue Manager"
- id: 1
  type: "SERVICENOW"  
  name: MyServiceNow:
  url: <your ServiceNow instance URL>
  clientId: <your Client ID>
  clientSecret: "<your Client Secret>"
  search:
      - table: "change_ task"
        id: "${number}"
        summary: "${number}: ${short_description}"
        filter: "state='ACTIVE'"

5. You can now select your new Service Now WIM from any existing or new project.

From Project Management Registered Projects page, select an existing project for editing via the pencil icon:

...

At the bottom there is a dropdown to let you select from all currently configured types of Work Item Management

...

Select myServiceNow (or whatever you named your connection) from the choices

...