Label Action

Description

Labels a point in a Workflow with a specific name.  Can be used with the Goto Action or On Error Goto to direct Workflow execution to a different point of the Workflow. This action does not have an effect on Workflow execution, it only defines a point in a Workflow. Refer to Goto Action for usage information.

IMPORTANT: Excessive use of Goto can create Workflows that are difficult or impossible to debug. If your Workflow requires more than a few goto steps, it is recommended to consider re-structuring with "Sub-Workflows"  (using the Start Task Action). In many programming  languages, the use of even one Goto statement is considered bad programming practice. Use at your own risk!

Declaration

<AMLABEL LABELNAME="text">

Examples

<AMIFFILEEXISTS ACTION="not_exist" SOURCE="c:\filename.txt">
<AMGOTO LABELNAME="problemhandler1">
</AMIF>
<AMFILECOPY SOURCE="c:\filename.txt" DEST="c:\newfolder\filename.txt">
<AMSTOPTASK>
<AMLABEL LABELNAME="problemhandler1">
<AMMESSAGEBOX>File not found!</AMMESSAGEBOX>

General Tab Parameters

Label name: Specifies the name of the label.

Text, Optional
MARKUP: LABELNAME="problemhandler"

See Also

Goto Action