Installing the OHW-RC Demo EAR File on Oracle JDeveloper

18-4 Oracle Fusion Middleware Developers Guide for Oracle Help servlet-mapping servlet-nameFaces Servletservlet-name url-patternfacesurl-pattern servlet-mapping servlet servlet-nameresourcesservlet-name servlet-classorg.apache.myfaces.trinidad.webapp.ResourceServletservlet-clas s servlet servlet-mapping servlet-nameresourcesservlet-name url-patternadfurl-pattern servlet-mapping servlet-mapping servlet-nameresourcesservlet-name url-patternafrurl-pattern servlet-mapping -- configuration for product1 help front servlet -- servlet servlet-nameproduct1servlet-name servlet-classoracle.help.web.rich.OHWServletservlet-class init-param param-nameohwConfigFileURLparam-name param-valuehelpsetsproduct1ohwconfig.xmlparam-value init-param load-on-startup2load-on-startup servlet -- configuration for product2 help front servlet -- servlet servlet-nameproduct2servlet-name servlet-classoracle.help.web.rich.OHWServletservlet-class init-param param-nameohwConfigFileURLparam-name param-valuehelpsetsproduct2ohwconfig.xmlparam-value init-param load-on-startup3load-on-startup servlet -- servlet mappings for the OHW-RC front servlets -- servlet-mapping servlet-nameproduct1servlet-name url-patternproduct1url-pattern servlet-mapping servlet-mapping servlet-nameproduct2servlet-name url-patternproduct2url-pattern servlet-mapping -- OHW-RC servlet filter definition and mappings -- filter filter-nameOHWRCFRequestFilterfilter-name filter-classoracle.help.web.rich.OHWFilterfilter-class filter filter-mapping filter-nameOHWRCFRequestFilterfilter-name Understanding OHW-RC Deployment 18-5 servlet-nameFaces Servletservlet-name filter-mapping ■ ohwconfig.xml default file name: Specify which helpsets to display and how to present them. You can also specify locales, branding information, and various other settings. For information about this configuration file, see Chapter 9, Oracle Help for the Web Configuration File . The name and location of this file is set as a OHW-RC front servlet initialization parameter, which is handled differently for each servlet container. The ohwConfigFileURL initialization parameter could take a path that contains {some_parameter} tokens. The tokens value will be resolved from Java System.getProperty calls. Always consult the servlet container documentation for current and complete information. The file is available in OHW-RC_HOME\OHW-RC_deployment_ name\helpsets directory. Note that you can also specify ohwConfigURL using the prop system property. For example, in web.xml, the ohwConfigURL would be configured as: param-nameohwConfigFileURLparam-name param-valuefile:{prop}helpohwconfig.xmlparam-value In adf-settings.xml, the ohwConfigURL would be configured as: property property-nameohwConfigFileURLproperty-name valuefile:{prop}helpohwconfig.xmlvalue property The prop property is predefined, or specified, by starting Oracle WebLogic Server with -Dprop option. For example, -Dprop=Oraclehelp. ■ trinidad-config.xml : Specify the configuration for the Trinidad and ADF Rich components. It specifies the skinning option to be used in OHW-RC. The file is available in OHW-RC_HOME\OHW-RC_deployment_name\WEB-INF\ directory. ■ faces-config.xml : This is the JSF configuration file. The file is available in OHW-RC_HOME\OHW-RC_deployment_name\WEB-INF\ directory. You need to add the ADF Faces render kit information in this file: application default-render-kit-idoracle.adf.richdefault-render-kit-id locale-config default-localeendefault-locale locale-config application

18.5 Configuring OHW-RC to Display Custom Helpsets

The instructions in this section will help you create the directory structure required for OHW-RC help system, add your custom helpset files in the correct location, create or modify the configuration files, and deploy the help system on application server. The instructions in this section also assume that you have installed the OHW-RC demo EAR file and you have a knowledge of the demo EAR file’s directory structure. If you have not installed the demo file, install it following instructions in Chapter 17, Deploying OHW-RC Demo File .