Note

The documentation you're currently reading is for version 2.9dev. Click here to view documentation for the latest stable version.

Expressions

Expressions can be employed almost anywhere in the workflow definition, from assigning value to action input, to evaluating criteria in the task transition, and data transformation when publishing variables.

Here are some of the things that an expression can accomplish:

  • Select key-value pairs from a list of dictionaries.
  • Filter the list where one or more fields match condition(s).
  • Transform a list to dictionary or vice versa.
  • Simple arithmetic.
  • Evaluation of boolean logic.
  • Any combination of select, filter, transform, and evaluate.

Applied to workflows, here are some use cases:

  • Define input values to action execution.
  • Define criteria for task transition.
  • Publish variables to the runtime context on task completion.
  • Reference variables from the runtime context.
  • Define output values for workflow.

Types

Orchestra currently supports YAQL and Jinja expressions. Both types of expressions can be used throughout the workflow. Note that mixing of both YAQL and Jinja expressions in a single statement is not supported. To tell Orchestra which expression is which, each type of expression should be encapsulated with different symbols. For YAQL, the expression is wrapped in between <% YAQL expression %>. For Jinja, expression is wrapped in between {{ Jinja expression }}. Code block using {% %} is also supported for Jinja. The symbols { and } conflict with JSON and the entire Jinja expression with the encapsulation should be single or double quoted.

Where it’s used?

The following are attributes in the Workflow model that accept expressions:

Attributes Accept Expressions
version No
description No
input Yes, at each item
vars Yes, at each item
tasks See Task
output Yes, at each item

The following are attributes in the Task model that accept expressions:

Attributes Accept Expressions
join No
action Yes
input Yes, entire dict or at each item
next See Task Transition

The following are attributes in the Task Transition model that accept expressions:

Attributes Accept Expressions
when Yes
publish Yes, at each item
do No

Usage

The following sections go into more details on specific topics.