ADF UI Shell: Automatically Open a Default Activity Upon Page Load

I am watching the Oracle UI Shell Functional Pattern thread at OTN and noted that some people were interested on how to automatically open a default activity in ADF UI Shell. I decided to take up the challenge and came up with the following.

This post is just a demonstration on how to open a default activity upon page load in ADF UI Shell, based on the accompanying sample application named "UISHellSherman_V02".
Let us simulate the concept using the page First.jspx.

1. Add the Trinidad HTML Components 1.2 JSP Tag Library on the uiShellViewController project
   
2. Open First.jspx and add the Trinidad "trh" tag declaration on the jsp root. The jsp root declaration should look like the following:
   

   <?xml version='1.0' encoding='UTF-8'?>
   <jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
             xmlns:f="http://java.sun.com/jsf/core"
             xmlns:h="http://java.sun.com/jsf/html"
             xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
             xmlns:trh="http://myfaces.apache.org/trinidad/html">
   

3. Add the following client and server listeners:
   

   <af:document id="d1" title="First Page">
         <af:clientListener method="initialize" type="load" />
           <af:serverListener type="launchDefaultActivity"
                              method="#{backingBeanScope.launcher.launchDefaultActivity}" />
   

   
   
4. Right-click the line <af:document id="d1" title="First Page"> click Facets -document, then enable the Meta Container facet.
   Modify the Meta Container facet to reflect the following:
   

   <f:facet name="metaContainer">
           <af:group>
            <trh:script>
               function initialize(event) {
                   var source = event.getSource();
                   AdfCustomEvent.queue(source,"launchDefaultActivity",{},false);
               }
             </trh:script>
           </af:group>
         </f:facet>
   

5. Add a launchDefaultActivity() method on the Launcher class.
   

   public void launchDefaultActivity(ClientEvent clientEvent) {
           _launchActivity(
             "The Default Activity",
             "/WEB-INF/flows/first.xml#first",
             false);
       }
   

6. Run the First.jspx
   

Related Posts

• ADF UI Shell: Customizing the Dynamic Tab Shell Layout
• ADF UI Shell: Extending the UI Shell to Allow Passing of Parameters to Bounded Task Flows
• UI Shell in Action - an app based on the UI Shell that connects to HR Schema

Cheers!