Common Dialog Action Icon

Common Dialog Action

Declaration

<AMCOMMONDIALOG ACTION="text [options]" TITLE="text" RESULTVARIABLE="text" DEFAULTFOLDER="text" FILTER="text">

See Also

Message Box, Create Variable

Description

Displays the standard Windows Open, Save As, or Browse for Folder dialogs. The file or folder selected is stored in a variable for use in subsequent steps.

Practical Usage

 

Parameters

General Tab

Action (dialog type)
Text, required
MARKUP: ACTION="save"

Specifies what type of dialog to display.

The available options are:

open: The standard "Open File" dialog box is displayed.

save: The standard "Save As" dialog box is displayed.

folder: The standard "Browse for folder" dialog box is displayed.

Title
Text, optional Default (blank)
MARKUP: TITLE="Please Browse for the Target Spreadsheet"

Specifies the title of the common dialog box (e.g. 'Please Browse for the Target Spreadsheet')

Filter
Text, optional Default (blank)
MARKUP: FILTER="All files (*.*)|*.*"

Specifies the file filters for the Open File and Save As dialog boxes. Filters represent the masks that are listed in the "File Type" dropdown.

Initial Folder
Text, optional Default (blank)
MARKUP: DEFAULTFOLDER="c:\foldername\"

Specifies the starting folder for the browse or save as dialog (this is not supported in the Folder dialog).

Variable Name (for inputted text)
text, Optional - Default (none)
MARKUP: RESULTVARIABLE="varname"

Specifies the name of an already created variable that should be populated with the text that the user has input as a response to the question.

Notes

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 by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example