:BEGINREAD... :ENDREAD

Script Statements: They are used to define the beginning and end of a dialog box for user queries.

Syntax

:BEGINREAD [Label[,F]]
ENDREAD

Syntax	Description/Format
:BEGINREAD	Beginning of the dialog box for user queries.
Label	Name of the dialog box. Format: script literal, script variable or script function Default value: name of the object
F	Formats the text in the dialog box so that all letters are the same width.
:ENDREAD	End of the dialog box for user queries.

Comments

The script statements :BEGINREAD and :ENDREAD define the beginning and the end of a dialog box for user queries. You can put any number of :READ statements between those two commands, the number of which determines the size of the dialog box. Their parameters are relevant for the appearance of the dialog box and the functions of the created input fields.

Specifying a name for the dialog is optional. The object name is used if it is not specified. If the parameter "F" is used, all letters show the same width which is helpful for exact alignment of columns.

Use the :PRINT statement, to write text to the dialog box.

The script statement causes all open transactions of the script to be written to the AE database.

Generate at Runtime

The dialog box is not displayed if the option "Generate at runtime" (Attributes tab) is activate. The same is true if the object runs in a workflow that uses this setting.

Default values are used for :READ statements. If this does not result in a valid response, generation of the script is canceled.

Example

In the example, a "Log on" request is created. It requests the user to enter his department and name.

:BEGINREAD "Log on"
:READ &DEP#, "08", "Please enter your Department",, M
:READ &NAME#, "08", "Please enter your Name",, M
:ENDREAD

Script element	Description
:READ	Queries the user in a dialog.
:PRINT	This is used to write a text to a dialog for user queries or to the activation report of an object.