Wait For Condition step

Pause an action until record values match a specific set of conditions.

Roles and availability

Available as an Workflow Studio action step. Users with the action_designer role can create a custom action with one or more action steps.

Provide a value for each input that your action needs. To add dynamic values, you can also drag and drop pills from the Data panel or select them from the pill picker.

• Record

  Data type: Record

  The record whose field values the step monitors for changes. This record can come from an action input or the output of a previous action step.

  Note: If this record is deleted, the action stops waiting and continues running.

• Table

  Data type: Table Name

  The table associated with the record to monitor. This read-only value is set to the table associated with the record you selected. Confirm that the system supports Wait for Condition for your selected table. For a list of unsupported tables, see the Unsupported tables section.

• Conditions

  Data type: Conditions

  The record values necessary to resume running the action. For example, if the condition is [State] [is] [Closed], the action pauses until the condition is met. Once met, the action moves on to the next action step. Only select conditions that apply to field values in the table to which the record belongs. See Condition evaluation for more information about creating valid conditions.

  Note: For conditions that depend on a specific duration, consider using Wait for a duration flow logic instead.

• Enable Timeout

  Data type: True/False

  Option to limit the amount of time that the action waits for the step to be completed before continuing.

  Note: Use the Enable timeout option to prevent this step from continuing to run indefinitely. If the condition to continue is never met, a timeout value specifies when the system skips the Wait for Condition step and goes to the next step in the action. You must set a Duration value to enable a timeout. You can also select a Schedule if you want to compute the duration end date based on a specific work schedule.

• Duration

  Data type: Duration

  Amount of time that the step waits before continuing when the Enable timeout option is selected. Enter the time to wait in hours, minutes, and seconds. If you leave this field empty, the step does not wait.

• Schedule

  Data type: Choice

  Schedule used to compute the timeout duration when the Enable timeout option is selected. For example, waiting for 10 hours as part of an 8-5 weekdays schedule causes the flow to wait for one or more business days. If you leave this field empty, the timeout runs without a schedule.

Outputs

These outputs appear in the Data panel. You can use them as inputs elsewhere in your flow.

• State

  Data type: Choice

  The completion status of the step as a numeric value.

  • 0 (success)
  • 1 (error)

Condition evaluation

The Wait for Condition step only evaluates the wait condition when there are changes to fields in the Record you select. A valid wait condition meets these criteria.

• Each condition evaluates a field from the table to which the record belongs.

  Note: Don't create conditions that dot-walk to another table or depend upon catalog item variables from a related record.

• Each condition specifies a field value change rather than a relative time period.

  Note: For conditions that depend on a specific duration, consider using Wait for a duration flow logic instead.

Action error evaluation

• If this step fails

  Data type: Choice

  Option to continue running the next step or go to error evaluation. To use the step status code or message for a custom action error condition, see Action error evaluation.

Unsupported tables

The system does not support Wait for Condition for the following tables.

Example

This example action takes n Incident record as an input value. The action waits for the state of the Incident to be resolved and then sends an email message to the incident caller to notify them of the state change.

Parent Topic:Workflow Studio steps