BlueDolphin now supports Jira integration, enabling you to create or update Jira epics for object definitions in your BlueDolphin tenant. You can configure fields received in the epic metadata, including assignee, status, description, and issue key.
Prerequisite: Configure a JIRA webhook to transmit information via integration.
NOTE: Integration does not support relationships, and it is a unidirectional flow of data from Jira to BlueDolphin.
Configuration steps
Once you install the Template name - BIF: Jira Entity -> BlueDolphin Object (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 JIRA fields to the BlueDolphin object definitions you wish to connect.
This is the one-on-one field mapping table from the JIRA fields 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 JIRA side. See the information in the JIRA webhook section.
General Configuration Fields
Fill in all the details as described in the table,
Section | Field | Description |
Flow Name |
| Template name |
Webhook URL |
| Jira webhook endpoint |
General Configuration | Instance URL | Address URL from the JIRA API as “https://your-jira-instance.atlassian.net” |
| User Name | JIRA API account name. For example, “[email protected]” |
| API Token | Jira API key |
| Project Key | Template from Jira you want to connect to BlueDolphin |
| Entity | Type of issue (in this case “Epic”) |
| BlueDolphin ID Field
| BlueDolphin ID field created in Jira. The ID in Jira appears in custom fields as “customfield_XXXXX”. |
| API URL | BlueDolphin API URL For US tenants: https://public-api.us.bluedolphin.app |
| 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. |
BlueDolphin Link ID Field
The BlueDolphin Link ID Field needs to be manually edited.
For example, if you have a custom field with the number 10046 for storing a BlueDolphin ID, follow the process as given.
Navigate to your project and click Project Settings in the bottom left corner.
Click the Issue types option.
In the bottom right corner, select Go to custom option.
Search for your BlueDolphin ID and click Edit details.
Locate the URL and copy the last 5 numbers following the URL.
Paste the following in the field, replacing XXXXX with the numbers in your URL.
customfield_XXXXX
Jira Webhook
For details on the Jira webhook, refer to the Atlassian documentation.
When configuring a webhook, include a filter for the issue type you want to synchronize. If you do not set this filter, the results may be unexpected.
The JSON configuration should look similar to the following example:
