View Source

The SUBMIT event can be used when developing Internet applications and has been added to the following controls' event sets: window, push button and static text. Only a QuickEvent can be defined for this event. The QuickEvent executes an Internet stored procedure, either a system stored procedure or one you create. The conversion of the SUBMIT event's QuickEvent into an HTML feature is different for each control. When the SUBMIT QuickEvent is defined for a:

Window	The SUBMIT event translates into an ACTION element with a CGI request (ACTION=.//<Internet procedure name>). You can also specify additional parameters for this QuickEvent as a comma delimited sequence of Query Items. Another way to specify additional parameters is to name your controls using a Query Item definition. Then the incoming HTTP- Request will carry the Query Item with a name equal to a control name <Query Item Name> and a value <Query Item Value> (possibly) set by a user.
Push button	The SUBMIT event translates into an additional HIDDEN element that allows the HTTP- Request Dispatcher to figure out what button has been pressed. There is no need for QuickEvent parameters in this case.
Static Text	The SUBMIT event translates into HREF element using the QuickEvent parameters: ( HREF=.//<Internet procedure name>? <Quick event parameters>)

Note: The QuickEvent dialog for this control can be accessed from the Form Designer's Properties menu or by CTRL+double-clicking on the text.

When defining the SUBMIT QuickEvents you need to select a QuickEvent Option which describes what it is that you want to occur. Any of the following options can be selected.

Execute a stored procedure, in which case you choose a system Internet procedure or one you created.

Publish Report creates a dynamic HTML page using a report layout defined with Report Builder. (Report Builder, a wrapper for RLIST, can be run by executing the OpenInsight form executable ORMAIN. More information on this topic can be found later in this chapter.) The parameter REPORT_ID is the name of the report layout created in Report Builder is entered in the window's QuickEvent.

Read the Document performs a function similar to a hyperlink (displays an HTML page) except that it uses OECGI.EXE to access a static web page registered in the repository. The parameter DOC_ID is the name of the HTML document to be accessed and is entered as a parameter in the window's SUBMIT event. If you want to access an HTML document that was not created with OpenInsight, simply register it in the repository.