ライブコピーの同期の設定 configuring-live-copy-synchronization

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

管理者

次のタスクを実行して、ライブコピーとソースコンテンツを同期する方法およびタイミングを制御します。

既存のロールアウト設定が要件を満たしているかどうか、または 1 つまたは複数のロールアウト設定を作成する必要があるかどうかを判断します。
ライブコピーに使用するロールアウト設定を指定します。

インストールされるロールアウト設定とカスタムロールアウト設定 installed-and-custom-rollout-configurations

この節では、インストールされるロールアウト設定、それらの設定で使用する同期アクションおよびカスタム設定の作成方法（必要な場合）に関する情報を示します。

CAUTION

インストール済みの標準のロールアウト設定を、更新したり変更したりすることは 推奨しません。カスタムのライブアクションが必要な場合は、カスタムロールアウトの設定で追加してください。

ロールアウトトリガー rollout-triggers

各ロールアウト設定では、ロールアウトトリガーを使用してロールアウトを発生させます。ロールアウト設定では、以下のいずれかのトリガーを使用できます。

ロールアウト時：ロールアウト コマンドをブループリントページで使用します。または、同期コマンドをライブコピーページで使用します。
変更時：ソースページが変更されます。
アクティベート時：ソースページがアクティベートされます。
アクティベート解除時：ソースページがアクティベート解除されます。

NOTE

変更時トリガーを使用すると、パフォーマンスに影響を及ぼす可能性があります。詳しくは、MSM のベストプラクティスを参照してください。

インストールされるロールアウト設定 installed-rollout-configurations

次の表に、AEM と共にインストールされるロールアウト設定のリストを示します。表には各ロールアウト設定のトリガーと同期アクションが含まれます。インストールされたロールアウト設定のアクションが要件を満たさない場合は、ロールアウト設定を作成できます。

名前

説明

トリガー

同期アクション

関連情報インストール済みの同期アクション

標準ロールアウト設定

標準のロールアウト設定では、ロールアウトトリガーでロールアウトプロセスを開始し、アクション（コンテンツの作成、更新、削除、子ノードの並べ替え）を実行できます。

ロールアウト時

contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren

ブループリントのアクティベート時にアクティベート

ソースが公開された場合にライブコピーを公開します。

アクティベート時

targetActivate

ブループリントのアクティベート解除時にアクティベート解除

ソースがアクティベート解除された場合にライブコピーをアクティベート解除します。

アクティベート解除時

targetDeactivate

変更時にプッシュ

ソースが変更された場合に、コンテンツをライブコピーにプッシュします。

このロールアウト設定は慎重に使用してください（「変更時」トリガーを使用するため）。

変更時

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren

変更時にプッシュ（シャロー）

参照を更新せずにブループリントページが変更された場合（シャローコピーの場合など）に、コンテンツをライブコピーにプッシュします。

このロールアウト設定は慎重に使用してください（「変更時」トリガーを使用するため）。

変更時

contentUpdate
contentCopy
contentDelete
orderChildren

ローンチを昇格

ローンチページを昇格するための標準ロールアウト設定です。

ロールアウト時

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship

カタログページコンテンツのロールアウト設定

カタログのブループリントのページテンプレートを適用します。

ロールアウト時

contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren

カタログページ更新のロールアウト設定

カタログのブループリントからターゲットのプロパティを適用します。カタログページコンテンツのロールアウト設定の後に実行する必要があります。

ロールアウト時

catalogRolloutHooks

DPS パブリケーションのロールアウト設定

DPS パブリケーションのロールアウト設定では、ロールアウトトリガーでロールアウトプロセスを開始し、最初のロールアウト時に FolioProducer のバインドプロパティを除外できます。

ロールアウト時

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter

レガシー（5.6.0）カタログロールアウト設定

廃止。カタログロールアウトには、MSM ではなくカタログジェネレーターを使用してください。

ロールアウト時

editProperties

インストールされる同期アクション installed-synchronization-actions

次のテーブルに、AEM と共にインストールされる同期アクションのリストを示します。インストールされているアクションが要件を満たさない場合は、新しい同期アクションを作成できます。

アクション名

説明

プロパティ

contentCopy

ソースのノードがライブコピーに存在しない場合は、ライブコピーにノードをコピーします。CQ MSM Content Copy Action サービスを設定して、除外するノードタイプ、段落項目、ページプロパティを指定してください。

contentDelete

ソースに存在しないライブコピーのノードを削除します。CQ MSM Content Delete Action サービスを設定して、除外するノードタイプ、段落項目およびページプロパティを指定します。

contentUpdate

ソースからの変更を使用してライブコピーのコンテンツを更新します。CQ MSM Content Update Action サービスを設定して、除外するノードタイプ、段落項目、ページプロパティを指定してください。

editProperties

ライブコピーのプロパティを編集します。編集するプロパティとその値は editMap プロパティで指定します。editMap プロパティの値は次の形式にしてください。

[property_name_1]#[current_value]#[new_value],
[property_name_2]#[current_value]#[new_value],
... ,
[property_name_n]#[current_value]#[new_value]

current_value と new_value の項目は正規表現です。

例えば、editMap の次の値を検討してください。

sling:resourceType#/(contentpage|homepage)#/
mobilecontentpage,
cq:template#/contentpage#/mobilecontentpage

この値は、ライブコピーのノードのプロパティを次のように編集します。

contentpage または homepage のどちらかに設定されている sling:resourceType プロパティは次のように設定されます。 mobilecontentpage.
contentpage に設定されている cq:template プロパティは次のように設定されます。 mobilecontentpage.

editMap：（文字列）プロパティ、現在の値および新しい値を識別します。詳しくは、説明を参照してください。

notify

ページがロールアウトされたページイベントを送信します。通知が送信されるようにするには、最初にロールアウトイベントを購読する必要があります。

orderChildren

ライブコピーにおいて、ブループリント上の順序を基に子（ノード）を並べ替えます。

referencesUpdate

この同期アクションにより、ライブコピーでは、リンクなどの参照が更新されます。
ブループリント内の特定のリソースを指す、ライブコピーページ内のパスを検索します。パスが見つかったら、（ブループリントの代わりに）ライブコピー内の関連リソースを指すようにそのパスを更新します。ブループリント外のターゲットを持つ参照は変更されません。

CQ MSM References Update Action サービスを設定して、除外するノードタイプ、段落項目、ページプロパティを指定してください。

targetVersion

ライブコピーのバージョンを作成します。

このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。

targetActivate

ライブコピーをアクティベートします。

このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。

targetDeactivate

ライブコピーをアクティベート解除します。

このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。

ワークフロー

target プロパティで定義されるワークフローを開始し（ページの場合のみ）、ライブコピーをペイロードと見なします。

モデルノードのパスがターゲットパスになります。

target：（文字列）ワークフローモデルのパス。

mandatory

ライブコピーページ上の複数の ACL の権限を、特定のユーザーグループに対して読み取り専用に設定します。次の ACL が設定されています。

ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

このアクションはページにのみ使用してください。

target：（文字列）権限を設定するグループの ID。

mandatoryContent

ライブコピーページ上の複数の ACL の権限を、特定のユーザーグループに対して読み取り専用に設定します。次の ACL が設定されています。

ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

このアクションはページにのみ使用してください。

target：（文字列）権限を設定するグループの ID。

mandatoryStructure

ライブコピーページ上の ActionSet.ACTION_NAME_REMOVE ACL の権限を、特定のユーザーグループについて読み取り専用に設定します。このアクションはページにのみ使用してください。

target：（文字列）権限を設定するグループの ID。

VersionCopyAction

ブループリント／ソースページが少なくとも 1 回公開された場合は、公開されたバージョンを使用してライブコピーページを作成します。メモ：このアクションは、公開されたソースページに基づくライブコピーページの作成でのみ使用できます。既存のライブコピーページの更新では使用できません。

PageMoveAction

PageMoveAction はページがブループリント内に移動されたときに適用されます。

（関連する）ライブコピーページは、移動前の場所から移動後の場所に、（移動ではなく）コピーされます。

PageMoveAction によって、移動前の場所にあるライブコピーページが変更されることはありません。このため、連続した RolloutConfigurations では、ステータスはブループリントなしの LiveRelationhip になります。

CQ MSM Page Move Action サービスを設定して、除外するノードタイプ、段落項目およびページプロパティを指定してください。

このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。

prop_referenceUpdate：（Boolean）参照を更新するには、true に設定します。デフォルト値は true です。

productCreateUpdate

カタログ内の製品リソースを作成または更新します。このアクションは、次のいづれかの場合に使用します。

カタログ（またはカタログのセクション）を生成またはロールアウトする。
ユーザーが製品コンポーネントの同期の継承を復元する。

markLiveRelationship

ローンチが作成したコンテンツ用のライブの関係が存在することを示します。

catalogRolloutHooks

カタログ生成特有のロールアウトフックを実行します。CatalogGenerator の executePageRolloutHooks メソッドと executeProductRolloutHooks メソッドを呼び出します。
AEM Javadoc の com.adobe.cq.commerce.pim.api.CatalogGenerator を参照してください。

productUpdate

製品カタログのライブコピー内の製品ページを更新します。

ロールアウト設定の作成 creating-a-rollout-configuration

インストールされるロールアウト設定がアプリケーションの要件を満たさない場合は、ロールアウト設定を作成できます。

ブループリントページまたはライブコピーページでロールアウト設定を指定すると、新しいロールアウト設定を使用できるようになります。

プロパティとノードタイプの同期からの除外 excluding-properties-and-node-types-from-synchronization

対応する同期アクションをサポートする複数の OSGi サービスを設定して、特定のノードタイプやプロパティに影響を与えないようにすることができます。例えば、AEM の内部機能に関連する多くのプロパティとサブノードをライブコピーに含めることはできません。コピーする必要があるのは、ページのユーザーに関連するコンテンツだけです。

AEM を操作しているときは、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項について詳しくは、OSGi の設定を参照してください。

次の表に、除外するノードを指定できる同期アクションを示します。この表には、Web コンソールを使用して設定する場合のサービスの名前とリポジトリーノードを使用して設定する場合の PID が示されています。

同期アクション

Web コンソールでのサービス名

サービス PID

contentCopy

CQ MSM Content Copy Action

com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory

contentDelete

CQ MSM Content Delete Action

com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory

contentUpdate

CQ MSM Content Update Action

com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory

PageMoveAction

CQ MSM Page Move Action

com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory

referencesUpdate

CQ MSM References Update Action

com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

次の表は、設定可能なプロパティを示しています。

Web コンソールのプロパティ／OSGi のプロパティ

説明

Excluded Nodetypes

cq.wcm.msm.action.excludednodetypes

同期アクションから除外するノードタイプに一致する正規表現。

Excluded Paragraph Items

cq.wcm.msm.action.excludedparagraphitems

同期アクションから除外する段落項目に一致する正規表現。

Excluded Page Properties

cq.wcm.msm.action.excludedprops

同期アクションから除外するページプロパティに一致する正規表現。

Ignored Mixin NodeTypes

cq.wcm.msm.action.ignoredMixin

CQ MSM Content Update Action でのみ使用できます。同期アクションから除外する mixin ノードタイプの名前に一致する正規表現です。

NOTE

クラシック UI で、ライブコピーページのページのプロパティダイアログボックスに表示されるロックアイコンには、除外されたページプロパティプロパティの設定が反映されません。ロックアイコンは、同期アクションから除外されたプロパティについても表示されます。

NOTE

タッチ操作向け UI の場合は、ページプロパティの MSM ロックの設定（タッチ操作向け UI）も参照してください。

CQ MSM Content Update Action - 除外 cq-msm-content-update-action-exclusions

いくつかのプロパティとノードタイプは、デフォルトで除外されます。これらは、除外ページのプロパティ の CQ MSM CQ コンテンツ更新アクション の OSGi 設定で定義されています。

デフォルトでは、次の正規表現に一致するプロパティがロールアウト時に除外されます（更新されません）。

CQ MSM Content Update Action

必要に応じて、除外リストを定義する表現を変更できます。

例えば、ロールアウトで考慮される変更にページ タイトル を含めるには、除外から jcr:title を削除します。正規表現は次のようになります。

jcr:(?!(title)$).*

参照を更新するための同期の設定 configuring-synchronization-for-updating-references

参照の更新に関連する、対応する同期アクションをサポートする複数の OSGi サービスを設定できます。

次の表は、参照の更新を指定できる同期アクションを示します。この表には、Web コンソールを使用して設定する場合のサービスの名前とリポジトリーノードを使用して設定する場合の PID が示されています。

Web コンソールのプロパティ／OSGi のプロパティ

説明

ネストされたライブコピー全体での参照を更新

cq.wcm.msm.impl.action.referencesupdate.prop_updateNested

CQ MSM References Update Action でのみ使用できます。最上位のライブコピーのブランチ内にあるリソースをターゲットとする参照を置き換えるには、このオプションを選択する（Web コンソール）か、この boolean プロパティを true に設定します（リポジトリ設定）。

Update Referencing Pages

cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate

CQ MSM Page Move Action でのみ使用できます。元のページを使用する参照を、ライブコピーページを参照するように更新するには、このオプションを選択する（Web コンソール）か、この boolean プロパティを true に設定します（リポジトリ設定）。

使用するロールアウト設定の指定 specifying-the-rollout-configurations-to-use

MSM を使用すると、通常使用するロールアウト設定のセットを指定できます。必要に応じて、特定のライブコピー用にロールアウト設定を上書きすることもできます。MSM では、使用するロールアウト設定を複数の場所で指定できます。この場所では、特定のライブコピーに設定を適用するかどうかを指定します。

使用するロールアウト設定を指定できる場所を以下に示します。また、ライブコピーに使用するロールアウト設定を MSM がどのように決定するかについても説明します。

ライブコピーページのプロパティ： 1 つ以上のロールアウト設定を使用するようにライブコピーページが設定される場合、MSM ではそれらのロールアウト設定を使用します。
ブループリントページのプロパティ： ライブコピーがブループリントに基づいており、ライブコピーページがロールアウト設定を使用して設定されない場合は、ブループリントのソースページに関連付けられているロールアウト設定が使用されます。
ライブコピーの親ページプロパティ： ライブコピーページもブループリントのソースページもロールアウト設定を使用して設定されない場合は、ライブコピーページの親ページに適用されるロールアウト設定が使用されます。
システムのデフォルト： ライブコピーの親ページのロールアウト設定を特定できない場合は、システムのデフォルトのロールアウト設定が使用されます。

例えば、ブループリントが We.Retail 参照サイトをソースコンテンツとして使用するとします。サイトはブループリントから作成されます。次のリスト内の各項目では、ロールアウト設定の使用に関する様々なシナリオについて説明します。

どのブループリントページまたはライブコピーページもロールアウト設定を使用するように設定されていない。この場合、MSM では、システムのデフォルトのロールアウト設定をすべてのライブコピーページに使用します。
We.Retail 参照サイトのルートページが複数のロールアウト設定を使用して設定されている。この場合、MSM では、これらのロールアウト設定をすべてのライブコピーページに使用します。
We.Retail 参照サイトのルートページが複数のロールアウト設定を使用して設定されており、ライブコピーサイトのルートページが別のロールアウト設定のセットを使用して設定されている。この場合、MSM では、ライブコピーサイトのルートページで設定されたロールアウト設定を使用します。

ライブコピーページ用のロールアウト設定の指定 setting-the-rollout-configurations-for-a-live-copy-page

ソースページがロールアウトされる場合に使用するロールアウト設定でライブコピーページを設定します。デフォルトでは、子ページは設定を継承します。使用するロールアウト設定を指定する場合は、ライブコピーページがその親から継承する設定を上書きします。

ライブコピーの作成時に、ライブコピーページ用のロールアウト設定を指定することもできます。

Sites コンソールを使用してライブコピーページを選択します。
ツールバーの「プロパティ」を選択します。
「ライブコピー」タブを開きます。

「設定」セクションには、ページが継承するロールアウト設定が表示されます。
必要に応じて、「ライブコピーの継承」フラグを調整します。オンにした場合、ライブコピー設定がすべての子で有効になります。
「ロールアウト設定を親から継承」プロパティをオフにして、1 つ以上のロールアウト設定をリストから選択します。

選択したロールアウト設定がドロップダウンリストの下に表示されます。
「保存」をクリックします。