この章では、OHWのデプロイメント・プロセスと構成ファイル、OHWのアーティファクトのインストール方法、OHWでのカスタム・ヘルプセットの表示の構成方法、アクセスURLの変更方法、スタンドアロンWebアプリケーションおよび別のWebアプリケーションの一部としてのOHWのデプロイ方法について説明します。
この章の内容は次のとおりです。
ヘルプ作成者によるヘルプ・コンテンツの作成が終了した後、OHW管理者は、OHWを使用してヘルプ・コンテンツをデプロイするようWeb構成を変更する必要があります。
OHWは、様々な方法でデプロイできます。ただし、すべてのデプロイ・モードには共通する特定のタスクがあります。この章では、後続の手順の前提条件となる共通のタスクについて説明します。
OHWに慣れていない場合は、デモ・ファイルのデプロイから開始できます。詳細は、第16章「OHWのデモ・ファイルのデプロイ」を参照してください。デモEARファイルには、サンプル・ヘルプセットを即時にデプロイするためのファイルがすべて含まれます。
OHWの新しいヘルプセットを作成する場合、次の各項で、OHWのデプロイメント・プロセスに役立つ情報と、OHWヘルプ・システムを作成してデプロイする手順を参照してください。
構成ファイルの作成とアプリケーション・サーバーの構成が行われていない場合、OHW管理者は、後続の項で説明するタスクを実行してOHWヘルプ・システムをデプロイする必要があります。
OHWの次の要件について検証する必要があります。
表17-1 OHWデプロイの最小要件
要件 | 説明 |
---|---|
アプリケーション・サーバー |
OHWには、Java Servlet、JSPおよびJSFをサポートするJava EE 1.5互換のアプリケーション・サーバーが必要です。Oracle WebLogic Server(スタンドアロンとしてまたはJDeveloperと統合して提供されている)では、構成作業を最小限に抑えることができるため、その使用をお薦めします。サポートされているアプリケーション・サーバーの詳細は、OTNの「動作保証情報」のアプリケーション・サーバーに関する項を参照してください。 |
クライアント |
クライアントはHTMLのみを受信するため、必要となるのは、OHWヘルプ・コンテンツを表示して閲覧するためのWebブラウザのみです。WebブラウザのJavaScriptサポートは有効にする必要があります。 OHWは、Microsoft Internet Explorer 7、Microsoft Internet Explorer 8、Mozilla FireFox 2、Mozilla FireFox 3、Apple SafariおよびGoogle Chromeでサポートされます。サポートされているブラウザの詳細は、OTNの「リリース・ノート - JDeveloper 11g」のADF Facesおよびデータの視覚化に関する項を参照してください。 |
Rich ADF Faces |
OHWでは、Rich ADF FacesライブラリおよびRich ADF Facesに依存する機能が使用可能である必要があります。また、アプリケーション・サーバーは、正しいJARファイルをインストールするか、またはOracle JDeveloperのADFランタイム・インストーラを実行し、ADFベースのアプリケーション用に構成する必要があります。詳細は、Oracle WebLogic Application Consoleのオンライン・ヘルプを参照してください。 |
OHWはRich ADF Facesのテクノロジに依存しているため、Rich ADF FacesをサポートするようOHWヘルプ・ファイルのデプロイ先であるアプリケーション・サーバーを構成する必要があります。
Oracle WebLogic Serverを使用している場合は、Oracle WebLogic Application Consoleを調べて、次のライブラリがデプロイされていることを確認します。
ADF(adf.oracle.domain(1.0,11.1.1.2.0)
)
Java Server Faces(jsf(1.2,1.2.9.0)
)
JavaServer Pages標準タグ・ライブラリ(jstl(1.2,1.2.0.1)
)
これらのライブラリは、Oracle WebLogic Application Consoleのデプロイ・ページに表示されます。ライブラリがインストールされていない場合は、Oracle WebLogic Configurationウィザードを使用して、Oracle JRFライブラリを含むようにWebLogicドメインを拡張します。Oracle JRFライブラリを含めた後にOracle WebLogic Serverを再起動すると、Oracle WebLogic Application Consoleのデプロイ・ページにライブラリが表示されます。ドメイン拡張の詳細は、「Oracle ADFアプリケーションの管理」を参照してください。
Oracle WebLogic Serverを使用しない場合は、ohw-rcf-demo-thick.ear
のすべてのjarファイルが、WARデプロイメント・ファイルの\WEB-INF\lib
ディレクトリにコピーされていることを確認してください。ライブラリ・ファイルはOTNからダウンロードするか、デモ・ファイルからコピーできます。ライブラリは、ohw-rcf-demo-thick.ear
ファイルのohw-rcf-demo-thick\ohw-rcf-demo-thick\WEB-INF\lib
ディレクトリにあります。
OHWが機能するためには、いくつかのファイルがサーバーにインストールされている必要があります。詳細は、OHWの様々なデプロイに関するトピックを参照してください。
OHWの配布コンポーネントは、ohw-rcf.jar
、ohw-share.jar
、help-share.jar
などのJARファイルとohw-rcf-webapp.zip
で構成されています。 ohw-rcf-webapp.zip
にはhelppages
ディレクトリがあり、このディレクトリには、OHWの正常な実行に必要なjspx (XML形式のJSFページ)などのインストール可能ファイルが含まれます。
アーティファクトは、OTNからダウンロード可能です。
OHWヘルプセットのデプロイを開始する前に、OHWを正しく構成するために作成または変更の必要なファイルがあります。次に、XML構成ファイルの理解に役立つ情報を示します。
application.xml
: 指定のJava EEアプリケーションで実行するすべてのWebモジュールのマニフェスト。デプロイされる各製品のそれぞれのWebモジュールを指し示します。
application.xml
の名前および場所は、Java EE標準によって固定されています。このファイルは、<OHW_HOME>\META-INF\
ディレクトリにあります。
web.xml
: OHW構成ファイルの場所など、OHWコンポーネントの初期化パラメータを設定します。各Webモジュールに1つのweb.xml
インスタンスがあります。このファイルは、<OHW_HOME>\<OHW_deployment_name>\WEB-INF\
ディレクトリにあります。
OHWのすべての前提条件が正しくロードされて初期化されていることを確認するために設定の必要な、次の最小限のパラメータのセットがあります。
JSFのサーブレットおよびサーブレット・マッピング
Trinidadリソース・サーブレット、サーブレット・マッピング、フィルタおよびフィルタ・マッピング
OHWのフィルタおよびフィルタ・マッピング
ヘルプ・インスタンスのサーブレットおよびサーブレット・マッピング
次に、サンプルweb.xml
ファイルの例を示します。
<context-param> <param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name> <param-value>oracle.adf.view.rich.change.FilteredPersistenceChangeManager</param-value> </context-param> <filter> <filter-name>trinidad</filter-name> <filter-class>org.apache.myfaces.trinidad.webapp.TrinidadFilter</filter-class> </filter> <filter-mapping> <filter-name>trinidad</filter-name> <servlet-name>Faces Servlet</servlet-name> </filter-mapping> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>Faces Servlet</servlet-name> <url-pattern>/faces/*</url-pattern> </servlet-mapping> <servlet> <servlet-name>resources</servlet-name> <servlet-class>org.apache.myfaces.trinidad.webapp.ResourceServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>resources</servlet-name> <url-pattern>/adf/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>resources</servlet-name> <url-pattern>/afr/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>resources</servlet-name> <url-pattern>/ohr/*</url-pattern> </servlet-mapping> <!-- configuration for product1 help front servlet --> <servlet> <servlet-name>product1</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/product1/ohwconfig.xml</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> <!-- configuration for product2 help front servlet --> <servlet> <servlet-name>product2</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/product2/ohwconfig.xml</param-value> </init-param> <load-on-startup>3</load-on-startup> </servlet> <!-- servlet mappings for the OHW-RC front servlets --> <servlet-mapping> <servlet-name>product1</servlet-name> <url-pattern>/product1/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>product2</servlet-name> <url-pattern>/product2/*</url-pattern> </servlet-mapping> <!-- OHW-RC servlet filter definition and mappings --> <filter> <filter-name>OHWRCFRequestFilter</filter-name> <filter-class>oracle.help.web.rich.OHWFilter</filter-class> </filter> <filter-mapping> <filter-name>OHWRCFRequestFilter</filter-name> <servlet-name>Faces Servlet</servlet-name> </filter-mapping>
ohwconfig.xml
(デフォルトのファイル名): 表示するヘルプセットと、それらの表示方法を指定します。ロケール、ブランド情報およびその他各種設定も指定できます。この構成ファイルの詳細は、第8章「Oracle Help for the Web構成ファイル」を参照してください。このファイルの名前と場所は、OHWフロント・サーブレット初期化パラメータとして設定されます。このパラメータは、サーブレット・コンテナごとに個別に処理されます。ohwConfigFileURL
初期化パラメータは、{%some_parameter}
トークンを含むパスを取ります。トークンの値は、JavaのSystem.getProperty
コールで解決されます。最新の情報一覧については、常にサーブレット・コンテナのドキュメントを確認してください。
このファイルは、<OHW-RC_HOME>\<OHW-RC_deployment_name>\helpsets
ディレクトリにあります。prop
システム・プロパティを使用して、ohwConfigURL
を指定することもできます。たとえば、web.xml
では、ohwConfigURL
は次のように構成されます。
<param-name>ohwConfigFileURL</param-name> <param-value>file:///{%prop}/help/ohwconfig.xml</param-value>
adf-settings.xml
では、ohwConfigURL
は次のように構成されます。
<property> <property-name>ohwConfigFileURL</property-name> <value>file:///{%prop}/help/ohwconfig.xml</value> </property>
trinidad-config.xml
: TrinidadおよびADFリッチ・コンポーネントの構成を指定します。OHWで使用されるスキニング・オプションを指定します。このファイルは、<OHW_HOME>\<OHW_deployment_name>\WEB-INF\
ディレクトリにあります。
faces-config.xml
: これはJSF構成ファイルです。このファイルは、<OHW_HOME>\<OHW_deployment_name>\WEB-INF\
ディレクトリにあります。
ADF Facesレンダー・キット情報は、このファイルに追加する必要があります。
<application> <default-render-kit-id>oracle.adf.rich</default-render-kit-id> <locale-config> <default-locale>en</default-locale> </locale-config> </application>
この項では、OHWヘルプ・システムで必要とされるディレクトリ構造の作成、カスタム・ヘルプセット・ファイルの正しい場所への追加、構成ファイルの作成と変更、およびアプリケーション・サーバーへのヘルプ・システムのデプロイに役立つ情報が提供されます。
この項の説明では、OHWのデモEARファイルがインストール済で、ユーザーがデモEARファイルのディレクトリ構造に精通していることを想定しています。まだデモ・ファイルがインストールされていない場合は、第16章「OHWのデモ・ファイルのデプロイ」の手順に従ってインストールしてください。
OHWヘルプ・システムを設定する手順は、次のとおりです。
次のようにディレクトリ構造を設定します。
<OHW-RC_HOME> | — <OHW-RC_deployment_name> | — helppages — helpsets | — <custom_helpset_directory> — META-INF — WEB-INF | — lib — META-INF
次に例を示します。
my_module | — my_module_help | — helppages — helpsets | — my_ModuleHelpset — META-INF — WEB-INF | — lib — META-INF
独自のヘルプセット・ディレクトリを作成します。ヘルプセット・ファイル、トピック・ファイルおよび他の制御ファイル(索引、目次など)を含め、独自のヘルプ・ファイルをすべて<OHW_HOME>\<OHW_deployment_name>\helpsets\<custom_helpset_directory>
ディレクトリの下に配置します。また、ヘルプセットにJARファイルを使用する場合は、JARファイルもここに配置します。JARファイルを作成したヘルプセットとJARファイルを作成していないヘルプセットを1つのデプロイで一緒に使用できます。
構成ファイルを更新および構成します。デモEARのohwconfig.xml
をohw-rc-thick-demo\ohw-rc-thick-demo\helpsets
ディレクトリからコピーして、<OHW_HOME>\<OHW_deployment_name>\helpsets
ディレクトリに保存します。次の手順で、必要に応じてファイルを編集します。
自分のヘルプセットにダイレクトするように<books></books>
セクションを変更します。次に例を示します。
<books> <helpSet id="myModule" location="my_ModuleHelpset/my_ModuleHelpset.hs" /> </books>
<books></books>
セクションから、希望しないヘルプセットを削除します。削除されたヘルプセットは、OHWユーザー・インタフェースのヘルプセット・スイッチャのドロップダウン・リストに表示されなくなります。<books></books>
セクション内に<helpSet>
要素が1つしかない場合、ヘルプセット・スイッチャは使用できません。
<brandings></brandings>
セクションを更新して、独自のブランドを表示します。次に例を示します。
<brandings> <branding text="My Module" /> </brandings>
ohwconfig.xml
ファイルで構成できる動作の詳細は、第8章「Oracle Help for the Web構成ファイル」を参照してください。
ohw-rc-thick-demo\ohw-rc-thick-demo\helppages
ディレクトリを<OHW_HOME>\<OHW_deployment_name>
ディレクトリにコピーします。
次のライブラリ・ファイルを、JDeveloperから<OHW_HOME>\<OHW_deployment_name>\WEB-INF\lib
ディレクトリにコピーします。
ファイル名 | 場所 |
---|---|
JSFライブラリ・ファイル( |
|
JSTLライブラリ・ファイル( |
|
ADFライブラリ・ファイル( |
|
faces-config.xml
およびtrinidad-config.xml
に、OHWでのJSFとJSTLのサポートを構成します。XMLファイルをohw-rc-thick-demo\ohw-rc-thick-demo\WEB-INF
ディレクトリからコピーして、<OHW_HOME>\<OHW_deployment_name>\WEB-INF
ディレクトリに保存します。
faces-config.xml
は、JSFアプリケーションのリソースとページ移動のルールを登録するJSF構成ファイルです。trinidad-config.xml
では、ADF Faces機能を構成できます。faces-config.xml
同様、trinidad-config.xml
は、JSF式言語(EL)または静的値を使用して要素プロパティを定義できる単純なXML構造を持ちます。
Oracle WebLogic Serverを使用する場合、weblogic.xml
をohw-rc-thick-demo\ohw-rc-thick-demo\WEB-INF
ディレクトリからコピーして、<OHW_HOME>\<OHW_deployment_name>\WEB-INF
ディレクトリに保存します。必要に応じてファイルを編集します。
web.xml
をohw-rc-thick-demo\ohw-rc-thick-demo\WEB-INF
ディレクトリからコピーして、<OHW_HOME>\<OHW_deployment_name>\WEB-INF
ディレクトリに保存します。次の手順で、必要に応じてファイルを編集します。
<display-name></<display-name>
と<description></description>
セクションを変更して、カスタム・ヘルプセット名を表示します。次に例を示します。
<web-app> <display-name>My Module</display-name> <description>My module help</description> </web-app>
オプションで、<servlet>
要素の下の<servlet-name>
要素を編集して、OHWのアクセスに使用するURLを変更することもできます。アクセスURLの変更の詳細は、第17.7項「OHWのアクセスURLの変更」を参照してください。
<OHW-RC_deployment_name>
ディレクトリをWARファイルに圧縮します。
application.xml
をohw-rc-thick-demo\META-INF
ディレクトリからコピーして、<OHW-RC_HOME>\META-INF
ディレクトリに保存します。必要に応じてファイルを編集します。このファイルで、デプロイする各製品のWebモジュール名を指定します。
手順9で作成したWARファイル名を<web-uri></web-uri>
要素に指定することもできます。アプリケーションのアクセスURLを変更する場合は、<context-root><context-root>
要素を更新します。詳細は、第17.7.2項「アクセスURLの名前の変更」を参照してください。
<OHW_HOME>
ディレクトリをEARファイルに圧縮します。
Oracle WebLogic Serverを起動してEARファイルをデプロイします。Oracle WebLogic Serverが実行されている場合は、サーブレットを最後に起動してから加えた変更が有効になるように、シャットダウンしてから再起動する必要があります。EARファイルのデプロイの詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・オンライン・ヘルプのエンタープライズ・アプリケーションのインストールに関する項を参照してください。
ブラウザでhttp://<hostname>:<port>/<OHW-RC_deployment_name>/ohguide/
を指定します。<hostname>
は、Oracle WebLogic Serverがインストールされているシステムの名前です。
デモ・ヘルプ・システムの最初のページがブラウザに表示されます。複数のヘルプセットがある場合は、ツールバーのドロップダウン・リストを使用して1つのヘルプセットを選択し、ヘルプセット・スイッチャをクリックして、選択したヘルプセットのみの目次および索引を表示します。テキスト検索では、選択したヘルプセットの項目のみ検索されます。
OHWにアクセスするURLは、http://<hostname>:<port>/mymodule/ohguide/
です。<hostname>
は、OHWおよびOracle WebLogic Serverがインストールされているシステムの名前です。
このURLは、次の方法で変更できます。
URLの最後にあるhelpを変更するには、<OHW_HOME>\<OHW_deployment_name>\WEB-INF
のweb.xml
を編集します。
<servlet-mapping>
のパラメータである<url-pattern>
に、OHWへのアクセスに使用するURLを指定します。たとえば、<url-pattern>
を、デフォルトの/help/*
から/onlinereference/*
に変更した場合、OHWへのアクセスに使用するURLはhttp://<hostname>:<port>/mymodule/onlinereference/
となります。
次に例を示します。
<servlet-mapping> <servlet-name>mymodule</servlet-name> <url-pattern>/onlinereference/*</url-pattern> </servlet-mapping>
アプリケーションのアクセスURLを変更するには、<OHW_HOME>\META-INF
にあるapplication.xml
内で、<web>
要素の下の<context-root>
要素エントリを編集します。
<web> <web-uri>my_module.war</web-uri> <context-root>my_module</context-root> </web>
たとえば、OHWのアクセスURLをhttp://<hostname>:<port>/jdeveloper/help/
にする場合は、ルート要素を次のように変更します。
<web> <web-uri>my_module.war</web-uri> <context-root>jdeveloper</context-root> </web>
OHWのデプロイ方法の1つに、スタンドアロンWebアプリケーションとしてデプロイする方法があります。OHWをスタンドアロンWebアプリケーションとしてデプロイするには、OHWの実行に必要なすべてのファイルを含むOHWのWARファイルを、専用のコンテキスト・パスを持つアプリケーション・サーバーの個別のデプロイ・ディレクトリにコピーする必要があります。
次に説明するように、OHW管理者は、主要なタスクを実行してから、スタンドアロンWebアプリケーションとしてOHWヘルプ・システムをデプロイする必要があります。タスクの詳細は、第17章「OHWのデプロイメントの理解」を参照してください。
Oracle WebLogic Serverおよび他のサーブレット・コンテナでは、OHWのモジュールをWAR (Web ARchive)ファイルとして圧縮できます。これらのファイルは、WARファイル、JAR (Java ARchive)ファイルおよびOHWのインストール可能ファイルをラップするEAR (Enterprise ARchive)ファイルとしてデプロイされます。これを行うには、標準のJava JARユーティリティを使用して、WARまたはEARファイルを作成する方法があります。
OHWのWARまたはEARファイルは、WebクライアントがOHWのページにアクセスできるように、アプリケーション・サーバーによって解凍される必要があります。WARまたはEARファイルのデプロイ方法については、関連するアプリケーション・サーバーのガイドラインも参照してください。
また、Oracle JDeveloper StudioのようなWeb開発環境で、Webアプリケーションを手動で作成し、ライブラリ・パスにohw-rcf.jar
、ohw-share.jar
およびhelp-share.jar
を含め、public html
ディレクトリにohw-rcf-webapp.zip
を解凍する方法もあります。
すべてのファイルを正しい場所に配置した後、OHWが機能するためには、OHW管理者が一部の構成ファイルを変更する必要があります。
JSFおよびTrinidadパラメータを含むようにweb.xml
ファイルを変更します。
次に例を示します。
<?xml version = '1.0' encoding = 'UTF-8'?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... > <context-param> <param-name>javax.faces.STATE_SAVING_METHOD</param-name> <param-value>client</param-value> </context-param> <context-param> <param-name>org.apache.myfaces.trinidad.CHECK_FILE_MODIFICATION</param-name> <param-value>false</param-value> </context-param> ... ... </web-app>
OHWフロント・サーブレットおよびJSFフィルタをサポートするようにweb.xml
を変更します。
次に例を示します。
<?xml version = '1.0' encoding = 'UTF-8'?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... > ... ... <filter> <filter-name>trinidad</filter-name> <filter-class> org.apache.myfaces.trinidad.webapp.TrinidadFilter </filter-class> </filter> <filter-mapping> <filter-name>trinidad</filter-name> <servlet-name>Faces Servlet</servlet-name> <dispatcher>FORWARD</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet> <servlet-name>OHW Servlet 1</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/ohwconfig.xml</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping> <servlet-name>OHW Servlet 1</servlet-name> <url-pattern>/ohguide/*</url-pattern> </servlet-mapping> ... ... </web-app>
ohwconfig.xmlとhelpsets
ディレクトリを作成していない場合は、第17.6項「OHWでのカスタム・ヘルプセットの表示の構成」の手順1、2および3の説明に従って、ファイルとディレクトリを作成してください。
作成している場合、ohwconfig.xml
を変更し、ヘルプ・コンテンツを必要に応じて編集します。表示するヘルプセットと、それらの表示方法を指定します。ロケール、ブランド情報およびその他各種設定も指定できます。このファイルの名前と場所は、ohwConfigFileURL
サーブレット初期化パラメータとして設定されます。このパラメータは、サーブレット・コンテナごとに個別に処理されます。ohwConfigFileURLパラメータは、param-value
を指定するweb.xml
で定義されます。
この構成ファイルの詳細は、第8章「Oracle Help for the Web構成ファイル」を参照してください。
アプリケーションのEARファイルの外部でヘルプ・コンテンツを指定する場合、web.xml
ファイルを構成する必要があります。<param-value>
要素では、変数を使用して、ohwconfig.xml
のパスを次の構文で定義できます。
<init-param> <param-name>ohwConfigFileURL</param-name> <param-value> file:///{%yourVariableName}/help/ohwconfig.xml </param-value> </init-param>
OHWのパスで変数({%yourVariableName}
など)が検出されると、同じ名前のJavaシステム・プロパティ(yourVariableName
)が検索され、その変数値がJavaシステム・プロパティに定義されている値に置き換えられます。Javaシステム・プロパティは、Oracle WebLogic Serverの起動スクリプトで定義できます。
[Ctrl]+[N]のショートカット・キーによる新しいヘルプ・ウィンドウのオープンのサポート
web.xml
を構成して、ユーザーが[Ctrl]キーを押しながら[N]キーを押した場合に、新しいブラウザ・ウィンドウが開かれるように設定できます。次のコードをweb.xml
に追加して、ショートカット・キーのサポートを有効にします。
<context-param> <param-name>oracle.adf.view.rich.newWindowDetect.OPTIONS</param-name> <param-value>on</param-value> </context-param>
部分ページ移動のサポート
パフォーマンスを向上させるために、OHWでの部分ページ移動を有効にできます。デフォルトでは、部分ページ移動のサポートはADF Facesアプリケーションで無効ですが、次のコードをweb.xml
に追加して、ヘルプセット内での使用を有効にできます。
<context-param> <param-name>oracle.adf.view.rich.pprNavigation.OPTIONS</param-name> <param-value>onWithForcePPR</param-value> </context-param>
OHWのデプロイ方法として、Webアプリケーションと共存させる方法があります。Webアプリケーションとして、JSF、ADFまたはJSPアプリケーション、あるいはJava EE Webアプリケーションを使用できます。これにより、OHWを既存のアプリケーションに含まれるWebプロジェクトの1つとしてデプロイできるようになります。
既存のWebアプリケーションの一部としてOHWをデプロイする場合、WebアプリケーションとOHWヘルプ・システムでは、どちらも同じweb.xml
を共有します。このため、OHWヘルプ・システムの詳細なチューニングが制限され、アプリケーションで競合が生じる場合があります。OHWをWebアプリケーションから個別にデプロイして、ヘルプ・システムとアプリケーションをリンク付けることをお薦めします。詳細は、第17.8項「スタンドアロンWebアプリケーションとしてのOHWのデプロイ」を参照してください。アプリケーションでADF Facesを使用する場合、ADFアプリケーションのADF FacesコンポーネントでhelpTopicId
属性を使用できます。詳細は、第19.2項「オンライン・ヘルプとADF Facesアプリケーションの統合」を参照してください。
ohw-rcf-webapp.zip
を、既存のWebアプリケーションのpublic_html
フォルダ(またはWebアプリケーションのルート・ディレクトリ)に解凍します。
ohw-rcf.jar
、ohw-share.jar
およびhelp-share.jar
ファイルを、アプリケーションのWEB-INF/lib
フォルダ、または定義されたライブラリ・フォルダにコピーします。JDeveloperで開発している場合は、これらのJARファイルをプロジェクト(「プロジェクト・プロパティ」 > 「ライブラリとクラスパス」)に追加してください。
すべてのファイルを正しい場所に配置した後、OHWが機能するためには、OHW管理者が一部の構成ファイルを変更する必要があります。
JSFおよびTrinidadパラメータがない場合は、これらを含むようにweb.xml
ファイルを変更します。
次に例を示します。
<?xml version = '1.0' encoding = 'UTF-8'?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... > <context-param> <param-name>javax.faces.STATE_SAVING_METHOD</param-name> <param-value>client</param-value> </context-param> <context-param> <param-name>org.apache.myfaces.trinidad.CHECK_FILE_MODIFICATION</param-name> <param-value>true</param-value> </context-param> ... ... </web-app>
OHWフロント・サーブレットおよびJSFフィルタをサポートするようにweb.xml
を変更します。
OHWが既存のアプリケーションの一部であるため、OHW管理者は、load-on-startup
順序が、正しい順序で維持されているかどうかを確認する必要があります。
次に例を示します。
<?xml version = '1.0' encoding = 'UTF-8'?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... > ... ... <filter> <filter-name>trinidad</filter-name> <filter-class> org.apache.myfaces.trinidad.webapp.TrinidadFilter </filter-class> </filter> <filter-mapping> <filter-name>trinidad</filter-name> <servlet-name>Faces Servlet</servlet-name> <dispatcher>FORWARD</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet> <servlet-name>product1</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/product1/ohwconfig.xml</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> ... ... </web-app>
ohwconfig.xml
を変更し、必要に応じてヘルプ・コンテンツを編集します。ヘルプセットまたはohwconfig.xml
ファイルを作成していない場合は、手順1、2および3の説明に従って作成してください。
ohwconfig.xml
ファイルは、表示するヘルプセットと、それらの表示方法を指定します。ロケール、ブランド情報およびその他各種設定も指定できます。このファイルの名前と場所は、(web.xml
で定義される)ohwConfigFileURL
サーブレット初期化パラメータとして設定されます。このパラメータは、サーブレット・コンテナごとに個別に処理されます。この構成ファイルの詳細は、第8章「Oracle Help for the Web構成ファイル」を参照してください。
OHWでは、1つのWebアプリケーションまたはエンタープライズ・アプリケーションに、複数のヘルプ・インスタンス(1つのヘルプ・インスタンスには複数のヘルプセットが含まれる場合があります)をデプロイすることがサポートされています。このサポートの主な理由の1つは、OHW構成からのアップグレード時に必要となる変更を最小限に抑えるためです。OHWの複数ヘルプ・インスタンスのデプロイは、JSFサーブレットにリクエストを転送するOHWフロント・サーブレットを用意することによって可能になります。
OHWフロント・サーブレットにサーブレット・マッピングを追加するように、アプリケーションのweb.xml
ファイルを変更する必要があります。
次に、OHWの複数ヘルプ・インスタンスのデプロイをサポートするために必要な変更を行ったweb.xml
ファイルの例を示します。
<!-- configuration for product1 help front servlet --> <servlet> <servlet-name>product1</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/product1/ohwconfig.xml</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> <!-- configuration for product2 help front servlet --> <servlet> <servlet-name>product2</servlet-name> <servlet-class>oracle.help.web.rich.OHWServlet</servlet-class> <init-param> <param-name>ohwConfigFileURL</param-name> <param-value>/helpsets/product2/ohwconfig.xml</param-value> </init-param> <load-on-startup>3</load-on-startup> </servlet> <servlet-mapping> <servlet-name>product1</servlet-name> <url-pattern>/product1/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>product2</servlet-name> <url-pattern>/product2/*</url-pattern> </servlet-mapping>
このサンプル・コードには、product1
およびproduct2
という2つのOHWフロント・サーブレットがあります。各サーブレットは、ユーザー・インタフェースに表示するブックおよびビューのセットを決定するOHW構成ファイルを、個別にロードできます。product1
サーブレットは、URLパターン/product1/*
にマップされています。これにより、URLの最後の部分にproduct1
を含む、リッチOHWのコンテキスト・ルートにマップされたURLを指定すると、このサーブレットに再ルーティングされます。同様に、product2
は、URLパターン/product2/*
にマップされています。
OHWをアプリケーション・サーバーに正常にデプロイした後、次のようなURLを使用して、構成済のOHWフロント・サーブレットに接続できます。
http://www.myhelpserver.com:<port>/docs/product1
前例のURLでは、/helpsets/product1/ohwconfig.xml
のOHW構成ファイルをロードするproduct1
サーブレットが呼び出され、次のようなURLにリダイレクトされます。
http://www.myhelpserver.com:<port>/docs/faces/helppages/main.jspx?config=product1
また、OHWは(OHWと同様に)、URLに追加されたロケールおよびグループ情報を処理できます。