Configure a Condition activity

Use the following procedure to configure a Condition activity for a simplified configuration of a Synchronization activity with branching rules. The paths from the activity properties are added as activities to the process. The destination activities are automatically displayed as you configure the paths.

This activity is only available when configuring a decision tree.

  1. Add an activity to the map. See Add an activity.
  2. Change the default Name of the activity to something meaningful.
  3. On the Type list, select Common > Condition.
  4. Configure the properties for this activity, as required. See Activity properties.

    The After processing tab under Properties is not available for a Condition activity.

  5. Configure the branching rule, add destination nodes, and define their paths in either way.

    Add activities from the Satellite

    1. Select the Condition activity and click the Activity icon on the Satellite.

      An activity is added to the condition activity.

    2. To update the path, do the following:

      1. Double-click the first activity on the Path column or select the activity and click on the header.

        The Edit path dialog box is displayed.

      2. The Activity name is displayed as read-only.

      3. Add a Description for the activity.

      4. Right-click on the rule editor and define a rule using the process/server variable or business data. See Additional information on creating rules for a Condition activity.

      5. Click Validate to validate the rule.

        If the rule is not valid, a message appears stating the branching rule is invalid. Click OK in the error message, correct the expression, and validate.

      6. Click Update.

        The activity description appears on the When column of the Path table.

    3. Similarly, add the other activities to the Condition activity, as needed.

    4. By default, the first activity under the Condition activity appears as the default path. You can change the default path by selecting a different activity on the Default path list.

    5. To delete an activity, select the activity and click on the header.

    6. You can use expressions in decision-making processes to evaluate conditions and determine outcomes. For a decision tree, expressions help define the criteria at each decision node and ensure that decisions follow defined business rules and provide clarity on what actions to take based on varying conditions. You can use math, text, and date, functions in expressions for decision-making to enhance the evaluation process.

      • TotalAgility supports the following operands/keywords for a condition:

        + - * / < > = >= <= <> AND OR != && || true false TRUE FALSE

      • Literal strings automatically support special characters such as \ and ". At runtime, the rules are updated to automatically prefix for the literal strings with @ symbol, but only when required. You can still use a prefix for the literal string with @ symbol, such as @"abc\123" or by escaping the characters, such as "abc\\123".

    7. To validate the expression, click Validate.

    8. Similarly, update the path for other activities, as needed.

    Add activities directly when defining the rule path

    1. Select the Condition activity and click for Path on the Configuration tab.

      The New path dialog box is displayed.

    2. Enter the Activity name.

    3. Enter a Description for the activity.

    4. Right-click on the rule editor and define a rule using the process and server variables. See Additional information on creating rules for a Condition activity.

    5. To validate the rule, click Validate.

      If the rule is not valid, a message appears stating the branching rule is invalid. Click OK in the error message, correct the expression, and validate.

    6. Click Add.

      The activity name appears on the Take path column and the activity description appears on the Description column of the Path table.

    7. Similarly, add the other activities as needed to the Condition activity by defining the path.

  6. By default, the first activity under the Condition activity appears as default path. You can change the default path by selecting a different activity on the Default path list.
  7. To delete an activity, select the activity and click on the header.
  8. Add the end nodes.
  9. Release the Decision tree business rule.

Additional information on creating rules for a Condition activity

When creating a rule for the Condition activity, you can set the value of one or more variables using free text (place the value under quotes), variables, operators, and functions. See Supported variables, Supported operands and keywords, and Supported functions for more information.

You can use expressions in decision-making processes to evaluate conditions and determine outcomes. For a decision tree, expressions help define the criteria at each decision node to ensure that decisions follow defined business rules to take actions based on varying conditions.

Supported variables

See the following table for the variables supported and not supported in a condition.

Supported Not supported
Bool (Boolean) Checklist
Byte Complex
Currency Dynamic complex
Date XML
Decimal XML expression
Double System variables
Float
Long
Nullable date
Nullable string
Short
String
Entity attributes (simple types)

Supported operands and keywords

TotalAgility supports the following operands/keywords for a condition:

+ - * / < > = >= <= <> AND OR != && || true false TRUE FALSE

Literal strings automatically support special characters such as \ and ". At runtime, the rules are updated to prefix the literal strings with @ symbol, but only when required. You can still use a prefix for the literal string with @ symbol, such as @"abc\123" or by escaping the characters, such as "abc\\123".

Supported functions

TotalAgility supports the following functions in a condition.