Using the Conditional Threshold block

Use the Conditional Threshold block in workflows when you want actions to be completed when the threshold is reached and when the threshold isn't reached.

Creating the workflow

1. From the menu, click Configuration > Workflows. Select a module, for example, Assets.
2. Click Add (+). The Begin and End blocks are automatically added to the canvas.
3. Enter the name and a description of the workflow. 

Editing the Begin block

Specify the criteria needed to trigger the workflow in the Begin block.

1. Edit the Begin block
2. Add rules to trigger the workflow, for example:
   1. The Actions dropdown is set to Schedule
   2. The Barcode field is not Empty
3. Click Save.

Adding the Conditional Threshold block

1. Click Blocks, and drag and drop the Conditional Threshold block onto the canvas.
2. Click Edit.

Basic Mode

The Conditional Threshold block opens in Basic Mode. 

In Basic Mode you can do the following:

1. Enter a meaningful name for the block.
2. Select a field to compare against, such as Barcode
3. Select an Operator such as Equals.
4. From the Compare to list, select Field or Value
   1. If you selected Field, enter the field you wish to compare it against.
   2. If you selected Value, enter the threshold Value in text format. This field does not support Jinja syntax.
5. Click SAVE.

If you wish to specify multiple conditions or create a more complex query, click Advanced Mode.

Advanced Mode 

In Advanced Mode you can do the following:

1. Enter a meaningful name for the block.
2. Enter a logical expression using Jinja syntax following the examples provided below. When entering your expression make sure that:
   1. The logical expression appears on one line
   2. The syntax is correct
   3. The field name is correct. Tip: Click Add Metadata  to verify the field name. Even though a field is renamed, it will still follow the old naming convention, that is, the barcode could be oomnitza_barcode. 

Important
You cannot switch from Advanced Mode to Basic Mode once you have entered a Jinja expression. 

Examples

{% if barcode == "LX008888" %}True{% else %}False{% endif %}
{% if barcode|length > 1 %}True{% else %}False{% endif %}
{% if barcode|length > 1 or barcode == "LX008888" %}True{% else %}False{% endif %}
{% if barcode.endswith("8") %}True{% else %}False{% endif %}

Connecting the block

Add another block onto the canvas that will run if the condition is True. In the example below, an update block is added to update the barcode starting with "LX". 

1. Click Blocks, and drag and drop the Update block onto the canvas.
2. Click Edit.
3. Click Add field and select the Barcode field from the list.
4. Enter a value or Jinja syntax.
5. Click Save.

Launching the workflow

1. Connect the blocks. 
2. Validate the workflow and Activate it, so that the workflow is live in your system.
3. Click Run Scheduled Workflow
4. Click Run Logs .
5. Your workflow should appear in the latest run log. If the logical expression used is invalid, the conditional threshold block fails with the error: Unable to execute provided logical expressions. Follow the tips and examples above to update your expression.
6. When your workflow is successful, navigate to a record. In the example below, the asset records with barcodes starting with "LX" are updated as per the requirements specified in the Update block.

Documentation

Using Jinja operations in workflows

Jinja:Template Designer Documentation

ShellHacks:Jinja2

Jinja2: Live parser