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.
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.
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
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. |
Bluedolphin Configuration (Source) | API URL | Select the URL from a dropdown for the relevant region. |
| API Key | BlueDolphin API Key: Create new API Key |
|
| Select the BlueDolphin business unit/workspace from the drop-down. |
| Object Definition | Select the BlueDolphin Object Definition you want to connect from the drop-down. |
| Entity ID Field (Mandatory) | Object property in BlueDolphin to store the ID of the newly created ServiceNow table row. |
ServiceNow Configuration (Target) | Instance URL (Mandatory) | Address URL from the ServiceNow API. Remove the path part of the URL and trailing slashes. 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. |
Also, you can take a look at the ServiceNow to BlueDolphin configuration article.