開発とページの差分

機能概要

コンテンツの作成は反復的なプロセスです。効率的にオーサリングをおこなうには、反復するごとに何が変更されたかがわかるようにする必要があります。あるページバージョンを見てから別のページバージョンを見るのは非効率的であり、エラーが発生しやすくなります。作成者は、現在のページと前のバージョンを並べて比較する際に、差分が強調表示されるようにしたいと考えています。

ページの差分機能を使用すると、ユーザーは現在のページをローンチや以前のバージョンなどと比較できます。このユーザー機能について詳しくは、ページの差分を参照してください。

操作の詳細

ページのバージョンを比較する場合、差分を検出しやすくするために、比較対象となる以前のバージョンが AEM によってバックグラウンドで再作成されます。これは、並べて比較できるようにコンテンツをレンダリングするために必要です。

この再作成操作は AEM の内部でおこなわれるもので、ユーザーに対しては透過的であり、ユーザーの介入は必要ありません。ただし、管理者が CRX DE Lite などでリポジトリーを閲覧している場合は、再作成されたこれらのバージョンがコンテンツ構造内に表示されます。

AEMのパッチレベルによって動作が異なり、正しく機能するために特定の権限が必要になる場合があります。

AEM 6.4.3より前

コンテンツを比較すると、比較対象のページまでのツリー全体が次の場所に再作成されます。

/content/versionhistory/<userId>/<site structure>

ページの相違メカニズムを使用する場合、AEMは前のバージョンのページを再作成するので、この機能を使用するには特定のJCR権限が必要です。

注意

ページの相違機能を使用するには、ノード/content/versionhistoryに対して​変更/作成/削除​権限が必要です。

AEM 6.4.3以降

コンテンツを比較すると、比較対象のページまでのツリー全体が次の場所に再作成されます。

/tmp/versionhistory/

このコンテンツは、現在のユーザーに対する表示を制限する権限を持つサービスユーザーが作成します。 このため、特別な権限は必要ありません。

クリーンアップタスクが自動的に実行されて、この一時コンテンツがクリーンアップされます。

開発者の制限事項

以前は、Classic UIでは、AEMの変更を容易にするために、特別な開発上の考慮が必要でした(例えば、cq:textタグライブラリを使用したり、DiffService OSGiサービスをコンポーネントに統合するなど)。 新しい差分機能ではこのような考慮は必要なくなりました。差分は DOM 比較を介してクライアント側で実行されるからです。

ただし、開発者が考慮する必要がある制限事項はいくつかあります。

  • この機能では、AEM 製品の名前空間にない CSS クラスが使用されます。同じ名前の付いた他のカスタム CSS クラスまたはサードパーティの CSS クラスがページに含まれている場合、差分の表示に影響が及ぶ可能性があります。

    • html-added
    • html-removed
    • cq-component-added
    • cq-component-removed
    • cq-component-moved
    • cq-component-changed
  • 差分はクライアント側でページの読み込み時に実行されるので、クライアント側の差分サービスが実行された後に DOM を調整しても、その効果はありません。これは、次の項目に影響を与える可能性があります。

    • AJAX を使用してコンテンツを取り込むコンポーネント
    • 単一ページアプリケーション
    • ユーザーインタラクションに対して DOM を操作する JavaScript ベースのコンポーネント

このページ