ServiceNow Item Configuration Details

ServiceNow item configurations enable you to associate items in ServiceNow projects with Release Control requests.

You must create a separate configuration for each ServiceNow table that you want to access.

Note: ServiceNow is highly configurable. In the configuration, you map ServiceNow fields to the somewhat generic Release Control fields, and the field values are populated directly from your ServiceNow implementation during use.

Field Descriptions

The field descriptions are included in the UI. While creating or editing a base or configuration, point to a field name to view its description.

A few fields that may need additional explanation are described in the following table.

Important: The example values given here may not be in your ServiceNow table.

Field	Description	Example Values
ServiceNow URL	URL to the ServiceNow server, in the format of https://<instance_name>.service-now.com	https://demo001.service-now.com
Table	Specify a ServiceNow table to make available for searching. Use a colon to separate table name and display name. For example: problem:Problem Tip: See the ServiceNow wiki Tables and Classes topic to find the exact table names. Note: A table that has an extension will also return all child items. Tables are used in conjunction with the Field List and custom columns to display additional ServiceNow fields in Release Control. See Displaying ServiceNow Fields in Collection Columns.	change_request:Change Request
Result Limit	Result limit for find requests action	300
System User Time Zone Name	Enter a time zone name compatible with the Java API, as specified in the Time zone field in the ServiceNow system user profile. If it is not provided, the default time zone for the Release Control server will be used.	America/Los_Angeles
System User Date Time Format	Specify the date and time format that is in the Date format field in your ServiceNow system user profile. This enables Release Control to correctly handle date time fields from ServiceNow.	yyyy-MM-dd HH:mm:ss
Title Field*	Enter ServiceNow table entries to map to Title so that it can be displayed in Release Control.	number
Name Field*	Enter ServiceNow table entries to map to Name so that it can be displayed in Release Control.	short_description
Description Field*	Enter ServiceNow table entries to map to Description so that it can be displayed in Release Control.	description
Custom Fields*	Specify a comma-delimited list of fields to retrieve from the ServiceNow table listed in the Table field. For date and time fields specify `DATETIME` format delimited by a colon. Selection fields must be specified in ServiceNow Choices. **	state,active,category,priority,assigned_to
Text Fields for Search	Enter ServiceNow table entries to map to text fields to use when searching for items to associate with Release Control.	number,short_description,description
Choice Field for Search*	Specify a field from the ServiceNow table to use when searching Choice field selections. This is used when adding or editing requests. This field is automatically treated as `select` format and must have Choices specified in ServiceNow. **	state
Fields for Create Item*	Enter ServiceNow table entries to map to fields to use when creating ServiceNow items through Release Control.	state,reason,type,category,priority,risk,scope,requested_by,requested_by_date,assignment_group,assigned_to,start_date,end_date,work_start,work_end,cab_required,cab_delegate

* The fields entered must be in the table entered in the Table field. The default custom column fields for ServiceNow don't need to be included. See Custom Column Fields for ServiceNow. For information on displaying these fields in collection lists, see Displaying ServiceNow Fields in Collection Columns.

** Fields in select format must be specified in Choices in the ServiceNow UI. Choices specified in ServiceNow can be distributed across different tables, but Release Control loads only those choices that are in the table specified in the configuration Table field.