17.16.5.3 ASK

• field-argument-1: field-argument

• field-argument-2: field-argument

Description: Prompts the user to enter information and assigns the bookmark designated by field-argument-1 to represent the user’s response. text in field-argument-2 specifies the prompt text, which is displayed in a dialog box. The prompt is displayed each time the ASK field is updated. A response remains assigned to the bookmark until a new response is entered.Represents information needed to elicit and store a response (where a response is any string of characters, including the empty string). When a field update is performed, the text specified by field-argument-2 is intended for use when requesting the response, and the resulting response is stored within the bookmark (17.18.29) whose name attribute matches the value specified by field-argument-1.

Field Value: None.

Switches: Zero or more of the following field-specific-switches.

\d
\o

The text in this switch’s field-argument specifies a default response if one is not entered. If no default response is specified, the field result remains unchanged. To specify a blank entry as the default, field-argument shall be “”.

When used in a mail merge main document, this causes the display of the prompt once instead of each time a new data record is merged. The same response is inserted in each resulting merged document.

[Example: When the following fields are updated and “John” is entered as the response,

ASK AskResponse "What is your first name?"
Hello REF AskResponse.

the result is

Hello John.

end example]

Syntax: