Step 1. Activate the ServiceNow Integration in SiQ

From the SiQ Web App, complete the following:

1. Click your Profile Name in the top right corner.
2. Click Settings. The Settings screen displays.
3. From the left menu, click Integrations.
4. From the Third Party Integrations area, click the READ MORE link. The Integrations screen displays.

You can either search for ServiceNow in the Search field or navigate to ServiceNow tile. To navigate complete the following:

1. From the left menu, click Ticketing.
2. For ServiceNow, click the Activate button.

The ServiceNow dialog displays and it contains the Ticketing via ServiceNow tab.

Ticketing via ServiceNow tab

Complete the following fields and note that each field has its own explanation of where the value is found in ServiceNow.

• Domain - Your company's ServiceNow instance domain name, found in your browser's URL bar when you are logged in to ServiceNow.
• Account User Name - Input the username that you will create in the Create API User section below.
• Account Password - Again, input the password for the username you will create below.
• Optional - Schema Custom Attributes  - Deines simple custom fields name mapped to SiQ application in the form of JSON. For example '{"location":"employee_location"}'
• Optional - Filter Only Matching Tickets - Defines custom filters to filter out a certain tickets in the form of JSON. For example '{"sys_updated_by":"employee"}'

Click the Save button. The ServiceNOW Integration will start to pull in the tickets.

Step 2. Set up ServiceNow to perform CRUD

Step 2.1 Create API User

In the ServiceNow portal, create a user with admin and API access permissions to perform CRUD  (Create, Read, Update, and Delete) operations on the tickets.

Step 2.2 Add Custom Application Menu

In order for a SiQ to export move order tickets to ServiceNow, a custom application with a table must be created in ServiceNow.

Follow these instructions to create a custom application, and name your application's menu "SpaceIQ Service Desk" in the category of "Custom Applications". Click Save/Create, then move on to creating a table.

Step 2.3 Create Application Table

You can read more about ServiceNow application tables here.

Follow these instructions to create a table. During or after the table creation, add the following columns to the table: 

Custom Attributes

SiQ provides a way to import basic and non-standard attributes into Tickets through integration configuration.

For example:

 '{"contact_type":"phone"}'

Ticket Filtering

Also, in order to import relevant tickets from ServiceNow, users have an option to set up filtering criteria by a given field and value. Upon activation of filtering, only tickets that match this criteria will be imported into SiQ. All others will be skipped.

For example:

 '{"priority":"1"}'

These custom attribute and filtering fields are mapped with JSON, and field names can be found in this ServiceNow API document.

Import Process

SiQ will import tickets according to the following criteria:

• Tickets will be imported every 24 hours.
• The initial import will include tickets (problems, incidents, service requests) up to one year old.
• After an initial import, SiQ will import all the tickets opened or modified. The new tickets will appear in SiQ with a delay of up to 24 hours, depending on the timing of the synchronization.

The following ticket tables will be imported from ServiceNow into SiQ:

• Problems
• Incidents
• SC_Requests

 Upon the import, SiQ will: 

• Associate ServiceNow ticket owner user(s) with the corresponding user in SiQ.
• Associate “Assigned To” user(s) with the corresponding user in SiQ.
• Associate “Assigned To” department(s) with a department in SiQ.
• Associate tickets with a building in SiQ using the building's address. The addresses must be identical between SiQ and ServiceNow