ServiceNow Plugin Configuration Details

The default ServiceNow plugin provides functionality for ServiceNow requests, where the requests that are associated are items in ServiceNow projects.

The provider types are used as follows:

The ServiceNow Request provider type enables you to link requests to your ServiceNow item.

Before you can use the ServiceNow plugin, an administrator must do the following:

Install and add the plugin. See Preparing the Plugins.
Add one or more configurations of the plugin. See Adding or Updating Configurations and the example ServiceNow plugin configuration described in the following table.
Configure custom column fields to display appropriate data for ServiceNow requests. See Fields for ServiceNow.

Example ServiceNow Plugin Configuration

The fields for an example ServiceNow plugin configuration are described in the following table.

Field	Description	Example Values
Name	A unique name for the plugin configuration	ServiceNow
Description	A description of the plugin configuration that distinguishes it from other configurations in the list	ServiceNow
Request Properties	Used when adding requests
Request Provider Name	A descriptive name of the request provider	ServiceNow Sample Request
Request Provider Description	Description of the provider, which appears as a tooltip in Edit Requests when users are adding a request	ServiceNow Sample Request
ServiceNow URL	Url to the ServiceNow server, in the format of https://<instance_name>.service-now.com	https://demo001.service-now.com
User Name	User name used to authenticate with ServiceNow
Password	Password used to authenticate with ServiceNow
Tables	Specify a comma-delimited list of ServiceNow tables to make available for searching. Use a colon to separate table name and display name. For example: problem:Problem Users are given a choice if more than one table is specified. Tip: Refer to 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 Using the Field List for Custom Columns.	change_request:Change Request, incident:Incident
Query	Specify a ServiceNow query to retrieve records. {SEARCHTERMS} will be replaced with search criteria entered by users.	short_description LIKE {SEARCHTERMS} ^ OR description LIKE {SEARCHTERMS} ^ OR number LIKE {SEARCHTERMS}
Field List	Specify a comma-delimited list of fields to retrieve from ServiceNow tables listed in the Table field. For date and time fields specify DATETIME format delimited by a colon. The following fields will always be included and do not need to be specified: sys_id, number, description, short_description, sys_created_by, sys_created_on, sys_updated_by, sys_updated_on, assigned_to See Using the Field List for Custom Columns.	category, severity, incident_state
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 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. This is used in conjunction with the Tables and Field List fields. See Using the Field List for Custom Columns.	change_request:number,incident:number
Name Field	Enter ServiceNow table entries to map to Name so that it can be displayed in Release Control. This is used in conjunction with the Tables and Field List fields. See Using the Field List for Custom Columns.	change_request:short_description, incident:short_description
Description Field	Enter ServiceNow table entries to map to Description so that it can be displayed in Release Control. This is used in conjunction with the Tables and Field List fields. See Using the Field List for Custom Columns.	change_request:description, incident:description
Provider Types
Execution	Provides functionality for executing deployment tasks	Not Supported
Deployment Unit	Provides functionality for linking deployment units	Not Supported
Request	Provides functionality for associating requests	Enabled
Configuration Information
Configuration ID	Unique identifier of this configuration within the database instance. Read only.
Configuration UUID	Unique global identifier of this configuration. Read only.