Viewing the development information for an issue

If your administrator has connected Jira Software to a compatible development tool, a Development panel will be displayed on the View Issue screen, and when you view a search for issues in a list view, you can also view a Development column. Depending on which tools Jira Software is connected to, the Development panel and Development column provide the following functionalities:

  • Bitbucket Cloud or Bitbucket Server: view and create branches, view commits, and view and create pull requests
  • Fisheye/Crucible (Git/Subversion/Perforce/CVS): view branches (not create), view commits, and view and create reviews
  • Bamboo: view the status of builds and deployments
  • GitHub or GitHub Enterprise: view branches (not create), view commits, and view and create pull requests

On this page:

Before you begin

  • Your administrator needs to have set up Jira Software and your development tools correctly. Refer your administrator to Integrating with development tools.
  • You must have the 'View development tools' permission to be able to see the Development panel.

Make your development information available in Jira Software

You must reference the issue key in your commit, branch, pull request, etc if you want it to display as a link in the Development panel or column. For information on how to reference issue keys correctly, see Referencing issues in your development work.

View the Development panel

If everything has been set up correctly, you will see a Development panel on each of your issues, similar to the screenshot below. The Development panel provides you with just enough information to evaluate the status of an issue's development at a glance.

Development panel within an issue.

  1. Development panel

Notes:

What does the status lozenge next to the pull requests mean?

 The pull request(s) status in the Development panel is:  

OPEN if there is at least one open pull request.

MERGED if there are no open pull requests, and at least one pull request has been merged.

DECLINED if there are no open or merged pull requests, and at least one pull request has been declined.

What does the status lozenge next to the reviews mean?

 The review(s) status in the Development panel is:  

REVIEW if there is at least one review in 'Review' status.' (yellow with black writing)

APPROVAL if there are no reviews in 'Review' status, and at least one review is in 'Approval' status. (black)

SUMMARIZE if there are no reviews in 'Review' or 'Approval' statuses, and at least one review is in 'Summarize' status. (black)

REJECTED if there are no reviews in 'Review', 'Approval', or 'Summarize' statuses, and at least one review is in 'Rejected' status. (red)

APPROVAL all reviews are in 'Closed' status.

Note, 'Draft' and 'Abandoned' reviews are not shown.

What does the status lozenge next to the builds mean?

 The build(s) status in the Development panel is:  

if all the different builds (for example, unit tests, functional tests, deploy to staging) have passed.

if at least one run failed for any build by any linked build server.

View the Development column

If everything has been set up correctly, you will be able to view a Development column for searched issues in a list view, similar to the screenshot below. The Development column provides you with just enough information to evaluate the status of an issue's development at a glance, if you click on an icon or link, you'll see all the information from the linked development tool.

Development column on an issue list view.

View Development tool information on a card

You can view Development tool information on a card by navigating to your board, selecting Board > Configure > Card layout, and adding the Development field. You'll then be able to see information from your connect Development tools on your cards, giving you more context when viewing issues on a board.

Development info icons on an issue card.

Investigate and action the information

If you want to investigate something in the Development panel or column, you can click the item to display a dialog with more details. The dialog provides links for you to action or drill into. Note, you may be prompted to authenticate with the linked application first. 

For example, say that the Development panel was showing this: 3 builds . You could click 3 builds to open a dialog showing which of the three builds are failing. If you wanted to investigate further, then you could click the build plan or build result to view it in Bamboo.

Here are the actions you can do via the Development panel:

Create feature branches

BITBUCKET

Click Create branch in the Development panel to open your connected SCM, and start the process for creating a branch. If you have multiple applications connected, then you can choose where you'd like to create the branch. The key for the Jira issue will be automatically added to the name of the branch.

See repository branches

BITBUCKET FISHEYE GITHUB

Click n branches in the Development panel to open a dialog in Jira Software that shows the branches for the linked SCM. If Jira Software has been linked to more than one SCM, a tab will show for each SCM product (e.g. Bitbucket). The branches will be grouped under each SCM in these tabs.

Branches linked to an issue.

  • Click a repository or branch to open the linked SCM at the relevant repository/branch.
  • Hover over a Pull request status (e.g. MERGED) to show a popup displaying a link to the pull request.
  • Click Create pull request to create a pull request for the branch (to merge it back to master).
See commits to repositories

BITBUCKET FISHEYE GITHUB

Click n commits in the Development panel to open a dialog in Jira Software that shows the commits and related files for the linked SCM. If Jira Software has been linked to more than one SCM, a tab will show for each SCM product (e.g. Bitbucket). The commits will be grouped under each SCM in these tabs. If a commit is greyed out, it has been merged through a pull request.

Commits related to an issue.

  • Click a repository or commit to open the SCM at the relevant repository/branch.
  • If Jira Software is linked to more than one SCM, the dialog may show duplicate commits across tabs. For example, you may have pointed FishEye and Bitbucket to the same repository.
  • (Bitbucket only) If the commits belong to a fork of a repository, they will be grouped under the fork. The fork will also have a link to the original repository, "Fork of <repository name>".
Create pull requests

BITBUCKET GITHUB

See the 'See repository branches' section above.

See the status of pull requests

BITBUCKET GITHUB

Click n pull requests in the Development panel to open a dialog on Jira Software that shows the pull requests for the linked SCM(s). If Jira Software has been linked to more than one SCM, a tab will show for each SCM product (e.g. Bitbucket). The pull requests will be grouped under each SCM in these tabs.

Pull requests related to an issue.

  • Click a pull request to open it in the linked SCM.
  • Hover over a user icon to show the user's name.
See the status of reviews

CRUCIBLE

Click n reviews in the Development panel to open a dialog in Jira Software that shows the reviews.

Reviews related to an issue.

  • Click a review to open it in Crucible.
See the status of builds

BAMBOO

Click n builds in the Development panel to open a dialog in Jira Software that shows the builds.

Builds related to an issue.

  • Click a plan or build result to view it in Bamboo.
See the status of deployments

BAMBOO

Click Deployed (to environment) in the Development panel to open a dialog in Jira Software that shows the deployment.

Deployments related to an issue.

  • Click an environment or release to view it in Bamboo.
Last modified on May 6, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.