There arevarIoUs ways to embed a custom region/section or external HTML contents into an OA Framework pageusing either personalization or
extension or a combination of both. If your requirement is to embed a custom OA Framework region [stacklayout] into another standard OA Framework
page,then use the approach detailedin this link [has video demo]. You will use listed stacklayout approach only when you wish to embed dynamic
contents,i.e. commonly displaying/changing data from database.However,sometimes your requirement is very simple. Your business requirement
could be to embed a fairly static HTML page into your OA Framework page of existing application. You can achieve this requirement by means of
simple OA Framework personalization. However there are different techniques of doing such personalization.
Each such technique has its own pros and cons and is discussed in this article,with some video demos.
There are two approaches.
Option 1
Use personalization to create a new item of type Raw Text.
In this case,you can embed a HTML section by simply creating a new item of style "Raw Text" using personalization.
For video demonstration of adding Raw HTML Text using personalizationseethis link
Option 2
Use "URL Include" styled item to include a HTML page deployed in $OA_HTML directory on mid-tier.
Using this approach,your steps will be
1. Ensure that a page named lets say xxAppsPONews.htm exists in $OA_HTML
2. Personalize the OA Framework page into which you wish to embed xxAppsPONews.htm
3. When personalizing,click on create new item of style "URL Include"
4. In the Source URL Property,specify OA_HTML/xxAppsPONews.htm
The benefit of this approach is that you do not need to modify the underlying OA Framework page.
Option 3
Use "URL Include" to include/embed contentsof anexternal HTML pagethat is deployed on some external website/server.
Using this approach,your steps will be
1. Ensure that a URL exists lets say that the URL is
http://www.apps2fusion.com/training_demo/anilpassi/html-using-personalization/oaf-1/xxExternalNews.htm
2. Personalize the page into which you wish to embed this xxExternalNews.htm
3. When personalizing,click on create new item of style "URL Include"
4. In the Source URL Property,specifyhttp://www.apps2fusion.com/training_demo/anilpassi/html-using-personalization/oaf-1/xxExternalNews.htm
As per the above URL,the contents of external HTML page will be embedded within OA Framework page.
Option 4
Add a new item,i.e. Formatted text which points to a message dictionary message.
This message text can have HTML tags embedded within itself.
The item style "Formatted Text" will reference FND Message Short Name,to display its text.
Give me one business example of how this can be used?
Lets that you have implemented iProcurement and you wish to embed important purchasing policy on top of iProc home page.
If your purchasing department wants flexibility to change the contents of that announcement or PO News,then we can let
them maintain an html page on their purchasing portal. Next,personalization of type "URL Include" in OA Framework will reference
the page that is maintained by your purchasing department.
The contents of that Purchasing HTML page [xxExternalNews.htm] will get embedded into your OA Framework page.
Will this external Purchasing News page reside on Mid-Tier of eBusiness Suite or can this html page reside on any external server?
Both these options are available,as evident from Option 2 & Option 3
If your external page
OA_HTML/xxExternalNews.htm
However,if your external page resides inhttp://www.apps2fusion.com/,then "URL Include" item should have its "Source URL Property" set to
the complete URL http://www.apps2fusion.com/training_demo/anilpassi/html-using-personalization/oaf-1/xxExternalNews.htm
What are the benefits of URL Include over other options i.e. Raw Text and Message Dictionary Text
Advantage 1
Once your URL include is implemented,no further changes are required to OA Framework personalization.
Advantage 2
As in this example,purchasing department can independently maintain the contents of sub-section of OA Framework page without any dependency on your IT Department.
In case you have implemented Custom Look and Feel,then your external pages must also be be changed as per look and feel of OA Framework pages.
Any drawbacks of URL Include approach?
There have been known issues with display of URL Include html contents when SSL has been implemented.
This can cause SSLException: SSL handshake Failed: X509CertChainIncompleteErr
Instead of trying to resolve this issue,you should rather use other options listed in this article.
My client wants different HTML contents depending upon the language of the user's session?
In this case,I suggest you use Option 4,as messages are multi-lang enabled.
If your message text is very big,then consider splitting your html contents into multiple FND Messages.
Do I need to have < head>,< html> & < body> tags in the external html page?
It makes no difference whether you have those tags or not in the external page.
For this demo,xxExternalNews.htm had no head or body or html tags
Can I use Form fields/input fields in my external HTML content?You must not use forms or input fields into the external HTML Contents.Reason being that if your external html performs "form post",then it is OA Framework page that gets submitted.The fields values within external html page will not be captured within page Context of OA Framework page.