Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide

> ## Information (info)

> Information (`info`) actions apply to the Messages frame in the default HTML page layout.

> The following table lists and describes the `info` actions:

> Action | Description
>     info.alert|short|long|arg, arg, ...
> | Adds a message to the status window with an alert.
>     info.clear
> | Clears the messages in the info object.
>     info.confirm|short|long|action|arg, arg, ...
> | Asks for user confirmation. If OK, then runs `action`.
>     info.field|short|long|field|arg, arg, ...
> | Marks a field for error and displays a message.
>     info.msg|short|long|arg, arg, ...
> | Adds a message to the status window.
>     info.prompt|short|long|action|arg, arg, ...
> | Asks for user input, then runs `action`.
>     info.yesno|short|long|yes-action|no-action|
>     cancel-action
> | Creates a nonmodal dialog box that requires user response. Runs the first action (`yes-action`) if the user chooses Yes. Runs the second action (`no-action)` if the user chooses No. Quits if the user chooses Cancel.
>     main.info.hide
> | Hides the info object.
>     main.info.load([short|long, short|long ...])
> | Loads indexed messages.
>     main.info.show
> | Shows the info object.

> ##### Info Action Parameters

> ``short``

> A character string that specifies a brief version of a message.

> Can also be used as an index to look up messages stored in the information object. Use as an index requires:

> - The `long` parameter is blank.
> - Loading of messages, using `main.info.load`, must be performed after login.
> ``long``

> A character string that specifies a more detailed version of a message than the `short` character string.

> The character string can optionally contain substitution arguments in the form `&``n,` where `n` is an integer between 1 and 9 inclusive. Substitutions are performed based on the values specified in the `arg` parameter.

> ``field``

> The field name qualified by an SDO name (`sdo_name`.`field_name`).

> ``arg, arg, ...``

> A comma-separated list of constants, field names, variables, or expressions that results in a character string value. These argument values replace substitution parameters in `long`.

> Note: The pipe character (|) is used to separate parameters. See the following example.

> ##### Example

> This example creates an error message for the `state` field while validating a customer record:

>     apph.action("info.field|code invalid|The &1 code needs to be a valid two
>     character US State abbreviation|customer.state");

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095