...
After configuring this user in Jira ITSM, go to FlexDeploy and create a Jira ITSM instance to start using the integration.
...
Create Issue Tracking Instance
...
Property Name | Property Code | Required | Description | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Jira URL | FDJIRAITSM_URL | Yes | Jira URL (http://myjira.atlassian.net) | ||||||||||||||
Jira User | FDJIRAITSM_USER_NAME | Yes | Jira User Name | ||||||||||||||
Jira Auth Type | FDJIRAITSM_AUTH_TYPE | No | @since 7.0.0.12 Authentication method for connecting to Jira. Defaults to BasicAuth. Useful for connecting to On-premise instances of Jira where basic authentication will not work with username and password or API token alike. In those cases authentication type must be set to the BearerToken and API token provided. If AuthType is BearerToken, then | ||||||||||||||
Jira API Token | FDJIRAITSM_API_TOKEN | Yes | API token for Jira Note that encrypted properties are stored in Credential Store (Local or External) and can be configured using Edit button next to credential name drop down. Alternatively, you can reuse single credential for multiple properties also, in which case you should name that credential appropriately. | ||||||||||||||
Jira Ticket URL Pattern | FDJIRAITSM_TICKET_URL_PATTERN | Yes | The URL to open Jira ITSM and navigate to the change ticket associated to the project workflow execution
| ||||||||||||||
Jira GET Rest API Pattern | FDJIRAITSM_TICKET_REST_GET_PATTERN | Yes | Jira Rest API URL Pattern for a GET request
| ||||||||||||||
Jira POST Rest API Pattern | FDJIRAITSM_TICKET_REST_POST_PATTERN | Yes | Jira Rest API URL pattern for creating a change ticket
| ||||||||||||||
Approved Check Script | FDJIRAITSM_APPROVED_SCRIPT | No | A Groovy expressions which determines whether a task for the change ticket is approved or not. The expression must return a boolean, and has access to the following variables:
Default Check
Example that checks custom field value specific to target environment
| ||||||||||||||
Rejected Check Script | FDJIRAITSM_REJECTED_SCRIPT | No | A Groovy expressions which determines whether a task for a change ticket is rejected or not. The expression must return a boolean, and as has access to the following variables:
| ||||||||||||||
Additional Info Script | FDJIRAITSM_ADDITIONAL_INFO_SCRIPT | No | A Groovy expression which determines additional information to add to an external approval when it is approved or rejected. The expression must return a Map<String, String> and have an entry with the key of "notes" for the value to get added to external approval as a task note. Script has access to the following variables:
| ||||||||||||||
Don't poll | FDJIRAITSM_DONT_POLL | No | Disable automatic polling (every minute) of Jira tickets for status changes. The default value is false, which means polling will occur. Only check this box if you are using the FlexDeploy REST API to communicate ticket approval/rejection. |
...
Jira ITSM
...
Available TICKET Variables
Within the script properties on the Jira ITSM Instance. The following values are available to you via the TICKET object to use in your script logic. For example, TICKET.project.summary would return the summary of the ITSM change.
Field Code | Display Name | Description | Data Type | Required |
---|---|---|---|---|
fields.summary | Summary | Summary of the change | String | Yes |
fields.project.key | Project Key | Key of project the change is in | String | Yes |
fields.issuetype.name | Issue Type | Type of issue for ticket | String | Yes |
fields.description | Description | Description for the change | String | No |
fields.priority.name | Priority | Priority of the change | String | No |
Configure Folder for Change Management Approvals
Configure JIRA ITSM Change Management Instance on your parent folder. Change management configurations are inherited by sub-folder and projects. This configuration will allow you to integrate Jira ITSM tickets with your FlexDeploy deployment. See Configure Change Management on Folders for more details.
Linking Jira ITSM with FlexDeploy Deployments
If Auto Create Ticket, is not enabled, then user must specific the change ticket number on the deployment request. See Link Change Ticket(s) with Deployments . Otherwise, Change Ticket field will be required in the deployment request form. When change ticket number is passed the ticket number is validated on the external application.