This instruction describes the configurations to be implemented in ServiceNow to set up the BlueDolphin ServiceNow Connector for a single ServiceNow Asset Class to BlueDolphin Object Definition Type connection.
Repeat this instruction for every BlueDolphin Object Definition Type you would like to be sourced from ServiceNow.
NOTE: Integration does not support relationships, and it is a unidirectional flow of data from ServiceNow to BlueDolphin.
Configuration to be added to the ServiceNow
Once you install the Template name - BIF: ServiceNow Entity -> BlueDolphin Object (CREATE, UPDATE) template, you are navigated to the configuration page.
Take the value of the Webhook URL, object definition ID, and the workspace ID to create a webhook using this information for ObjectCreated and ObjectUpdated. Refer to the Subscriptions section for more information
In the General Configuration section, fill in all the required fields by referring to the table below.
Click Verify and Connect to confirm that the connector details are correct.
If the connection is successful, it says connected in the bottom right corner, and the Integration Mapping field appears.
In the Integration Mapping, map ServiceNow fields to the BlueDolphin object definitions you wish to connect.
This is the one-on-one field mapping table from the ServiceNow Asset Class to the BlueDolphin Object Type properties or questionnaire fields.
Click Activate in the bottom right corner.
General Configuration Fields
Fill in all the details as described in the table,
Section | Field | Description |
Flow Name |
| Template name |
Webhook URL |
| ServiceNow webhook endpoint |
General Configuration | Instance URL | Address URL from the TOPdesk API |
| User Name | ServiceNow API account name |
| Password | ServiceNow password |
| Cycle Token | Unique token that is defined in the business rule script. It is a security measurement to prevent the cycles from being used publicly. You can configure the token in the script using the zip file below. TOKEN: "#USER_DEFINED_TOKEN#" NOTE: Cyclr token must be picked to make integration run. This token corresponds with the token in the Marketplace. |
| Table (Mandatory) | Table from ServiceNow you want to connect to BlueDolphin. |
| BlueDolphin ID Field (Optional) | The BlueDolphin ID column in the table. For example, bluedolphin-id. |
Extended tables | API URL | BlueDolphin API URL For US tenants: |
| Tenant Name | Your tenant name can be found in the BlueDolphin URL behind "app/" |
| API Key | |
| Object Definition ID | BlueDolphin Object Definition ID you want to connect. Admin-> Configuration-> Object Definition: Select the object definition you want to use and copy and paste the end part of the URL. |
| Workspace ID | BlueDolphin Workspace ID you want to connect. Admin-> Configuration-> Business Units Select the workspace you want to use and copy and paste the end part of the URL. NOTE: Tenants with no workspace should use the “get workspace” call from the public API to retrieve it. |
ServiceNow package: The configuration required for ServiceNow is available in the attached .zip file.