ServiceNow plugin

With the XL Release ServiceNow plugin, you can work with requests on a ServiceNow host from the XL Release UI. The following task types are included:

  • ServiceNow: Create Record
  • ServiceNow: Create New Record
  • ServiceNow: Update Record
  • ServiceNow: Find Record By Ticket
  • ServiceNow: Create Incident
  • ServiceNow: Create New Incident
  • ServiceNow: Update Incident
  • ServiceNow: Find Incident By Ticket
  • ServiceNow: Create ServiceRequest
  • ServiceNow: Create New ServiceRequest
  • ServiceNow: Update ServiceRequest
  • ServiceNow: Find ServiceRequest
  • ServiceNow: Create Request Item
  • ServiceNow: Create New Request Item
  • ServiceNow: Update Request Item
  • ServiceNow: Find Request Item
  • ServiceNow: Create Task
  • ServiceNow: Update Task
  • ServiceNow: Check Status
  • ServiceNow: Create ChangeRequest
  • ServiceNow: Create New ChangeRequest
  • ServiceNow: Update ChangeRequest
  • ServiceNow: Find ChangeRequest
  • ServiceNow: Find ChangeTask
  • ServiceNow: Request Approval
  • ServiceNow: Poll ChangeRequest Status
  • ServiceNow: Get ChangeRequest
  • ServiceNow: Check ChangeRequest
  • ServiceNow: Update CMDB
  • ServiceNow: Schedule Task
  • ServiceNow: Create Request

In the release flow editor, the ServiceNow tasks have a blue border.

Features

  • Create a new ServiceNow resource
  • Create a new ServiceNow resource using JSON
  • Update a ServiceNow resource
  • Find a ServiceNow resource by ticket
  • Check status of a task
  • Check status of a change request
  • Request approval of a change request
  • Poll the status of a change request
  • Schedule a task

Set up a ServiceNow server

To set up a connection to a ServiceNow server:

  1. In XL Release, go to Settings > Shared configuration > ServiceNow: Server, and click Add button to add a new ServiceNow server.

  2. In the Title field, enter the title for the ServiceNow server.

  3. In the Url field, enter the IP address or host name for the ServiceNow server.

  4. In the Username field, enter username to connect with the ServiceNow Server.

  5. In the Password field, enter password to connect with the ServiceNow Server.

    Setup ServiceNow Server

Create record task type

The ServiceNow: Create Record task type creates a new record in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Short Description: [Required] A short description of the record to be created.
  • Comments: [Required] Comments in the record to be created.

The task output properties are: Data, Sys Id, and Ticket.

ServiceNow Create Record

Create new record task type

The ServiceNow: Create New Record task type creates a new record in the ServiceNow server using a JSON string. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Request Content: [Required] The JSON string with the request content of the new record to be created (Example: {"short_description":"Example","comments":"Example"}).

The task output properties are: Data, Sys Id, and Ticket.

ServiceNow Create New Record

Update record task type

The ServiceNow: Update Record task type updates an existing record in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Sys Id: [Required] The sys ID of the ticket that needs to be updated (Example: d1a37dcadb0023006ab155d0cf9619d5).
  • Request Content: [Required] The JSON string with the request content of the new record to be created (Example: {"short_description":"Example","comments":"Example"}).

The task output property is Data.

ServiceNow Update Record

Find record by ticket task type

The ServiceNow: Find Record By Ticket task type finds an existing record in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Ticket: [Required] The ticket ID of the ticket that needs to be found (Example: REQ0010001).

The task output properties are Data and Sys Id.

ServiceNow Find Record By Ticket

Check status task type

The ServiceNow: Check Status task type fetches the status of an existing task in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Status Field: [Required] The status field to use (Example: state).
  • Table Name: [Required] The table name of the table in ServiceNow (Example: change_task).
  • System ID: [Required] The system ID of the ticket that needs to be updated (Example: d1a37dcadb0023006ab155d0cf9619d5).

The task output properties are Data and Status.

ServiceNow Check Status

Get change request task type

The ServiceNow: Get ChangeRequest task type fetches the values of a list of fields of an existing change request in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Number: [Required] The ticket ID of the ticket that needs to be found (Example: CHG0010001).
  • Field Names: [Required] The list of field names to be displayed (Example: state).

The task output property is Data.

ServiceNow Get ChangeRequest

Check change request task type

The ServiceNow: Check ChangeRequest Status task type checks if an existing change request is closed in the ServiceNow server. The following properties are available:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Number: [Required] The ticket number of the change request to check (Example: state).

The task output property is Data.

ServiceNow Check ChangeRequest Status

Poll change request status task type

The ServiceNow: Poll ChangeRequest Status task type matches the status value against the status field of an existing change request in the ServiceNow server. The task has the following properties:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Table Name: [Required] The table name of the table in ServiceNow (Example: change_task).
  • System ID: [Required] The system ID of the ticket that needs to be updated (Example: d1a37dcadb0023006ab155d0cf9619d5).
  • Polling Interval: [Required] Polling interval in seconds to check the task status. The default value is 10.
  • Status Field: [Required] The status field to use (Example: state).
  • Status Value to check for: [Required] The value of the status field to check against the status field (Example: New).

The task output properties are: Status, Ticket, and Data.

ServiceNow Poll ChangeRequest

Request approval task type

The ServiceNow: Request Approval task type creates a new change request and waits until it is approved. The task has the following properties:

  • Server: [Required] The ServiceNow Server to connect to.
  • Username: Overrides the username in Shared Configuration.
  • Password: Overrides the password in Shared Configuration.
  • Short Description: [Required] The short description of the change request.
  • Description: [Required] The description of the change request.

The task output properties are:Data, Sys Id, and Ticket.

ServiceNow Request Approval

Schedule task type

The ServiceNow: Schedule Task task type uses data in a ServiceNow ticket to schedule a task to run at some time in the future. The task has the following properties:

  • Start Date Field: The field in the task to use for the start date of the target task.
  • Phase to start release window: The release phase where to look for the task that needs to be scheduled.
  • Task to start release window: The name of the task to be scheduled in the mentioned phase.
  • Servicenow date format: The date format used to parse the date in the task (Example: yyyy-MM-dd HH:mm:ss).
  • ServiceNow TimeZone: The time zone used to parse the date in the task (Example: GMT).
  • XLR Date format: That date format used to parse XL Release dates (Example: yyyy-MM-dd'T'HH:mm:ss'Z').
  • ServiceNow key-value map: XL Release variable to keep information about the task to be scheduled. This data should include the date and time that the release is scheduled to continue (Example: {start_date: 2019-01-01 01:00:00}).

ServiceNow Schedule Task

Release notes

XL Release ServiceNow plugin 9.0.0

  • Added compatibility with XL Release 9.0.0

XL Release ServiceNow plugin 8.5.0

Important: Version 8.5.0 onwards, XL Release ServiceNow App is required to be installed on your ServiceNow instance.

Improvements

  • [REL-7525] - Add support to integrate with ServiceNow Store API

XL Release ServiceNow plugin 8.2.0

Features

  • Add ServiceNow shared configuration and add check connection
  • Add tasks related to CMDB and ServiceNow Schedule
  • Add tasks related to Change Requests Tasks
  • Add tasks related to Change Request
  • Add tasks related to Incident Requests
  • Add tasks related to Service Requests
  • Add tasks related to Service Request Items
  • Add task related to Create Request
  • Add ServiceNow Query Tile