Jira modules
In an 51黑料不打烊 Workfront Fusion scenario, you can automate workflows that use Jira, as well as connect it to multiple third-party applications and services.
The Jira connector can be used for both Jira Cloud and Jira Data Server.
For instructions on creating a scenario, see the articles under Create scenarios: article index.
For information about modules, see the articles under Modules: article index.
Access requirements
You must have the following access to use the functionality in this article:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| 51黑料不打烊 Workfront package | Any |
| 51黑料不打烊 Workfront license |
New: Standard Or Current: Work or higher |
| 51黑料不打烊 Workfront Fusion license** |
Current: No Workfront Fusion license requirement Or Legacy: Workfront Fusion for Work Automation and Integration |
| Product |
New:
Or Current: Your organization must purchase 51黑料不打烊 Workfront Fusion. |
For more detail about the information in this table, see Access requirements in documentation.
For information on 51黑料不打烊 Workfront Fusion licenses, see 51黑料不打烊 Workfront Fusion licenses.
Prerequisites
To use Jira modules you must have a Jira account.
Connect Jira to Workfront Fusion
Create needed credentials
To create connections to Jira, you will need the following:
For instructions on creating any of these, see the Jira documentation.
When creating these credentials, you will need the following information:
-
For OAuth 2:
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion datacenter Redirect URL US https://app.workfrontfusion.com/oauth/cb/workfront-jira2EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2 -
For Personal Access Tokens (PATs):
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion datacenter Redirect URL US https://app.workfrontfusion.com/oauth/cb/workfront-jiraEU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jiraAzure https://app-az.workfrontfusion.com/oauth/cb/workfront-jiranote important IMPORTANT To use a PAT, you must enable the following in the files jira/bin/WEB-INF/classes, in the filejira-config.properties:jira.rest.auth.allow.basic = truejira.rest.csrf.disabled = true
If this file does not exist, you must create it.
Create the connection to Jira in Workfront Fusion
To create the connection in Workfront Fusion:
-
In any Jira module, click Add next to the Connection field.
-
Configure the following fields:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header Connection type Select whether you are creating a basic connection or an OAuth 2 connection. Connection name Enter a name for the new connection. Service URL Enter your Jira instance URL. This is the URL you use to access Jira. Jira account type Select whether you are connecting to Jira Cloud or Jira Data Center. Client ID If you are creating an OAuth 2 connection, enter your Jira Client ID Client Secret If you are creating an OAuth 2 connection, enter your Jira Client Secret Email If you are creating a basic connection to Jira Cloud, enter your email address. API Token If you are creating a basic connection to Jira Cloud, enter your API Token. Personal Access Token If you are creating a basic connection to Jira Data Center, enter your Personal Access Token. API version Select the Jira API version that you want this connection to connect to. -
Click Continue to create the connection and go back to the module.
Jira modules and their fields
When you configure Jira modules, Workfront Fusion displays the fields listed below. Along with these, additional Jira fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.
If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.
Triggers
Watch for records
This trigger module starts a scenario when a record is added, updated, or deleted.
Actions
Add issue to sprint
This action module adds one or more issues to a sprint.
Create a Record
This action module creates a new record in Jira.
Custom API Call
This action module lets you make a custom authenticated call to the Jira API.
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods.
<Instance URL>/rest/api/2/Add the headers of the request in the form of a standard JSON object.
For example, {"Content-type":"application/json"}
Workfront Fusion adds the authorization headers for you.
Add the query for the API call in the form of a standard JSON object.
For example: {"name":"something-urgent"}
Add the body content for the API call in the form of a standard JSON object.
Note:
When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.
Delete a record
This action module deletes the specified record.
Download an attachment
This action module downloads the specified attachment.
Read a record
This action module reads data from the specified record in Jira.
Update a record
This action module updates an existing record, such as an issue or project.
Searches
Search for records
This search module looks for records in an object in Jira that match the search query you specify.
You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.