This instruction details the configurations in ServiceNow to set up the BlueDolphin ServiceNow Connector for linking a single ServiceNow Table to a BlueDolphin Object Definition Type.
Repeat this instruction for each BlueDolphin Object Definition Type you want to source from ServiceNow.
NOTE: Integration does not support relationships, and it is a unidirectional flow of data from ServiceNow to BlueDolphin.
BlueDolphin Configuration
Once you install the Template name - BIF: ServiceNow Entity -> BlueDolphin Object (CREATE, UPDATE) template, you are navigated to the configuration page.
In the General Configuration, 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.
Take the value of the Webhook URL, you need this for webhook configuration on the ServiceNow side. See the attachments at the bottom of the article.
General Configuration Fields
Fill in all the details as described in the table,
Section | Field | Description |
Flow Name |
| Template name |
Webhook URL |
| Webhook endpoint |
ServiceNow Configuration (Source) | Instance URL | Address URL from the ServiceNow 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 measure to prevent the cycles from being used publicly.
You can configure the token in the script using the zip file below.
TOKEN: "
NOTE: Cyclr token must be picked to make the integration run. This token corresponds to 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.
NOTE: Leaving this optional field empty will trigger a fallback mechanism to find the object by title next time there is a change in the ServiceNow table. This may cause the creation of a new object if the column in the table that is supposed to store the object title value is changed. |
Bluedolphin configuration (Target) | API URL | Select the URL from a dropdown |
| API Key | |
| 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. |
| 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. |
ServiceNow Configuration
Go to your ServiceNow instance and navigate to “Business Rules.”
Create a business rule.
Select your events, such as insert and update.
Copy and paste the script below after editing the “URL” part in it.
ServiceNow package: The configuration required for ServiceNow is available in the attached .zip file.