ライブコピーの同期の設定 configuring-live-copy-synchronization
Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、
技術サポート期間. サポートされているバージョンを見つける
ここ.
ライブコピーをソースコンテンツと同期する方法とタイミングを制御するには、次のタスクを実行します。
- 既存のロールアウト設定が要件を満たしているかどうか、または 1 つ以上のロールアウト設定を作成する必要があるかどうかを決定します。
- ライブコピーに使用するロールアウト設定を指定します。
インストールされるロールアウト設定とカスタムロールアウト設定 installed-and-custom-rollout-configurations
この節では、インストールしたロールアウト設定、それらの設定で使用する同期アクション、カスタム設定を作成する方法(必要な場合)について説明します。
インストール済みの標準のロールアウト設定を、更新したり変更したりすることは 推奨しません。カスタムのライブアクションが必要な場合は、カスタムロールアウトの設定で追加してください。
ロールアウトトリガー rollout-triggers
各ロールアウト設定は、ロールアウトトリガーを使用してロールアウトを発生させます。 ロールアウト設定では、次のいずれかのトリガーを使用できます。
-
ロールアウト時:ロールアウト コマンドをブループリントページで使用します。または、同期 コマンドをライブコピーページで使用します。
-
変更時:ソースページが変更されます。
-
アクティベート時:ソースページがアクティベートされます。
-
アクティベート解除時:ソースページがアクティベート解除されます。
インストール済みのロールアウト設定 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 ではなく Catalog Generator を使用してください。
ロールアウト時
editProperties
インストール済みの同期アクション installed-synchronization-actions
次のテーブルに、AEM と共にインストールされる同期アクションのリストを示します。インストールされているアクションが要件を満たさない場合は、新しい同期アクションを作成できます。
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:(String) プロパティ、現在の値および新しい値を識別します。 詳しくは、説明を参照してください。
notify
ページがロールアウトされたページイベントを送信します。 通知が送信されるようにするには、最初にロールアウトイベントを購読する必要があります。
orderChildren
ライブコピーでは、ブループリント上の順序に基づいて子(ノード)を並べ替えます
referencesUpdate
ライブコピーでは、この同期アクションによって、リンクなどの参照が更新されます。
ブループリント内の特定のリソースを指す、ライブコピーページ内のパスを検索します。見つかると、パスが更新され、(ブループリントではなく)ライブコピー内の関連リソースを指すようになります。 ブループリント外のターゲットを持つ参照は変更されません。
CQ MSM References Update Action サービスを設定して、除外するノードタイプ、段落項目、ページプロパティを指定してください。
targetVersion
ライブコピーのバージョンを作成します。
このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。
targetActivate
ライブコピーをアクティベートします。
このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。
targetDeactivate
ライブコピーを非アクティブ化します。
このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。
ワークフロー
target プロパティで定義されているワークフローを開始し(ページの場合のみ)、ライブコピーをペイロードとして取ります。
モデルノードのパスがターゲットパスになります。
ターゲット:(String) ワークフローモデルのパス。
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 は、ページがブループリント内で移動された場合に適用されます。
アクションは、(関連する)LiveCopy ページを移動前の場所から移動後の場所に移動するのではなく、コピーします。
PageMoveAction は、移動前の場所にある LiveCopy ページを変更しません。 したがって、連続する RolloutConfigurations の場合、ブループリントのない LiveRelationship のステータスになります。
CQ MSM Page Move Action サービスを設定して、除外するノードタイプ、段落項目およびページプロパティを指定してください。
このアクションは、ロールアウト設定に含まれる唯一の同期アクションである必要があります。
prop_referenceUpdate:(ブール値)参照を更新するには、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 プロパティ
説明
除外されたノードタイプ
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 ノードタイプの名前に一致する正規表現です。
クラシック UI では、ライブコピーページのページプロパティダイアログボックスに表示されるロックアイコンに、 Excluded Page Properties プロパティの設定が反映されていません。 ロックアイコンは、同期アクションから除外されたプロパティに対しても表示されます。
CQ MSM Content Update Action - 除外 cq-msm-content-update-action-exclusions
いくつかのプロパティとノードタイプは、デフォルトで除外されます。これらは、の OSGi 設定で定義されます。 CQ MSM Content Update Action の下 除外されたページのプロパティ.
デフォルトでは、次の正規表現に一致するプロパティは、ロールアウト時に除外されます(つまり、更新されません)。
必要に応じて、除外リストを定義する表現を変更できます。
例えば、ロールアウトで考慮される変更にページ タイトル を含めるには、除外から jcr:title
を削除します。正規表現は次のようになります。
jcr:(?!(title)$).*
参照を更新するための同期の設定 configuring-synchronization-for-updating-references
参照の更新に関連する、対応する同期アクションをサポートする複数の OSGi サービスを設定できます。
AEM を操作する際は、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項については、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 つ以上のロールアウト設定を選択します。
選択したロールアウト設定がドロップダウンリストの下に表示されます。
-
クリックまたはタップ 保存.
ブループリントページ用のロールアウト設定の指定 setting-the-rollout-configuration-for-a-blueprint-page
ブループリントページがロールアウトされる際に使用するロールアウト設定を含むブループリントページを設定します。
ブループリントページの子ページは設定を継承します。 使用するロールアウト設定を設定する際に、ページが親から継承する設定を上書きできます。
- サイト コンソールを使用してブループリントのルートページを選択します。
- ツールバーの「プロパティ」を選択します。
- 「ブループリント」タブを開きます。
- ドロップダウンセレクターを使用して ロールアウト設定 を 1 つ以上選択します。
- 「保存」を選択して更新内容を保持します。
システムのデフォルトのロールアウト設定の指定 setting-the-system-default-rollout-configuration
システムの既定値として使用するロールアウト設定を指定します。 デフォルトを指定するには、OSGi サービスを設定します。
- Day CQ WCM Live Relationship Manager
サービス PID は
com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
このサービスを設定するには、Web コンソールまたはリポジトリノードを使用します。
- Web コンソールの場合、設定するプロパティの名前は Default rollout config です。
- リポジトリーノードを使用する場合、設定するプロパティの名前は
liverelationshipmgr.relationsconfig.default
です。
このプロパティの値を、システムのデフォルトとして使用するロールアウト設定のパスに指定します。デフォルト値は /libs/msm/wcm/rolloutconfigs/default
です。これは 標準のロールアウト設定 です。