Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 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

  • Default URL pattern is /browse/{JIRA_CHANGE_NUMBER}

  • The URL should include {JIRA_CHANGE_NUMBER} string as the execution system will replace it with the actual change number during execution

Jira GET Rest API Pattern

FDJIRAITSM_TICKET_REST_GET_PATTERN

Yes

Jira Rest API URL Pattern for a GET request

  • Default URL is /rest/api/2/issue/{JIRA_CHANGE_NUMBER}

  • If needed, you can change and use your custom GET URL pattern for Jira ITSM REST endpoint.  The URL should include {JIRA_CHANGE_NUMBER} string as the execution system will replace it with the actual change number during execution.

Jira POST Rest API Pattern

FDJIRAITSM_TICKET_REST_POST_PATTERN

Yes

Jira Rest API URL pattern for creating a change ticket

  • Default URL pattern is /rest/api/2/issue

  • If needed, you can change and use your custom URL to create a new change using the POST operation

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:

  • TICKET - an object with fields (JSON) contained in the change ticket, as returned by the Jira ITSM REST API.  Fields are referenced as TICKET.<field name>.<sub-field name>

  • FD_ENVIRONMENT_CODE - The environment for a particular deployment request or associated pipeline stage.

Info

If the Approved Check Script is left blank, the default implementation checks the status of the ticket to determine if it's approved. Statuses of awaiting implementation, implementing, and completed are considered approved and return true.

Default Check
Code Block
languagegroovy
TICKET.fields.status.name == 'Awaiting implementation' || TICKET.fields.status.name == 'Implementing' || TICKET.fields.status.name == 'Completed'
Example that checks custom field value specific to target environment
Code Block
languagegroovy
(TICKET.fields.customfield_10107.status == 'UATApproved' && FD_ENVIRONMENT_CODE='UAT') || (TICKET.fields.customfield_10107.status == 'PRODApproved' && FD_ENVIRONMENT_CODE='PROD')
Info

If you want to see values that can be used, enable FINEST log level for flexagon.fd.model.integration.cms.CMSScript using Admin Operations.

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:

  • TICKET - an object with fields (JSON) contained in the change ticket, as returned by the Jira ITSM REST API.  Fields are referenced as TICKET.<field name>.<sub-field name>

  • FD_ENVIRONMENT_CODE - The environment for a particular deployment request or associated pipeline stage.

Info

If the Rejected Check Script is left blank, the default implementation checks the status of the ticket to determine if it's rejected. Statuses of declined, canceled, and failed are considered rejected and return true.

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:

  • TICKET - an object with fields (JSON) contained in the change ticket, as returned by the ServiceNow REST API.  Fields are referenced as TICKET.<field name>.<sub-field name>

  • FD_ENVIRONMENT_CODE - The environment for a particular deployment request or associated pipeline stage.

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 Ticket Fields

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 Issues with your project builds. See Configure Project for Issue Tracking for more details.

Work Item pattern is optional if you plan to prefix work item numbers in commit message with #. If specific, this will used to parse source code commit logs for JIRA Issues.