Versions Compared

Key

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


Page properties
hiddentrue


StatusTech review

Status
colourYellowGreen
titleReady for reviewdone

Style guide

Status
colourYellowGreen
titleReady for reviewdone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Panel

On this page

Table of Contents
maxLevel2
exclude(On this page|Get to know Automation rules).*
stylecircle
typeflat
separatorpipe

Page properties
hiddentrue
Status
Tech review

Status
titletodo

Style guide

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
StatuscolourRedtitle

flagged



UI Text Box
sizemedium
typeinfo

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.

Image Removed


5 steps to create

First steps of creating a rule

UI Steps


UI Step

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


UI Step

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


UI Step

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


UI Step

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


UI Step

Excerpt Include
DECADIS:Automation Use Case - Activate Enable Rule Step
DECADIS:Automation Use Case - Activate Enable Rule Step
nopaneltrue



Get to know automation rules

The basic elements of an automation rule

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


UI Expand
titleExample of creating a rule


UI Steps


UI Step

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

Image Added Image Removed


UI Step

Image Modified

 Configure

 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.


UI Steps


UI Step

Field

*

Choose Priority


UI Step

Changed to

*

Choose Selected value


UI Step

Value

*

Choose Highest


UI Step

Click Save




UI Step

Image Modified

Configure

 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.

UI Steps


UI Step

Comment text

*

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

Cheers!



UI Step

Click Add




UI Step

Excerpt Include
DECADIS:Automation Use Case - Activate Enable Rule Step
DECADIS:Automation Use Case - Activate Enable Rule Step
nopaneltrue





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 deactivate disable the rule first.

By toggling the status button of a rule you can activate or deactivate it.

UI Text Box
typeinfo

Disable

Deactivate

the rule by clicking on the

Deactivate

Disable button Image Modified

Image Removed

 → Image Added. Learn more about rule statuses.


A rule can have different statuses. By toggling the status button of a rule, the rule can be activated, deactivated or executed.

Each status has implications on the available actions and additionally provides information about potential configuration errors.

The following statuses are currently available:

UI Expand
titleList of all rule statuses
StatusDescription

Image Removed

The rule is currently inactive and can be edited or activated.

Image Removed

The rule is active and cannot be edited.
UI Expand
titleEdit rule's the name and its description

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

Image RemovedImage Added


UI Expand
titleAdd a new element

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. New screenshot

Image Added

Image Removed

UI Text Box
typetip

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.



UI Expand
titleDelete an element

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

New screenshot

Image RemovedImage Added

UI Text Box
typewarning

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



UI Expand
titleElement hierarchy

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

New screenshots and 2 examples of child elements

Image Removed

Rule Statuses

After editing your rule, you will notice on of the following statuses:

UI Expand
titleList of all rule statuses

A rule can have different statuses. By toggling the status button of a rule, the rule can be activated, deactivated or executed.

Image Added



Anchor
ui-hacks
ui-hacks

Useful UI hacks

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

UI Expand
title

Each status has implications on the available actions and additionally provides information about potential configuration errors.

The following statuses are currently available:

StatusDescription

Image Removed

The rule is currently inactive and can be edited or activated.

Image Removed

The rule is active and cannot be edited.

Image Removed

The rule is deactivated and cannot be activated due to missing actions.

UI Text Box
typenote

Each rule must have at least one action configured to be activated.

Image Removed

The rule is deactivated and cannot be activated due to errors in the rule (e.g. a selector was configured that is not available in this context.

Image Removed

The rule is a manual rule and can be executed by clicking on this button. the button

Image Removed

The rule is a manual rule and cannot be activated due to missing actions.

UI Text Box
typenote

Each manual rule must have at least one action configured to be activated.

Image Removed

The rule is a manual rule and cannot be activated due to errors in the rule (e.g. a selector was configured that is not available in this context).

Useful UI hacks

info
UI Expand
List of UI hacks
titleReorder elements using drag and drop
UI Text Box
typenote

All elements except triggers can be moved.

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.

Multimedia
namedragndrop-rule-entity.mp4
width700

Expand and compress


UI Text Box
sizemedium
type
typenote

All elements except triggers can be moved.



info

UI Expand
titleExpand and collapse elements

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

Multimedia
nameexpand-compress-rule-entity.mp4
width700
autostarttrue

UI Text Box
sizemedium
type

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.

Multimedia
nameexpand-compress-sidebar.mp4
width700
autostarttrue



Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue

...