Manage workflow activity conditions

Activities contain default conditions that determine which transitions are followed.

Before you begin

Role required: admin

About this task

For example, the Approval - User activity has two conditions, Approved and Rejected.

Figure 1. Example of activity conditions

You can use a JavaScript condition check to create custom conditions on Core workflow activities. Custom activities do not support this feature.

Procedure

  1. Right-click the activity and select Add Condition from the context menu.
  2. In the New Workflow Condition dialog box, fill in the fields as appropriate (see table).
    Table 1. New Workflow Conditions form
    FieldDescription
    Name The label that is displayed on the workflow.
    Activity Name of the activity for which this condition is submitted. This value is populated automatically by the system.
    Short description Brief description of this condition.
    Condition A JavaScript condition check. The following variables are available:
    • current: Current record that the workflow is running against.
    • activity.result: Result value set by the activity upon completion.
    • activity: Workflow Executing Activity (wf_executing) record. Used for advanced condition checks.
    • activity.vars: Variables associated with the Workflow Executing Activity record. Used for advanced condition checks.
    Skip during generate If selected, the Generate activity does not follow this transition to generate approvals or tasks.
  3. Click Submit.
  4. To change the order in which conditions appear on the workflow activity, right-click the activity and select Reorder Conditions.
    A dialog box appears, with a list of the available conditions.
    Figure 2. List of conditions in the current activity
  5. Drag the conditions to a new position in the list.
  6. Click OK.

Activity result value

The result value specified by an activity controls the condition through which the activity transitions.

Use the result value as part of the Condition field in the activity. For example, if the Condition field of an Approval - User activity contains activity.result == 'rejected', the activity transitions through that condition when a rejection is received from the approver. Result values are set in the Script field of the activity definition.