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.
