Upgrading OHW-UIX and UIX Mapping Topic IDs to Help Topics

23-6 Oracle Fusion Middleware Developers Guide for Oracle Help 24 Upgrading OHW-UIX 24-1 24 Upgrading OHW-UIX When upgrading from OHW-UIX to OHW-RC, the helpsets contents may remain unchanged, however, there are two things you need to do to use OHW-RC: ■ Copy the OHW-RC jar files into the WEB-INFlib directory. ■ Modify the web.xml file under the WEB-INF directory. The best way to do this is to get the web.xml from the OHW-RC demo bundle and copy the servlet and resource definitions and mappings. There are three major parts required in a web.xml for OHW-RC: ■ Basic configuration for JSF Trinidad and ADF RC Faces Servlet, Trinidad Servlet and Filter, etc.: context-param param-namejavax.faces.STATE_SAVING_METHODparam-name param-valueclientparam-value context-param filter filter-nametrinidadfilter-name filter-classorg.apache.myfaces.trinidad.webapp.TrinidadFilterfilter-class filter filter-mapping filter-nametrinidadfilter-name servlet-nameFaces Servletservlet-name filter-mapping servlet servlet-nameFaces Servletservlet-name servlet-classjavax.faces.webapp.FacesServletservlet-class load-on-startup1load-on-startup servlet 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 24-2 Oracle Fusion Middleware Developers Guide for Oracle Help servlet-mapping servlet-nameresourcesservlet-name url-patternadfurl-pattern servlet-mapping servlet-mapping servlet-nameresourcesservlet-name url-patternafrurl-pattern servlet-mapping ■ Basic configuration for OHW-RC: You need to define an OHW-RC Filter and map it to the Faces servlet. filter filter-nameOHWRCFRequestFilterfilter-name filter-classoracle.help.web.rich.OHWFilterfilter-class filter filter-mapping filter-nameOHWRCFRequestFilterfilter-name servlet-nameFaces Servletservlet-name filter-mapping ■ OHW-UIX Servlet definition and servlet mapping: The existing OHW-UIX servlet definitions need to be changed to use the OHW-RC class oracle.help.web.rich.OHWServlet. The following steps describe how to change existing OHW servlet definitions: 1. To specify the location of the ohw-config.xml for a OHW-UIX servlet instance, define OHW_UIX servlets with init-param named ohwConfigFileURL. 2. Define the URL mapping for OHW-UIX servlets. You do not have to change the existing servlet mappings. 3. Specify the load-on-startup parameter. OHW-RC supports multiple OHW-RC instances in one Web application. Here is an example which deploys two OHW-RC instances in a web.xml: -- 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 product1 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