Categories

Conditionals

Define reusable logical rules to control system behavior based on field values.
published

Conditionals

Conditionals are elements used to control the system's behavior based on defined parameters.
They are essential for making executions more dynamic and personalized.

Scope of Conditionals

Conditionals are created within types, and can only be used within the type in which they were defined.
This ensures organization and logic isolation between different areas of the system.

How to Create a Conditional

To create a conditional, the following required fields must be filled in:

  • Name: Identification of the conditional.
  • Description: Brief explanation of the purpose of the conditional.
  • Reference Field: Field or parameter that will be evaluated in the conditional.
  • Condition: Type of comparison that will be applied.

Dynamic Target Value

In the conditional creation modal, the Target Value field automatically adapts to the selected Reference Field type.

  • If the reference field is a list/select field, Target Value shows a dropdown with that field's options.
  • If it is a free-text field, Target Value shows a text input.
  • For date, number, or boolean fields, the system displays the appropriate control for each type.

This behavior reduces configuration errors and follows the same filter pattern used in item and task screens.

Nested References (Group)

In the form block conditional builder, the reference values list is no longer flat; it is now nested.

This allows you to select subfields inside Group fields as conditional references.

Previously, conditionals could only reference top-level fields, which often required creating helper fields outside the original structure.

Now, configurators can navigate the field structure and select the desired subfield directly, reducing redundancy and simplifying modeling.

Conditional Options:

  1. Contains: Checks if the field value includes a certain value.
  2. Different: Checks if the field value is different from a certain value.
  3. Equal: Checks if the field value is equal to a certain value.
  4. Greater than or equal to: Checks if the field value is greater than or equal to a certain value (numeric).
  5. Greater than: Checks if the field value is greater than a certain value (numeric).
  6. Less than or equal to: Checks if the field value is less than or equal to a certain value (numeric).
  7. Less than: Checks if the field value is less than a certain value (numeric).

Example:

  • Reference Field: Order status
  • Condition: Equal
  • Value: Approved
  • The conditional will be considered true only when the order status is exactly "Approved".

Where Conditionals Can Be Used

Conditionals can be applied in various parts of the system, such as:

This flexibility allows the creation of smart flows that respond to specific criteria according to business needs.