legacy-knowledge-base
公開されました Jul. 2, 2025

パッチツールによるJSPファイルの変更検出方法について

written-by

Zsolt Balogh

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

ポータルの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つがあります。

  1. フックとcustom-jsp-globalをtrueに設定した場合:jspsはポータルWebアプリにコピーされ、ポータルjspファイルの名前は*.portal*に変更されます。 パッチツールはこの変更を検出し、通知します。 パッチは*.portal.jspファイルにのみ適用されるので、カスタマイズされたJSPは触れません。
  2. フックを使用し、custom-jsp-globalをfalseに設定した場合:これらはアプリケーションアダプターのjspです。 jspファイルはポータルサイトのウェブアプリにコピーされないため、パッチツールはこれらの変更を検知する機会がなく、警告も表示されません。 ポータルファイルにはパッチが適用されています。ここでの唯一の問題は、アプリケーションアダプターを適用しているサイトでは、バグフィックス(フィックスパックで修正)が存在しないことです。
  3. Ext-web:Ext-webのファイルがポータルWebアプリにコピーされるだけで、パッチツールはこれに気づかず、上書きしてしまう。 パッチを戻すと、そのバージョンはバックアップからコピーバックされます。

その他重要事項

  • ドキュメントで "jsp "のオーバーライドについて説明されている場合、ウェブアプリ内の他のファイル(jsp、jspf、js、css、その他のファイル)にも適用することが可能です。 この用語は、ポータルのドキュメントでも使用されています。
  • 修正パックにフックによって変更されたjspが含まれると、必ず警告が表示されます。
  • パッチツールは、ファイルの結合を行いません。 完全なファイルを上書きすることしかできません。

追加情報

Patching Toolの新しいバージョンについては、 Understanding Versioning の項をご覧ください。 Patching Tool 1.0.23.

did-this-article-resolve-your-issue

legacy-knowledge-base