現在表示中:

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

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

インストールされるロールアウト設定とカスタムロールアウト設定

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

ロールアウトトリガー

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

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

注意:

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

インストールされるロールアウト設定

次の表に、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

インストールされる同期アクション

次の表に、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:(String)プロパティ、現在の値および新しい値を識別します。説明を参照してください。

notify ページがロールアウトされた場合にページイベントを送信します。通知が送信されるようにするには、最初にロールアウトイベントを購読する必要があります。  
orderChildren ライブコピーで、子(ノード)をブループリントにおける順序に基づいて並べ替えます。
 
referencesUpdate

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

CQ MSM References Update Action サービスの設定で、除外するノードタイプ、段落項目およびページプロパティを指定します。 

 
targetVersion

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

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

 
targetActivate

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

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

 
targetDeactivate

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

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

 
workflow

target プロパティ(ページの場合のみ)に定義されているワークフローを開始し、ライブコピーをペイロードとして取得します。

ターゲットパスはモデルノードのパスです(例:/etc/workflow/models/request_for_activation/jcr:content/model)。

target:(String)ワークフローモデルのパスです。
mandatory

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

  • ActionSet.ACTION_NAME_REMOVE
  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

このアクションはページに対してのみ使用します。

target:(String)権限を設定するグループの ID です。 
mandatoryContent

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

  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

このアクションはページに対してのみ使用します。

target:(String)権限を設定するグループの ID です。 
mandatoryStructure 特定のユーザーグループに対して、ライブコピーページの ActionSet.ACTION_NAME_REMOVE ACL の権限を読み取り専用に設定します。このアクションはページに対してのみ使用します。 target:(String)権限を設定するグループの ID です。 
VersionCopyAction ソースページが少なくとも 1 回公開されている場合に、公開されているバージョンを使用してライブコピーを更新します。   
PageMoveAction

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

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

PageMoveAction によって、移動前の場所にあるライブコピーページが変更されることはありません。このため、結果としてロールアウト設定では、ステータスはブループリントなしのライブ関係になります。

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

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

prop_referenceUpdate:(Boolean)true に設定すると、参照が更新されます。デフォルト値は true です。

 

productCreateUpdate カタログ内に製品リソースを作成したり、それを更新したりします。このアクションは、次のいずれかの状況で使用することが意図されています。
  • カタログ(またはカタログセクション)を生成またはロールアウトする。
  • ユーザーが製品コンポーネントの同期継承を復元する。
 
markLiveRelationship ローンチにより作成されたコンテンツにライブ関係が存在することを示します。  
catalogRolloutHooks カタログ生成に固有のロールアウトフックを実行します。CatalogGenerator の executePageRolloutHooks および executeProductRolloutHooks メソッドを呼び出します。
AEM Javadocs の com.adobe.cq.commerce.pim.api.CatalogGenerator を参照してください。
 
productUpdate 製品カタログのライブコピー内の製品ページを更新します。  

ロールアウト設定の作成

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

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

プロパティとノードタイプの同期からの除外

対応する同期アクションをサポートする複数の 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 ノードタイプの名前に一致する正規表現です。

注意:

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

注意:

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

CQ MSM Content Update Action - 除外

いくつかのプロパティやノードタイプはデフォルトで除外されています。これらは CQ MSM Content Update Action の OSGi の設定の、Excluded Page Properties の下に定義されています。

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

chlimage_1

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

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

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

警告:

5.5 SP2 より前のバージョンでは、除外されるページプロパティはシステムコンソールの Day CQ WCM Rollout Manager で設定されていました。5.5 SP2 以降のバージョンでは、このパネル内の除外されるページプロパティの設定は無視されます。前述のとおり、ロールアウト時のプロパティの除外は CQ MSM Content Update Action で設定されます。

そのため、5.5 SP2 より前のインストールでこの設定を手動で調整した後に 5.5 SP2 以降のバージョンに更新する場合は、これらの設定を古い設定パネルから新しい設定パネルに手動で転送する必要があります。

参照を更新するための同期の設定

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

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

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

Web コンソールのプロパティ/OSGi プロパティ 説明

Update Reference across nested LiveCopies

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

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

Update Referencing Pages

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

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

使用するロールアウト設定の指定

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

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

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

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

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

ライブコピーページ用のロールアウト設定の指定

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

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

  1. サイトコンソールを使用してライブコピーページを選択します

  2. ツールバーの「プロパティ」を選択します。

  3. ライブコピー」タブを開きます。

    設定」セクションには、ページが継承するロールアウト設定が表示されます。

    chlimage_1
  4. 必要に応じて、ライブコピーの継承フラグを変更します。オンにした場合、ライブコピー設定がすべての子で有効になります。

  5. ロールアウト設定を親から継承」プロパティをオフにして、1 つ以上のロールアウト設定をリストから選択します。

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

    chlimage_1
  6. 保存」をクリックまたはタップします。

ブループリントページ用のロールアウト設定の指定

ブループリントページがロールアウトされる場合に使用するロールアウト設定を使用してブループリントページを設定します。

ブループリントページの子ページがその設定を継承します。使用するロールアウト設定を指定する場合は、ページがその親から継承する設定を上書きできます。

  1. サイトコンソールを使用してブループリントのルートページを選択します。

  2. ツールバーの「プロパティ」を選択します。

  3. ブループリント」タブを開きます。

  4. ドロップダウンセレクターを使用してロールアウト設定を 1 つ以上選択します。

  5. 保存」を選択して更新内容を保持します。

システムのデフォルトのロールアウト設定の指定

システムのデフォルトとして使用するロールアウト設定を指定します。デフォルトを指定するには、OSGi サービスを次のように設定します。

  • Day CQ WCM Live Relationship Manager
    サービス PID は com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Web コンソールまたはリポジトリノードを使用してサービスを設定します。

  • Web コンソールの場合、設定するプロパティの名前は「Default rollout config」です。 
  • リポジトリノードを使用する場合、設定するプロパティの名前は liverelationshipmgr.relationsconfig.default です。

このプロパティの値を、システムのデフォルトとして使用するロールアウト設定のパスに指定します。デフォルト値は /etc/msm/rolloutconfigs/default です。これは、標準のロールアウト設定です。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー