Automation Engine Script Guide > Ordered by Function > Read or Modify Objects > :REPLACE_STRUCTURE

:REPLACE_STRUCTURE

Script statement: Replaces the structure of a workflowAn object of the Automation Engine that can include several executable objects and which runs them in a specified order. [Formerly called "ProcessFlow" and "JobPlan."] with the structure of another workflow at activation

Syntax

:REPLACE_STRUCTURE OBJ[ECT]=Workflow

Syntax

Description/Format

Workflow 

Name of the workflow whose structure should be used
Format: script literal or script variable
 

Comments

With this scriptA particular Automation Engine object type. statement, the structure of one workflow can be replaced with the structure of another workflow during its activation. That means the content of the Workflow tab is replaced. A runtimeThe duration of a task's execution. It refers to the period between a task's start and end. It does not include its activation period (see also: activation and start). error occurs if the specified workflow cannot be found.

Modifications to the workflow structure only apply for the particular execution and do not change the Workflow objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task.

Call the monitor in the statisticsThis is a list of a task's previous runs. of a workflow executionAn execution is an instance of a workflow. It can be monitored and controlled using the workflow monitor. to have the workflow displayed whose structure was used.

Automic recommends that you do not use this script statement if modifications can also be made through defining calendarAn Automation Engine object type that defines a set of days based on calendar keywords. dependencies, time-dependent conditions in scripts, etc.

Example

In the following example, the workflow "MM.DAY" should run with a modified workflow structure on 12/31/2001. The workflow has been copied and the copy has been changed. In the original workflow, the modified workflow is called with the following script lines.

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

 

See also:

About Scripts
Script Elements - Alphabetical listing

Script Elements - Ordered by Function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH