3 Replies Latest reply on Sep 6, 2007 2:50 PM by 528699

    Providing an ADF faces application with help

      We have an application made with adf faces and we would like to provide it with that nice OHW help. Can someone direct me to some simple example of preparing the help and incorporating in into the application.
      Thanks in advance.
        • 1. Re: Providing an ADF faces application with help
          Hi Tzvetan,
          If you are using Oracle JDeveloper (for example, version, this is very easy.

          First, you configure your application to be aware of the OHW servlet. You do this by adding an oracle-help-servlet-url element in your adf-faces-config.xml file that points to your OHW URL like this:

          Then, on each page, you can bind links to a specific topicid in your help system. For example, if you want to create a global Help link to all your application's pages, you can create a JSF page called foo.jspx and drag an ADF Faces Core panelPage component onto it. On this page template you can add a menuButtons component to the menuGlobal facet and drop a goMenuItem on top of the menuButtons component.

          Next, set the destination for your goMenuItem (or any other component for which you can specify a destination) to any topicid in your helpsystem by invoking the Bind to Data editor and drilling down into adfFacesContext.helpTopic. A sample destination could be adfFacesContext.helpTopic.foo (where foo is the topicid of your specific topic).

          When you run the page and click on the Help link (the goMenuItem), it will bring up the help topic in OHW. You can save this as a template that you can use for other pages in your application.

          Hope this helps.

          • 2. Re: Providing an ADF faces application with help

            Your answer is really useful for me.
            I am using Oracle JDeveloper
            But I have some question need your help:

            1. It seems there is a help system in somewhere (“http://localhost:8888/ohw-demo/mykillercontent/”)
            I will appreciate if you can give the step to build the help system.
            2.It seems the help system need to be startup separately with the web application.
            3. If the ADF web application is deployed to Oracle Application Server, do I need to deployed the help system to the same server also?
            4.How can I integrate the Help System with the ADF web application?

            Peter Moh
            • 3. Re: Providing an ADF faces application with help
              I have add a helpset into demo-bundle's helpset (Also I add it into ohwconfig.xml under helpbooks).
              I test the help system with (url http:// The new added helpset works correctly.
              Then I add "<oracle>
              into my application's adf-faces-config.xml. And I add a goMenuItem into an exist menuBar.
              I set the destination for the goMenuItem to #{adfFacesContext.helpToipc}

              When I run the application, it starts. But when I clicking on the goMenuItem, the browser's address changes to

              Errors message displays:

              500 Internal Server Error
              java.lang.ClassCastException: oracle.adfinternal.view.faces.el.HelpProvider$HelpSystemMap     
              at oracle.adfinternal.view.faces.uinode.bind.URLBoundValue.getValue(URLBoundValue.java:31)     
              at oracle.adfinternal.view.faces.uinode.UIXComponentUINode.getAttributeValueImpl(UIXComponentUINode.java:392)     
              at oracle.adfinternal.view.faces.uinode.UIXComponentUINode.getAttributeValue(UIXComponentUINode.java:127)