Start Task Action

Declaration

 <AMSTARTTASK MANAGEDTASK="taskname" TASKFILE="text">

See Also

Start Task Action-Setting Properties, Stop Task, Create Variable

Description

Starts another task using the task name specified. Public variables from the parent task are available to the newly started task.

Practical Usage

Used to start a second task from a "parent" task. Especially useful for code reuse so the same code does not have to be written over and over again. Rather, one task can be created and called repeatedly.

Parameters

General Tab

Run a task file

Text, Optional
MARKUP: TASKFILE="C:\Documents and Settings\All Users.WINDOWS\Documents\My AutoMate Tasks\FTP_Upload.aml"

Specifies the path and filename to an un-managed task (.aml file) that should be run.

An un-managed task (also known as an external task) is a task that was created using the Task Builder but was not added to the Task Administrator. When a task is started in this manner, all of the parameters in the Managed Task Properties (i.e. Security, Priority, Logon properties, etc.) are NOT applied. When using task modules for code reuse, this option makes more sense because code modules normally do not need to be triggered (they are only called from other tasks), thus, there is no reason to add them to the Task Administrator. In most cases, only the "parent" task should be added to the Task Administrator. Sub-tasks (i.e. task modules that are made only to be re-used) are better stored in a designated location on the hard disk or network and called by their filename. To create an un-managed task, simply start the Task Builder directly from the AutoMate program group or via the Windows Start menu by selecting the Task Builder option. When started in this manner, menu options such as Open, Save and Save As are available in the Task Builder.

Start a managed task

Text, Optional
MARKUP:
a) MANAGEDTASK="Talking Clock"
b) MANAGEDTASK="Foldername\Talking Clock"
 

Specifies the name of the managed task to start. The task must exist in the current machine's task list at runtime or the step will fail.  


NOTE:
Later changing the task name or parent folder name can break this linkage once created.

Password (Optional)

Text, Optional
MARKUP: PASSWORD="password"
 

If the task has been encrypted (as specified in the Managed Task Properties under the Security tab), specifies the password that should be used to decrypt it so that it can start.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMSTARTTASK MANAGEDTASK="Samples\Date and Time\Add Time to a Date" TASKID="{F48D3345-0BFA-4BC8-AEDB-0E94FB91857B}" />