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 unidirectional flowing data from Jira to BlueDolphin.
Configuration to be added for the BlueDolphin
| 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 BlueDolphin Link ID Field. |
|
|
(Optional) |
In JIRA, the key refers to the issue name, and it matches the title in BlueDolphin. This field must be filled with 'key' for the JIRA integration. |
|
| API URL |
BlueDolphin API URL For US tenants: |
|
| Tenant Name | Your tenant name can be found in the BlueDolphin URL behind "app/" or under Admin-> General field ->Database |
|
| API Key | Create new 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.
As 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
- Issues 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.
Comments
0 comments
Please sign in to leave a comment.