ServiceNow Listener

Description

The ServiceNow listener plugin polls for incidents, requests and tasks from a ServiceNow instance and sends them into 1Gateway. Supported Servicenow versions: Helsinki, Istanbul, New York and Madrid. Together with the ServiceNow sender, it allows real time synchronization between several ServiceNow instances or other service desk products.

Requires 1Gateway Plugin SDK v2.5.2 or later.

Prerequisites

Create a user in ServiceNow with admin role.

To add a new user in ServiceNow, go to Organization > Users and click New. Fill out the User ID (username) and password and tick the "Active and Web service access only" checkbox. Finally, give the user admin role.

Create an assignment group in Servicenow.

Check that the Inactivity monitor is inactive for 1Gateway incidents. You can do this by adding a condition to the Inactivity monitor: "assignment group is empty". If not, it can trigger unwanted updates every two hours.

For more information, check the ServiceNow documentation:

https://community.servicenow.com/community?id=community_question&sys_id=cd1decc11be0c494ada243f6fe4bcb51

https://docs.servicenow.com/bundle/newyork-platform-administration/page/administer/time/task/t_SetAnInactivityMonitor.html#t_SetAnInactivityMonitor

Installation

Make sure you have the 1gateway zip file that includes the plugin files and valid licences information ready. This file has been provided to you with the installation files.

Login to 1gateway, and make sure you are in "Advanced mode". If this is the first time you log in, the default user and password are both 'admin' (without the quotes).

2 - System Maintenance

Click on the menu icon and choose the option "System maintenance"

3 - Upload file

In the System maintenance view you can either drag and drop the downloaded zip file or select it by clicking the "choose file" button.

4 - Restart

After the upload installation will be confirmed. Restart 1Gateway to ensure any locked files are updated.

Configuration

Open the main menu and click on "New plugin"

Select the plugin you want to configure. Use the Filter field if needed.

Main plugin configuration:

Field name	Supported values	Description
ServiceNow endpoint	Valid ip address or DNS	Endpoint of the ServiceNow server
ServiceNow Authentication Scheme	Oauth, basic, none	Select the type of authentication to use
ServiceNow username	Any string	Username of the user configured in ServiceNow
ServiceNow password	Any string	Password of the user configured in ServiceNow
Client id		Client id for Oauth authentication
Client secret		Client secret for Oauth authentication

Profile configuration (in the profiles tab):

Field name	Supported values	Descripition
Name	Any string	Profile unique identifier
ServiceNow table	incident, task or request	Table in ServiceNow to poll from
Polling interval	Any integer	Polling interval in seconds (default is 300)
Assignment group	Any string	Name of the assignment configured in ServiceNow
Exclude comments	true / false	Defines if to poll for comments or not by calling the sys_journal_field API table

To poll for incidents, tasks and requests, three profiles need to be configured.

There needs to be at least one profile configured.

To use the ServiceNow Listener together with the sender (used for synchronization) make sure that the ServiceNow endpoint is exactly the same in both listener and sender.

Syncing incidents, tasks and requests in multiple systems

To sync tickets (incidents, requests and tasks) with other systems, 1Gateway uses the internal id-mapping (idmap) database. It stores a correlation between the id's of the tickets of the disparate systems and the type of ticket it is (incident, request or task). When the ticket gets polled, the type and id of the ticket is stored in the idmap for later use (when updating that ticket).