Overview

"Automation for Jira" app by Atlassian is now part of Jira Software Data Center 9.0 and Jira Service Management Data Center 5.0. Jira Server/DC now provides built-in automation capabilities allowing easy implementation of automated Jira processes and workflows.

This way, users can implement rules that are triggered by an event, execute if a certain condition(s) are met, and perform a certain action(s). 

Rules can also be triggered manually or may be scheduled.

Since Xray uses issue types for most of its entities, you can use it to implement some rules related to Xray.


Automation rules are available and, can be created, from the project settings, namely from the "Project Automation" tab.




This document highlights some examples around triggering test automation but you may implement other automation rules related to your processes.


Please note

The following examples are provided as-is, no warranties attached; use them carefully.

Please feel free to adapt them to your needs. 

Note: We don't provide support for Jira Server/DC Automation capabilities; if you have doubts concerning its usage, please contact Atlassian. If you have specific needs related to Xray, feel free to reach out Xray support and share them with us.


Concepts

Jira Automation allows project administrators to implement rules to automate certain processes, guaranteeing efficiency and consistency.

The main concepts of Jira Automation follow a very simple approach for defining an automation rule: if a certain "thing" happens (trigger) and certain conditions are met, then execute one or more actions.

  • Trigger: Triggers start the execution of a rule. Triggers can listen for events or be scheduled to run.
    • manual
    • upon field or workflow status changes 
    • upon releasing
    • periodic
    • ...
  • Condition: Actions will only execute if all conditions preceding them pass.
    • "If" statement
    • Issue fields condition
    • ...
  • Action: Actions perform changes to a system. 
    • change fields on issues
    • transition issues
    • web request
    • log
    • ...


It's also possible to run actions on issues that are related to the issue that triggered the rule, using "branches".


Please note

Automation rules run asynchronously.  Some actions can run in parallel but usually they're sequential. There is no interaction with the user (except if the trigger was set off manually from Jira's UI).

Usage Examples

Tips

Accessing network-restricted CI/CD tools

If your target system is behind a firewall or it's a local IP address, you can use ngrok tool to create a temporary tunnel to it. Please check with your IT/security team(s).


Accessing audit log of Jira automation

If you wan to have more information about the rule execution you can click on the project settings and then in to "Project Automation" tab.

This will take us to the Automation rule list page where we can click over one of the rules.

This action opens the details page where we can access the Audit log of that rule.


This option will load all the actions performed on the rule, and if we press the "Show more" option, we can see more details.


  • No labels