ポータルのJSPファイルの変更を検出する際のパッチツール(v22以前)の制限について説明します。
解像度
ポータルにカスタマイズを展開する際、パッチツールから開発者に展開するフックの更新を促す警告が出ることがありました。 これはメッセージの一例です:
WARNING: The file html\portlet\journal\select_document_library.jsp was changed by a hook. Only the original version of the file will be overridden. Please merge the changes to your custom development. [hotfix-885-6130]
ただし、現在はフック経由でjspをインストールした場合とcustom-jsp-global設定がtrue(デフォルト)の場合のみ警告が表示されるため、JSPをカスタマイズする度にこのメッセージが表示されるとは限りません。
JSPファイルをカスタマイズする方法には、次の3つがあります。
- フックとcustom-jsp-globalをtrueに設定した場合:jspsはポータルWebアプリにコピーされ、ポータルjspファイルの名前は*.portal*に変更されます。 パッチツールはこの変更を検出し、通知します。 パッチは*.portal.jspファイルにのみ適用されるので、カスタマイズされたJSPは触れません。
- フックを使用し、custom-jsp-globalをfalseに設定した場合:これらはアプリケーションアダプターのjspです。 jspファイルはポータルサイトのウェブアプリにコピーされないため、パッチツールはこれらの変更を検知する機会がなく、警告も表示されません。 ポータルファイルにはパッチが適用されています。ここでの唯一の問題は、アプリケーションアダプターを適用しているサイトでは、バグフィックス(フィックスパックで修正)が存在しないことです。
- Ext-web:Ext-webのファイルがポータルWebアプリにコピーされるだけで、パッチツールはこれに気づかず、上書きしてしまう。 パッチを戻すと、そのバージョンはバックアップからコピーバックされます。
その他重要事項
- ドキュメントで "jsp "のオーバーライドについて説明されている場合、ウェブアプリ内の他のファイル(jsp、jspf、js、css、その他のファイル)にも適用することが可能です。 この用語は、ポータルのドキュメントでも使用されています。
- 修正パックにフックによって変更されたjspが含まれると、必ず警告が表示されます。
- パッチツールは、ファイルの結合を行いません。 完全なファイルを上書きすることしかできません。
追加情報
Patching Toolの新しいバージョンについては、 Understanding Versioning の項をご覧ください。 Patching Tool 1.0.23.