Triggers

Triggers in the ARNR app are essential components that initiate the execution of rules and their associated actions. They serve as the starting point for automated processes, allowing users to define specific conditions under which certain rule and its actions should be executed. The app currently supports various types of triggers, enabling flexibility and customization in how users can automate their workflows. By utilizing triggers, users can streamline tasks and enhance efficiency within the application. Overall, triggers play a crucial role in the functionality and usability of the ARNR app.

Below are the different triggers that are available in the ARNR rules.

Manual

Rules with this trigger can only be invoked manually. The simple use case that it addresses is when we want to generate release notes on an ad-hoc basis.

Manual rule.png

Steps to trigger rule manually

When the trigger is set to Manual, you can trigger/execute it using image-20241121-095110.png button available on the rules listing page or rule’s detail page. Refer to the below screenshot.

manual.png

If image-20241121-095119.png button is not available for a manually triggered rule, that means there are no actions defined within the rule or that the rule is disabled.

Clicking on image-20241121-095124.png opens the pop-up that expects input/s from the end user. Once the input/s is/are provided & user clicks on Ok all the actions within the manual rule will be executed. This is what the input selector pop-up looks like. If no inputs are needed, a message to that effect will be displayed in the pop-up.

Version created

This trigger is used to automate your release notes & reports when a new version is created in Jira. To make this possible, your template should have variables like [versionId] and/or [versionName]. As soon as a new version is created in the given Jira project, rules that have this trigger will get executed, and based on the actions in the rule, the relevant template will be executed to fetch the content from Jira.

You can also user the regular expression for conditional rule execution. The rule will be executed only for those versions whose name matches the regular expression filter, others will be skipped. If unchecked, rule will be executed for all versions that are created in Jira.

What type of regular expressions are allowed - Free Online Java Regular Expression Tester - FreeFormatter.com

Version released

Version id/name is the input parameter for this trigger. But this parameter is passed from the Jira version release action to the ARNR rule. Thus as soon as a version is released in Jira, rules that have this trigger will be executed. 

You can also user the regular expression for conditional rule execution. The rule will be executed only for those versions whose name matches the regular expression filter, others will be skipped. If unchecked, rule will be executed for all versions that are created in Jira.

What type of regular expressions are allowed - Free Online Java Regular Expression Tester - FreeFormatter.com

Scheduled before N days of release

If certain rules are needed to be executed before the planned release date on a recurring frequency, schedule them using this trigger. For a scheduled trigger, the system expects the number of days parameter from you. The idea is to send pre-release emails e.g. send pre-release notes 4 days before the planned release date or 10 days before the release date etc. The planned release date is picked up from Versions defined in your Jira project.

Additionally, you can also configure the timezone & time on which this trigger should run on the given day.

You can also user the regular expression for conditional rule execution. The rule will be executed only for those versions whose name matches the regular expression filter, others will be skipped. If unchecked, rule will be executed for all versions that are created in Jira.

What type of regular expressions are allowed - Free Online Java Regular Expression Tester - FreeFormatter.com

Scheduled at interval

It is possible to execute rules at regular intervals with the help of this trigger. Simply provide a cron expression & timezone as input. Do keep in mind that no version is passed to the actions within this rule when the rule is executed. Thus, for such a rule - ideally, all of the actions should have templates where version input variable/s (i.e. versionId, versionName, versionDesc, etc) are not used at all.

You can use this helper tool to customize the cron expression to meet your needs

 

Sprint started

Sprint completed

Webhook