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.

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.

1 - Login

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 username

Any string

Username of the user configured in ServiceNow

ServiceNow passwordAny stringPassword of the user configured in ServiceNow

Profile configuration (in the profiles tab):

Field nameSupported valuesDescripition
NameAny stringProfile unique identifier
ServiceNow tableincident, task or requestTable in ServiceNow to poll from
Polling intervalAny integerPolling interval in seconds (default is 300)
Assignment groupAny stringName of the assignment configured in ServiceNow
Exclude commentstrue / falseDefines 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).

See also