BlueDolphin objects are synced to ServiceNow as records in the tables. An object definition in BlueDolphin represents a table in ServiceNow.
NOTE:
To store the ID of a table record in BlueDolphin that will be used to update a record after creation, a property must be created on the respective object. The name of the property should match the “Entity ID Field” in the marketplace configuration.
To store a BlueDolphin object ID in ServiceNow that will be used to update a record after creation, a dedicated column must be created on the respective record type. By default, this field can be named as “bluedolphin-id”. Defining the BlueDolphin ID Field is done by adding a new column in the respective table in ServiceNow. The name of the property should be the same as “BlueDolphin ID Field” in the marketplace configuration.
Make sure that values in BlueDolphin and ServiceNow are configured consistently to avoid possible conflicts.
Configuration to be added for the ServiceNow
Once you install the Template name - BIF: BlueDolphin Object -> ServiceNow Entity (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 BlueDolphin Object Type properties or questionnaire fields to the ServiceNow 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 - BIF: BlueDolphin Entity -> BlueDolphin Object (CREATE, UPDATE) |
Webhook URL |
| BlueDolphin webhook endpoint. Refer Subscriptions section. |
General Configuration | API URL | BlueDolphin API URL For US tenants: |
| Tenant Name | Your tenant name can be found in the BlueDolphin URL behind "app/" |
| API Key | BlueDolphin API Key: Create new API Key |
| Entity ID Field (Mandatory) | Object property in BlueDolphin to store the ID of the newly created ServiceNow table row. |
| 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. |
| Instance URL (Mandatory) | Address URL from the ServiceNow API. Remove the path part of the URL and trailing slashs. For example: |
| User Name | ServiceNow user name |
| Password | ServiceNow user password |
| ServiceNow Table | Table from ServiceNow you want to connect to BlueDolphin |
| BlueDolphin ID Field (Mandatory) | Table column in ServiceNow to store the ID of the BlueDolphin object. . By default, it should be to “bluedolphin-id”
|
| BlueDolphin Title Field (Mandatory) | Title column in ServiceNow where the BlueDolphin object title is stored. |
From ServiceNow to BlueDolphin, refer to the ServiceNow Configuration article.