JIRA Repositories
- Debesh Roy Chowdhury
In this section, the Syndeia Web Dashboard capabilities for JIRA repositories are presented.
Pre-Requisites
Check supported versions of JIRA here: Syndeia 3.5 - Integration Compatibility
Tutorials
See the JIRA integration tutorial for Syndeia Web Dashboard - Part 8 - JIRA on Web Dashboard.
Add a JIRA Repository
(1) Click the Repositories icon in the LHS menu pane.
(2) Select JIRA in the list of Repository types on the LHS and click on the + icon to add a new JIRA repository, as shown below.
(3) Fill out the details for your JIRA server (repository), as shown below, and click the Create button.
URL - Base URL of your JIRA repository
Name - Name of the JIRA server. Provide a unique name to distinguish this JIRA repository from others you may add.
Description - Description of the JIRA repository
Authentication type - Basic (default)
Username - Username to sign in to your JIRA repository. Enter the same username that you use on the JIRA web client.
Password - Password to sign in to your JIRA repository.
If you are using JIRA Server (installed on premise or virtual private cloud), enter the same password that you use on the JIRA web client.
If you are using JIRA Cloud (hosted by Atlassian), enter your API token to sign in. To create an API token, refer here - https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/.
Browse a JIRA Repository
(1) Expand the JIRA repository after it has been added.
(2) If your repository details are correct, Syndeia Cloud will try to sign in to the JIRA repository and display all Projects that are accessible to you, as shown below.
(3) Expand a Project to view issues organized by the following 3 categories:
Assigned to me - Issues where the current user is the assignee
Reported by me - Issues where the current user is the reporter
Watched by me - Issues where the current user is a watcher
(4) Use Simple or Advanced Search (via JQL), as documented below, for filtering issues by other criteria
Search a JIRA Repository
Users can search Spaces and Pages in a JIRA repository. Click on the Search icon on the RHS to see the Search tab.
(1) Simple Search
The Simple Search capability provides a Query Builder for searching issues.
Select the JIRA Simple option in the Select type dropdown, as shown below.
Select a Project in the Select project dropdown.
Select Issue in the Select artifact type dropdown.
Use the Query Builder to add property-operator-value triads to build a query, e.g.
priority = Major,status = Closed. The corresponding JQL query is generated and shown in the Query field.Click the Search button. Results are shown on the RHS.
(2) Advanced Search
The Advanced Search capability can execute any Jira Query Language (JQL) query.
Select the JIRA Advanced option in the Select type dropdown, as shown below.
Select Issue in the Select artifact type dropdown.
Specify your JQL query in the Query field, e.g.
project = HELLO AND status = Open and type = Bug and assignee = currentUser(). To learn more about JQL, refer here - https://support.atlassian.com/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/Click the Search button. Results are shown on the RHS.
Digital Thread Explorer
(1) See an overview of the Digital Thread Explorer - Digital Thread Explorer (DTE)
(2) See the tutorial for JIRA integration on Syndeia Web Dashboard - Part 8 - JIRA on Web Dashboard.
The Digital Thread Explorer for JIRA will show both intra-model relationships, e.g. links between JIRA issues, and inter-model relationships created using Syndeia, e.g. relationships between JIRA issues and requirements (Jama Connect, DOORS NG), SysML models (Teamwork Cloud), test cases (TestRail), software modules (GitHub), or other artifacts in your digital thread.
Creating Relations
(1) See an overview of the Creating Relations - Creating Relations on the Web Dashboard
(2) See the tutorial for JIRA integration on Syndeia Web Dashboard - Part 8 - JIRA on Web Dashboard.