Both sides previous revisionPrevious revisionNext revision | Previous revision |
75:process_feedback_jira [2020/04/09 09:40] – fnpk | 75:process_feedback_jira [2024/02/15 00:00] (current) – external edit 127.0.0.1 |
---|
<!-- The summary field will always be available and is automatically mapped to the Jira "summary" field --> | <!-- The summary field will always be available and is automatically mapped to the Jira "summary" field --> |
| |
<!-- | <!-- |
The user will be asked to enter the following text fields. All text fields are optional. | See common feedback documentation |
- The "ident" must be unique and is used to identify the right translation property. | |
- The "type" defines if the field is a multi-line text ("text") or a single line string ("string"). | |
- The "target" defines the id of the custom field in Jira (e.g. "customfield_10101"). | - The "target" defines the id of the custom field in Jira (e.g. "customfield_10101"). |
- Optional: The targetType defines the type of the Jira field. Supported Jira fields see below. | - Optional: The targetType defines the type of the Jira field. Supported Jira fields see below. |
<attributes> | <attributes> |
<attribute ident="description" type="text" target="description" /> | <attribute ident="description" type="text" target="description" /> |
<!-- The following fields could be enabled if you want the users to provide more data with every feedback item: --> | |
<!-- | |
<attribute ident="annual_savings" type="string" target="customfield_10100" /> | |
<attribute ident="priority" type="string" target="customfield_10101" /> | |
<attribute ident="component" type="string" target="components" targetType="components" /> | |
--> | |
</attributes> | </attributes> |
| |
<!-- | <!-- |
You can map element specify information to your Jira issue. These sources are available: | See common feedback documentation |
- elementUrl e.g. https://stages.example.com/stages/index.html#/workspace/200/_vv/(process/activity/_wUV9sBbNHr-aicWx33VsQA) | |
- workspaceName e.g. "Software Engineering" | |
- workspacePath e.g. "Company | Software" | |
- creatorFullname "John Doe" | |
- creatorUsername "jdoe" | |
The "target" defines the id for the custom field in Jira (e.g. "customfield_10101"). | The "target" defines the id for the custom field in Jira (e.g. "customfield_10101"). |
Optional: The targetType defines the type of the Jira field. Supported Jira fields see below. | Optional: The targetType defines the type of the Jira field. Supported Jira fields see below. |
<attribute source="creatorUsername" target="customfield_10108" /> | <attribute source="creatorUsername" target="customfield_10108" /> |
</system-attribute-mappings> | </system-attribute-mappings> |
| |
| <!-- |
| See common feedback documentation |
| The "target" defines the id for the custom field in Jira (e.g. "customfield_10101"). |
| Optional: The targetType defines the type of the Jira field. Supported Jira fields see below. |
| --> |
| <custom-attribute-mappings> |
| <attribute value="Stages" target="customfield_10200" /> |
| </custom-attribute-mappings> |
</host> | </host> |
</feedback-system> | </feedback-system> |
| |
=== Jira Server === | === Jira Server === |
The ''user'' and ''password'' are the normal username and password of the user. | * The ''user'' and ''password'' are the normal username and password of the user. |
| * [[https://confluence.atlassian.com/enterprise/disabling-basic-authentication-1044776464.html|Basic authentication must not be deactivated]] |
=== Jira Cloud === | === Jira Cloud === |
In Jira cloud there are no usernames. The ''username'' is the mail address (e.g. ''user@example.com''). The **password is a API-Token** and not the password of the user. You can create a Token in your [[https://id.atlassian.com/manage-profile/security/api-tokens|Atlassian Account Management]]. | In Jira cloud there are no usernames. The ''username'' is the mail address (e.g. ''user@example.com''). The **password is a API-Token** and not the password of the user. You can create a Token in your [[https://id.atlassian.com/manage-profile/security/api-tokens|Atlassian Account Management]]. |
| |
==== Supported Jira fields ===== | ==== Supported Jira fields ==== |
* Description: ''targetType=""'' (Empty) | * Description: ''targetType=""'' (Empty) |
* Text Field (single line): ''targetType=""'' (Empty) | * Text Field (single line): ''targetType=""'' (Empty) |
* Select List (single choice): ''targetType="selectList-singleChoice"'' | * Select List (single choice): ''targetType="selectList-singleChoice"'' |
* User Picker (single user): ''targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) | * User Picker (single user): ''targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) |
* Assignee: ''targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) | * Assignee: ''target="assignee" targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) |
* Reporter: ''targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) | * Reporter: ''target="reporter" targetType="user-singleChoice"'' (Only Jira Server, not Jira Cloud) |
* Components: ''targetType="components"'' | * Components: ''target="components" targetType="components"'' |
| |
**Be aware**: | **Be aware**: |
</code> | </code> |
| |
| ==== Troubleshooting ==== |
| |
| If the username/password settings are not correct or the password is changed on the Jira side, but not in Stages, Jira might lock the account after a few tries. This will result in a "HTTP 403 Forbidden" error in stages.log. |
| |
| In that case, the Jira account needs to be unlocked again. Log into Jira as an administrator and follow these steps: |
| * Click on the Gear icon in the upper right of Jira |
| * Select "User Management" |
| * Find the right user |
| * Click on the "Reset Failed Login Count" link in the "Login Details" column. |
| |