BlueDolphin now supports Jira integration, allowing you to create or update fields from Jira stories, tasks, or issues for object definition in your BlueDolphin tenant. You can configure fields such as status, assignee, or description in the object.
When an object is created through Jira, the issue link is displayed by default.
Prerequisite: Set up a webhook in Jira to send the information through integration.
NOTE: Integration does not support relationships, and it is a unidirectional flow of data from Jira to BlueDolphin.
Configuration to be added to JIRA
Once you install the Template name - BIF: Jira 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 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.
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 |
| User Name | Jira API account name |
| API Token | Jira API key |
| Project Key | Template from Jira you want to connect to BlueDolphin |
| Entity | Type of issue (for example, story, task, etc.) |
| BlueDolphin ID Field (Optional) | BlueDolphin ID fields created in Jira. Refer to BlueDolphin Link ID Field. |
| 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. |
BlueDolphin Link ID Field
The BlueDolphin Link ID Field needs to be manually edited.
For example, for fields|customfield_10046, if you have a custom field that has number 10046 for storing 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.
fields|customfield_XXXXX
KNOWN ISSUES
Issue 1: When editing the name of an existing object in Jira, a new object is created in BlueDolphin instead of editing the name of the existing object when the BlueDolphin ID in Jira is not automatically filled.
Issue 2: When mapping a date field (for example, Start and End Date of a Sprint) to the property field/questionnaire in a BlueDolphin object, the values are not correctly set.
Issue 3: In some situations, event handling in the flow can lead to a failure of writing the BlueDolphin ID back to Jira, thus causing a disturbance in the follow-up run.