:REPLACE_STRUCTURE

Use the :REPLACE_STRUCTURE script statement to replace the entire content of a Workflow with the content of another Workflow at activation, including all defined task properties. The script statement lets you activate an alternative Workflow structure without modifying the original Workflow. The modification only applies to the current execution.

Tips: 

• Open the Workflow monitor to see the actual Workflow content that is executed.
• If possible, use scheduling options instead of :REPLACE_STRUCTURE.
  More information:
  • Calendars (CALE)
  • Best Practices: Planning Scheduled Tasks
  • Time & Dependencies
  • Conditions, Preconditions, Postconditions

Syntax

:REPLACE_STRUCTURE OBJ[ECT]=Workflow

Parameters

• REPLACE_STRUCTURE
  Replaces content of the Workflow with the content from another Workflow

• Workflow
  Name of the Workflow to obtain content from
  Format: script literal or script variable

Important! A runtime error occurs if the specified Workflow cannot be found.

Example

A Workflow that is called MM.DAY needs to run a different set of tasks on December 31, 2020. MM.DAY.MOD is a copy of the Workflow, and contains the required tasks for that date. MM.DAY contains the following script, which replaces the original Workflow content with the modified content when the Workflow runs on the target date.

:IF "201231" = SYS_LDATE()
:   REPLACE_STRUCTURE OBJECT="MM.DAY.MOD"
:ENDIF

See also: