|
Label - Goto |
<AMLABEL LABELNAME="text" /> |
Description:
Sends task flow to the label indicated.
Used to direct the task to jump to a labelled section defined by the Label action. Make the Goto dependent on an If action or some other condition to avoid an endless loop between Goto and the label.
IMPORTANT: Excessive use of Goto can create tasks that are difficult or impossible to debug. If your task requires more than a few Goto steps it is recommended to consider re-structuring with sub-tasks (using the Start task activity). In many programming languages, the use of even one Goto statement is considered bad programming practice. Use at your own risk! |
General
Property |
Type |
Required |
Default |
Markup |
Description |
Label to Goto |
Text
|
Yes
|
(Empty)
|
LABEL="bugHandler" |
The name of a pre-existing label in the task in which to jump to. To create a label in a task, use the Label Action. |
NOTE: The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder. |
Description: This sample task checks if "C:\Temp\test1.txt" exists. If so, it will be copied to "C:\Monthly_Backup\Archive\test1.txt" and a subsequent step stops the task. If not, the task will skip to a label named "bugHandler", at which point, a subsequent step will display a message dialog stating "File not found."
<AMIF ACTIVITY="file_exist" FILE="C:\Temp\test1.txt" MODE="not_exist"> <AMGOTO LABELNAME="bugHandler" /> </AMIF> <AMFILECOPY SOURCE="C:\Temp\test1.txt" DEST="C:\Monthly_Backup\Archive\test.txt"/> <AMSTOPTASK STATUSTYPE="SUCCESS" /> <AMLABEL LABELNAME="bugHandler" /> <AMMESSAGEBOX>File not found!</AMMESSAGEBOX>
|