Table of Contents

Defining conditions in the condition builder


Only available versions of this content are shown in the dropdown
Applicable to Theme Cosmos applications

Use the condition builder to create conditions that define the behavior of your application, or to use for propositions evaluated by a proposition filter. You can save custom conditions to the condition library for future use.

  • If you want to use a configuration as a value to compare at run time to specify application behavior, create a configuration. For more information, see Creating configurations.
  • If you want to evaluate an answer to a question at run time, create the question. For more information, see Adding a question to a question page.
  • If you want to use a prediction to evaluate at run time, create and configure the prediction for case management. For more information, see Predicting case outcomes.
  • If you want to reuse a When condition as a value to compare at run time, mark the When condition as a relevant record. For more information, see Marking records as relevant records.
  1. In App Studio, navigate to a condition builder that defines the application element that you want to edit.

    The condition builder for refreshing a layout is on the configuration pane of that layout. For more information, see Defining refresh conditions for UI areas.
  2. Optional:

    For proposition filters, to remove all previously added criteria from the condition builder, click Actions Clear all criteria .

  3. In the Configure condition section, in the list of values, select a value to evaluate:

    • To select a configuration that defines application behavior at run time, click Configurations, and then select the configuration from a configuration set.
    • To select a field from a data model in your application, click Fields, and then select the field.
    • To select a question to evaluate the answer at run time, click Questions, and then select the question.
    • To select a prediction, click Predictions, and then select the prediction.
    • To select a when condition from your application, click When conditions, and then select the condition.

      To view the logic of the When condition that you want to use, click Preview this condition, as in the following figure:
      Previewing a condition
  4. In the comparator list, select a comparator.

  5. In the value field, enter or select a value that your application compares with the field in the data model or a when condition.

    Status work is equal to Done
  6. Optional:

    To add more conditions, click the Add a row icon, and then repeat steps 3 through 5.

  7. If you add multiple conditions, between the rows, select the and or or operator to define how to evaluate the conditions.

    You can group conditions using the and or or operators.
    If you select and, the condition evaluates to true when all of the rows evaluate to true. If you select or, the condition evaluates to true if at least one of the rows evaluates to true.
  8. In the list in the upper-right of the page, select one of the following options to specify how to evaluate condition groupings:

    • To evaluate the conditions that are linked with the AND operator as a group, and to evaluate the conditions that are linked with the OR operator individually, click Group ANDs.

      With this grouping, the grouping of condition 1 AND condition 2 OR condition 3 OR condition 4 is evaluated as (1 AND 2) OR 3 OR 4. That is, either conditions 1 and 2 must both be true, or either one of conditions 3 and 4 must be true.

    • Group ORs - Select this option if you want conditions linked with the OR operator to be evaluated as a group, and conditions linked with the AND operator to be evaluated individually.

      With this grouping, the grouping of condition 1 AND condition 2 OR condition 3 OR condition 4 is evaluated as 1 AND (2 OR 3 OR 4). That is, both condition 1 and one of conditions 2, 3, and 4 must be true.

    • To define a grouping by both the AND and OR operators, click Use advanced logic, and then specify the condition grouping in the Logic string field.
      If you change a condition that uses advanced logic for the Group ANDs or Group ORs, all the groupings that you previously defined are reset.
    Conditions that are evaluated as a group are displayed on a single block of gray background, so that you can identify them more easily.
  9. Optional:

    To reuse the condition in the future, save the condition to the library:

    • For conditions in a workflow, click More Add to when condition library .
    • For conditions in a proposition filter, click Actions Save to library .
      The Save to library option is not available if the conditions include either Strategy rules or when conditions with parameters. The option is also disabled for proposition filters which include default criteria that are created using the Use advanced logic option.
    The conditions are saved to a new when rule in the top level class of the proposition filter. The system automatically registers the when rule as a relevant record for use in the condition builder.

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.