MultipleInputGrid Function

Implementing     Other Uses    Parts

• Inherit from MultipleInputGrid Pattern
• Specify Fields in Multiple Grid Event Handler Variables
• Specify Logic in Multiple Grid Event Handler
• Generate, Build, and Run

The MultipleInputGrid pattern can be used to implement Web pages where multiple rows of Grid data are processed by a single Event Handler function.  The MultipleInputGrid function scopes a ProcessGrid Event Handler function which is based on the MultipleInputEventHandler pattern.

In the guidelines below, the MultipleInputGrid pattern is used to implement a multi-update of the rows in a database table.

Inherit from MultipleInputGrid Pattern

First, define a Page Generator function based on the MultipleInputGrid pattern:

Example:

To list existing records, it is also necessary to inherit from the WebGridPage pattern.

It may also be considered to omit superfluous (non-key) fields from the read-only part of the grid, as they will appear as input fields in the grid.

Example:

Specify Fields in Multiple Grid Event Handler Variables

The ProcessGrid Event Handler scoped under the multi-input Page Generator is based on the MultipleInputEventHandler pattern which will receive the input from the multiple rows in the MultipleWebInput variable.

Example:

In this implementation of a multi-update function, the following triples must be specified:

The specifications above tells that all non-key records fields should appear as input fields in the input grid while the record key is received as hidden input.  The WebInput triples specify the record key in order to reposition when the grid is reloaded after the update.

Do also declare the new Event Handler function by the Dispatcher:

Specify Logic in Multiple Grid Event Handler

Code to process each row in the grid should be specified in the Process grid record edit point of the ProcessGrid Event Handler function.  In this way, a call to an UpdateRow server function could be specified mapping with the field values in the MultipleWebInput variable.

Example:

In the example, the Grid Page Generator is called again and mapping should be done with the WebInput variable.

Generate, Build, and Run

The specified multi-input function and its scoped functions must be generated and built, and the Document Template Generator must be executed from the Generate and Build window.

Note! The Document Template for this multi-input function cannot be modified with the HTML editor in MS FrontPage 98.  When saving the HTML Template, the FrontPage editor will automatically re-arrange the hidden fields in the multi-input HTML form in a way that will corrupt the input data received by the Event Handler.