Trigger Task Action

Declaration

 <AMTRIGGERTASK MANAGEDTASK="text" PASSWORD="text">

See Also

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

Description

Starts a managed task as if it were triggered. All managed task properties will be utilized including Logon, Priority and Security settings.

Practical Usage

Used to cause another task to trigger. When a task is triggered, all of the parameters in the Managed Task Properties (i.e. Security, Priority Logon properties, etc.) are applied.  

IMPORTANT NOTE: This is not the primary means for starting a synchronous sub-task (a much more common scenario), to simply start a sub-task use the Start Task Action instead. The Start Task action contains much greater capability in terms of error handling and passing variables to the sub-tasks.

This action should only be used when the started task should run asynchronously (execution of the parent will not wait for the sub task to complete) and the other managed task properties such as Priority should be applied.

Parameters

General Tab

Managed Task to Trigger

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

Specifies the name of the managed task to trigger. The task must exist in the current machine task list at runtime or the step will fail.  
NOTE: Changing the task name or parent folder name later can break this linkage once created.

Run Password

Text, Optional
MARKUP: PASSWORD="mypassword" 

If the task has been encrypted, 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.

<AMTRIGGERTASK MANAGEDTASK="Samples\Excel\Write Data to Excel" />