The most common location to add content from your app is on Jira's issue view. There are two general types of locations for your content on the issue view page.
You can add web items
as actions that the user takes on an issue. This is ideal for
triggering dialogs provided by your app that allow users to take action on the issue,
supported by your app. Actions are also great for linking the Jira issue to external
content that may live outside of Jira, or even creating new content like a diagram that
you then attach to the issue.
The other type of location is a panel, which is used to provide content from your app relevant to that issue. This might be external content, or a special visualization of content stored within Jira.
Issue actions, such as sharing an issue, exporting an issue, and more, are implemented via buttons at the top right of the issue view. You can extend issue actions either by adding a new web item next to the issue actions, or by inserting a new web section or web item in the more actions (•••) menu.
For web items
:
jira.issue.tools
: Add a button in the issue actions areaoperations-top-level
operations-work
operations-attachments
operations-voteswatchers
operations-subtasks
operations-operations
operations-delete
1 2... "modules": { "webItems": [ { "key": "example-tools-item", "location": "operations-operations", "weight": 10, "name": { "value": "Example app link" }, "url": "/example-section-link" } ] } ...
The properties required for this location are the standard ones defined in the documentation for web items.
You can also define web panels to render larger pieces of content on the issue view
page. These panels use the web panel
module and are available on either the right
or left side of the page. We recommend that you follow Jira's standard convention, that
information on the right hand side provides context for the issue (more
information, links to relevant content, other work associated with the issue). Panels
on the left side should provide content that you expect the user to consider part
of the body of work that the issue itself represents.
For web panels:
atl.jira.view.issue.left.context
atl.jira.view.issue.right.context
1 2... "modules": { "webPanels": [ { "key": "example-issue-left-panel", "location": "atl.jira.view.issue.left.context", "name": { "value": "App panel location left side title" }, "url": "/example-issue-left-panel" }, { "key": "example-issue-right-panel", "location": "atl.jira.view.issue.right.context", "name": { "value": "App panel location right side title" }, "url": "/example-issue-right-panel" } ] } ...
The properties required for this location are the standard ones defined in the documentation for web panels.
Rate this page: