:BEGINREAD... :ENDREAD

Use the :BEGINREAD and :ENDREAD script statements to define the start and end of the contents of a dialog. Include any number of elements between the :BEGINREAD and :ENDREAD statements to define texts and query users in the dialog.

Write :READ statements between the two commands to define user queries. The number of :READ statements determines the size of the dialog. The parameters that you specify in the :READ statements also appearance of the dialog, and the functions of the input fields. Use :PRINT statements to provide information or instructions in the dialog.

Syntax

:BEGINREAD [Label[,F]]

Statements

:ENDREAD

Parameters

• :BEGINREAD
  Defines the beginning of the dialog contents

• Label
  (Optional) Name of the dialog
  Format: script literal, script variable or script function
  Default value: name of the object

• F
  (Optional) Formats the text in the dialog so that all letters are the same width
  Tip: this parameter is helpful for aligning columns.

• Statements
  Script statements that define the contents of the dialog

• :ENDREAD
  Defines the end of the dialog contents

Notes:

• You can include any number of :READ and :PRINT statements between :BEGINREAD and :ENDREAD.
• This script statement causes all the open transactions of the script to be written to the AE database.

Important! The dialog is not displayed if the task, or the Workflow that the task runs in, is configured to be generated at runtime. When the dialog is not displayed, default values are used for the :READ statements. If the default values result in invalid responses, script generation is canceled.

More information:

• Script Processing
• Generating at Activation or at Runtime

Example

The following example creates a dialog titled Log on, which requests the user to enter their department and name:

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

See also: