The purpose of this article is twofold
1. To understand one of the limitations of OA Framework personalization, in case you wish to add new “Submit Button” to a page.
2. To explain, what exactly happens when a page in OA Framework gets Submitted

When working on OA Framework extensions, you may have a requirement to add a new Submit Button to the page. This type of extension necessitates the need to extend the controller.

Why can’t I add a Submit Button using personalization?
Simply because Oracle’s OA Framework doesn’t allow you to do so via personalization.

Not even in R12?
Indeed, not even in R12 [checked upto Rollup3]

But using personalization, I can see the option to add a button using personalization on my instance!
Using personalization, you can add normal buttons, but not Submit Buttons.


What is the difference between a normal button and a submit button?
A Submit Button posts the page to the application server. In other words, the data entered by the user into the fields/records is sent to the Application Server, where data can be validated as per business logic and DML’s can be performed [via say jdbc].
In layman’s language, when you click on Submit Button in OA Framework, following sequence of events happen

Note the sentence above that is underlined.

Lets say your requirement is
User enters data into fields in OA Framework Page
     When button is clicked, the data must be validated
                If data validation succeeds, then send navigation to next page.
                If data validation fails, then do not navigate to next page [instead display error on same page]

Now, reverting back to underlined statement, if processFormData invokes validations, and if validations were to throw an unhandled exception, then processForRequest will not be called. Hence execution will never reach processFormRequest in case of validation failure. Given that we usually perform navigational actions within processFormRequest, navigation to the next page will hence be stopped.

If so, then what is the need for a plain Button?
A plain button has no interaction with the Application Server. It is simply used to invoke java script, for example opening another website etc.


How do we add a submit button programmatically?
We will cover this in the article following this one.

Comments (2)

Subscribe to this comment's feed

...
written by Anant Nimbalkar , January 16, 2008

As usual, gr8 stuff Anil. The kind of questions you put and the way you answer it, it makes it so damn easy to understand for any layman.

Calling XML publisher from OA framework page
written by Prasanna Khandwekar , January 21, 2008

Hello Anil,

Its a nice site. Lots of useful information for apps technical persons. We have requirement from client in which we are calling XML publisher report (Concurrent program using RDF report as data source). The request is getting called from OA framework. Even the XML tags are getting generated , but the PDF output is not getting generated. Kindly suggest what may be the issue. The report is working from thick client(Applet).Both reports and OA framework page are customizations.Please let me know if more information is required.

Thanks

Prasanna