Overview
This app is designed to help Birdview users transfer their Jira projects, issues, users, etc. to Birdview and back.
A one-way automation - Jira to Birdview - is currently available. That is to say, projects, tasks, users etc. created in Birdview are not currently transferred to Jira.
Only users who are granted system administrator permission in Jira can set up a Jira-Birdview automation.
Installation
For a complete video guide on installing and configuring the Jira integration app please click the image below:
Jira permissions
To be able to operate the integration app the user must have the following permissions in Jira:
- View email addresses of users,
- Administer Jira projects.
Birdview permissions
- Manage system Settings;
- Add projects.
Actions available in the app
- The app returns a list of existing Jira projects.
- Selected Jira projects are imported to Birdview and created as projects.
- Jira issues are imported to Birdview along with their projects.
- Imported Jira issues are created as activities under respective projects. See the imported activity hierarchy below.
- All existing Jira users are imported to Birdview unless they already exist. The mapping is via the user's email and login in Birdview (similar to SSO users authentication).
- A user added to Jira is imported to Birdview unless it exists already. The mapping is via the user's email and login in Birdview (similar to SSO users authentication).
- Assignments of Jira issues are set up as assignments of respective Birdview activities.
Number of issues per project limitation
In the current version, not more than 600 issues per project may be imported.
Imported activity hierarchy
The hierarchical structure of the issues imported to Birdview as activities is based on the Jira issues' hierarchy, namely:
- Jira epics are created as top-level activities in the Birdview projects;
- Jira stories, bugs and other types of issues that belong to Jira epics are created as nested activities in Birdview.
- Jira stories, bugs and other types of issues that do NOT belong to Jira epics are created as top-level activities under respective Birdview projects.
- Jira sub-tasks are created as nested activities in Birdview.
Field mapping used in the app
The rules of mapping Jira fields to Birdview ones used in the integration app are fixed and not configurable:
| Field level | Jira field | Birdview field | Comments, notes |
| 1. Project1 | Name | Name | 1 Projects are created with the following defaults: status: Open; priority: Medium; Workflow: Default. |
| Description | Description | ||
| Project Lead | Creator | If the user does not exist, it is created in Birdview. | |
| 2. Issue2 | Summary | Name | 2 Activities are created with the following defaults: status: Open; type: Task; priority: Medium. |
| Description2.1 | Descriptions | 2.1 Mentions in descriptions are ignored. | |
| Estimated hours2.2 | Estimated hours | 2.2 If Jira Estimation Statistic is set to Time Tracking. | |
| Estimated hours | Hours Left | ||
| Reporter | Creator | If the user does not exist it is created in Birdview. | |
| Assignee2.3 | Assignee2.4 |
2.3 1 assignee per issue. 2.4 With default role. If the user does not exist it is created in Birdview. |
|
| 3. User3 | Name | Name | 3 Users are created with the following defaults: role: Participant; status: Can't login; login: Email |
| Email is used as the Birdview login. |
Importing projects
To import projects from Jira:
- Click through Login picture > Company settings > Automations > Manage apps.
- Click Edit settings on the Jira app plaque.
- Click Select projects under Projects.
- Checkmark Jira projects to import.
- Click Save when done.
Disconnecting & uninstalling the app
To disconnect the app, follow the steps below:
- Click Edit settings.
- Click Disconnect.
To uninstall the app:
- Sign in to Jira.
- Click Apps.
- Select Manage apps.
- Click the Birdview integration app.
- Click Uninstall.