Tech review

Style guide

 graphic



On this page





Status
Tech review

Style guide



A very basic rule only consists of two elements: a trigger (mostly a Jira event like an issue update) that kicks off the rule and an action (like adding a comment) that will be performed automatically.

Optionally you can further refine your rule by configuring selectors and conditions.


First steps of creating a rule


Create a new rule and give it a unique name and a description (optional).


Choose the trigger your rule should listen to. The dialogue opens automatically since every rule starts with a trigger.


Optional: if you want to further refine your rule add selectors and/or conditions.


Add the action you want to add and configure it according to your needs.




The basic elements of an automation rule

Learn more about triggers, selectors, conditions, actions and their configuration.




Create a new rule and give it a unique name and a description (optional).



 Configure the trigger

Since we want to add a comment when the priority of an issue is updated we need the trigger to listen to the Field Changed Event.



Field*

Choose Priority


Changed to*

Choose Selected value


Value*

Choose Highest


Click Save





 Configure the action

Since we want to automatically add a comment to all issues we need to choose the Add Comment action.

In this example we just leave a generic plain text comment.


Comment text* 

The priority on this issue has changed to Highest. You receive this notification as a watcher of this issue. 

Cheers!



Click Add








Edit a rule

Once you have created a rule, you can edit its name, its description and its elements.

The name and description can be updated at any time. If you want to update any configuration element you need to disable the rule first.

Disable the rule by clicking on the Disable button  → . Learn more about rule statuses.


Click on the edit button next to the rule's name to edit its name and its description.


Click on the add button next to any desired element to add a new one. The button will be visible once you hover over an element.

If you click on the add button next to the condition you would have a nested condition.

You cannot add further elements to an action.



Click on the delete button next to the element you want to delete from the rule.

If you delete an element, all its nested elements will be deleted too.



You can add elements under or next to existing elements. JWT will respect the hierarchy and the order of elements when processing the rule.



Useful UI hacks

Check out these fine little hacks that will make your life easier when working with rules.

When you hover over an element's name, you will notice the arrow cross symbol. This means that the element is available for drag and drop (meaning it can be moved within the rule).

When starting to drag an element by clicking and holding the left mouse button, valid drop targets are marked with a + symbol.


All elements except triggers can be moved.



Click on an element to collapse or expand it and all its nested elements.

The sidebar can be completely expanded by clicking on the expand icon in the upper right-hand corner of the sidebar for a smooth item configuration.