Jira is an issue tracking product developed by Atlassian that allows bug tracking and agile project management. For information about connecting with Pipelines Agent, see Quickbase Pipelines Agent connections.
See the Channel Catalog to see which Plans have access to this channel.
Note: For the sprint information to be displayed, the field Issue type must be completed.
Please note that terms used in the Jira channel categories are Jira specific terminology.
How to Connect
- On the My pipelines page, click Create Pipelines.
- Search for the first step for your new pipeline. You can always add more steps later.
- To use the legacy builder, click the Pipeline Designer toggle to use the legacy version of the pipeline builder.
For more information about connections, see How to connect to a channel.
Connect to Jira
- Expand Jira in the list of channels on the right side of the page and click Connect to Jira.
- In the pop-up window, enter your organization's URL, your Username and Password or API token. It is recommended to leave the checkboxes unchecked. When finished click Connect to Jira.
Note: An API token can only be used if your Jira instance is cloud-based. If you are unsure if Jira is cloud-based or locally hosted, check with your Jira administrator.
How to reconnect
You may need to reconnect your account to a channel. Reasons may be (but not limited to):
- If you need to connect a different account.
- Authorization updates, such as a changed password.
- Editing the access rights that Pipelines has to the channel.
To reconnect:
- Select a pipeline that already has this channel in it.
- Open a step that contains this channel.
- Under account, select Connect (or reconnect) and follow the process above, How to connect.
Steps
The steps you can use with Jira are grouped into five categories:
- Comments
- Issues
- Worklogs
- Attachments
Note: You cannot use jinja expressions in trigger conditions unless explicitly specified as possible.
| Type | Name | Description |
|---|---|---|
| Comments | ||
| Trigger | Comment Created | Triggers when a new comment is created in the selected project. |
| Trigger | Comment Updated | Triggers when a comment is updated in the selected project. |
| Action | Comment on an Issue | Creates a new comment to the selected issue. |
| Action | Update Comment | Updates a comment in a specific issue. |
| Query | Search Comments | Searches comments and returns a list. |
| Action | Fetch a Linked Comment | Fetches a linked comment. |
| Action | Look Up Comment | Searches comments and returns a single record. |
| Issues | ||
| Trigger | Issue Created | Triggers when a new issue is created in the selected project. If a project is not selected all issues in all projects are monitored for updates. |
| Trigger | Issue Updated | Triggers when an issue is updated in the selected project. If a project is not selected all issues in all projects are monitored for updates. |
| Action | Create Issue | Creates an issue in the selected project. |
| Action | Update Issue | Updates the selected issue. |
| Action | Transition Issue | Transitions the selected issue to another state. |
| Action | Delete Issue | Deletes the selected issue. |
| Action | Add Watcher | Adds a watcher to the issue. |
| Action | Remove Watcher | Removes a watcher from the issue. |
| Query | Search Issues | Searches a project and returns a list of issues. |
| Query | Search Subtasks | Lists subtasks of an issue. |
| Action | Fetch a Linked Issue | Fetches a linked issue. |
| Action | Look Up an Issue | Fetches an issue by uniquely identifying attribute. |
| Worklogs | ||
| Trigger | Worklog Created | Triggers when a new worklog entry is created in an issue. |
| Trigger | Worklog Updated | Triggers when a worklog is updated. |
| Attachments | ||
| Trigger | Attachment Created | Triggers when an attachment is created. |
| Trigger | Attachment Deleted |
Triggers when an attachment is deleted. |
| Action | Create Attachment | Creates an attachment. The file limit is 100 MB. |
| Action | Delete Attachment | Deletes an attachment. |
| Query | Search Attachments | Searches attachments and returns a list. |
| Action | Fetch a Linked Attachment | Fetches a linked attachment. |
| Action | Look Up Attachment | Looks for an attachment and returns a single record. |
| Projects | ||
| Trigger | Project Created | Triggers when a project is created. |
| Trigger | Project Updated | Triggers when a project is updated. |
| Query | Search Projects | Searches projects and returns a list. |
| Action | Look Up project | Looks for a project and returns a single record. |
Use Cases
Here are some use case examples to help you understand how to use the Jira channel.
In this example, when a Quickbase form is completed, a Jira ticket is created.
- We add a Quickbase Record Created step to trigger when a new help feedback form is completed.
- Then we add a Jira Create an Issue action that takes data from the Quickbase form and creates a jira ticket to review the feedback.
