Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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.

  3. On the Add Issue Management screen that appears

...

  • 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 dialog below uses change_task incident 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. The example dialog below includes a filter on the status column, which limits the result to rows where the value of the column is “Active”

Info

Search queries use ${ } to represent column values. Other characters, if any, are reproduced as is.

The filter, on the other hand, takes the column name and a literal without any enclosing ${ }.

  • Image RemovedImage Added

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

...