To exchange data between Collaborator and JIRA, the Collaborator Plugin uses a number of JIRA fields.
To create JIRA tickets, the integration uses Summary, Issue Type and Assignee built-in fields. In order to create new tickets successfully, these built-in fields must be visible on JIRA screens that you use to create and update issues. These fields are visible by default.
To update information about current review status and list of review participants, the integration creates a number of custom fields - Review Id, Review Link, Review Participants and Review Phase.
To be able to update the review status and participants, these custom fields must be visible on JIRA screens that you use to create and update issues. These fields are hidden by default.
Typically the "Default screen" is used both for creating and updating issues in JIRA, however this may vary depending on your JIRA configuration.
If some of required JIRA fields are hidden, Collaborator will display the "Field <name> cannot be set" error.
To configure the fields:
-
Log in to JIRA as an administrator.
-
Go to JIRA Administration > Issues.
Click the image to enlarge it.
-
Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
-
Select the desired field configuration and click the Configure link.
-
In the ensuing View Field Configuration page locate the following fields:
- Summary
- Issue Type
- Assignee
- Review Id
- Review Link
- Review Participants
- Review Phase
-
Make sure these fields are visible in current configuration. To display a field that is currently hidden, click Show link next to its name.
You have prepared your JIRA server for integration with Collaborator. You will also need to change certain settings on the Collaborator server.