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.

Table Category	Table Names
Audit	Sys Audit [sys_audit], Audit Deleted Record [sys_audit_delete], Audit Relationship Change [sys_audit_relation], Audit Roles [sys_audit_role], Audit Relationship Change [sys_audit_relation], Audit Deleted Record [sys_audit_delete]
Email	Email [sys_email], Email Account [sys_email_account], Email Log [sys_email_log]
Events	Event [sysevent], Notification [sysevent_email_action], Stationery [sysevent_email_style], Email Template [sysevent_email_template], Inbound Email Actions [sysevent_in_email_action], Slow Event [sysevent_pattern], Event Registration [sysevent_registration], Script Action [sysevent_script_action]
Import Sets	Import Set [sys_import_set], Import Set Row [sys_import_set_row], Import Set Row Error [sys_import_set_row_error], Transform History [sys_import_set_run], Computer [imp_computer], Notification [imp_notification], Location [imp_location], User [imp_user]
JRobin	JRobin Database [jrobin_database], JRobin Shard [jrobin_shard], Graph Line [jrobin_graph_line], JRobin Shard Fragments [jrobin_shard_location], Member [jrobin_graph_set_member], Round Robin Archive [jrobin_archive], Round Robin Data Source [jrobin_datasource], Round Robin Definition [jrobin_definition], Round Robin Graph [jrobin_graph], Round Robin Graph Set [jrobin_graph_set]
Logs	Log Entry [syslog], Service Portal Log Entry [sp_log]
MID Server	MID Server Property [ecc_agent_property], Mid Server Log [ecc_agent_log], Queue [ecc_queue], Configuration [ecc_queue_config], ECC Queue Statistics (by ECC Agent) [ecc_queue_stats_by_ecc_agent]
Performance Analytics	Job Log [pa_job_logs]
Record Watcher	Responders [sys_rw_action], Channel Responders [sys_rw_amb_action]
Reporting	Summary Set [sys_report_summary], Report Summary Line [sys_report_summary_line]
Scheduled Jobs	Schedule Item [sys_trigger], Broadcast Message [sys_broadcast_message], Broadcast Message Relationships [sys_broadcast_message_m2m], Progress Worker [sys_progress_worker], Progress Worker Domain [sys_progress_worker_domain]
SSO	SSO Properties [sso_properties], Digest Token Properties [digest_properties], SAML Update 1 Properties [saml2_update1_properties], SSO Federation [sso_federation]
System Cache	Cache Flush [sys_cache_flush], Cache Entry [sys_db_cache]
System Clone	ServiceNow Instance [instance], Clone Security Token [clone_token], Preserved Data [clone_preserved_data]
System Dictionary	Dictionary Entry Override [sys_dictionary_override]
System Events	Event Processor [sys_event_processor]
System Fields	Field Class [sys_glide_object]
System Performance	Component Status [sys_status], Cluster Message [sys_cluster_message], Node State [sys_cluster_state]
Text Index	Ts Attachment [ts_attachment], Text Index Attribute Map [ts_attribute_map], Ts Chain [ts_chain], Chain Summary [ts_chain_summary], Text Index Column Attribute Map [ts_column_attribute_map], Text Index Configuration [ts_configuration], Text Index Configuration Attribute [ts_configuration_attribute], Ts Delete Doc [ts_deleted_doc], Ts Document [ts_document], Ts Field [ts_field], Text Search Groups [ts_group], Japanese User Token [ts_japanese_token_dictionary], Ts Phrase [ts_phrase], Global Searches [ts_query], Knowledge Searches [ts_query_kb], Text Search Stat [ts_search_stats], Text Search Summaries [ts_search_summary], Stop Word [ts_stop], Synonym Dictionary [ts_synonym_dictionary], Synonym Set [ts_synonym_set], Text Search Table [ts_table], Text Index Table Attribute Map [ts_table_attribute_map], Service Catalog Searches [sc_ts_query], Ts Word [ts_word], Ts Word Roots [ts_word_roots]
Update Sets	Update Set [sys_update_set], Update Version [sys_update_version], Customer Update [sys_update_xml], Update Set Log [sys_update_set_log]
Upgrades	System Upgrades [sys_upgrade_history], Upgrade Details [sys_upgrade_history_log], System Upgrade Metric [sys_upgrade_metric], Upgrade Blame Log [sys_upgrade_blame], Upgrade Manifest [sys_upgrade_manifest], Upgrade State [sys_upgrade_state]
Usage Analytics	Usage Data for Applications [ua_app_usage], UsageAnalytics Count Configurations [usageanalytics_count_cfg], Application Metadata [ua_app_metadata], UsageAnalytics Count for Tables [usageanalytics_count], Subscription [license_details], Role for Subscription [role_has_license]
Users	User Session [sys_user_session], User Token [sys_user_token], User Preference [sys_user_preference], Navigator History [sys_ui_navigator_history]
Workflow	Workflow Execution [wf_workflow_execution], Workflow History [wf_history], Workflow Executing Activity [wf_executing], Workflow Queued Command [wf_command], Workflow Context [wf_context], Workflow Transition History [wf_transition_history]

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.