配置即時拷貝同步

執行下列工作，以控制即時副本與其來源內容同步的方式和時間。

• 決定現有的轉出設定是否符合您的需求，或您是否需要建立一或多個。
• 指定要用於即時副本的轉出設定。

安裝和自訂轉出組態

本節提供有關已安裝的轉出配置及其使用的同步操作的資訊，以及如何根據需要建立自定義配置。

轉出觸發器

每個轉出設定都使用轉出觸發器，導致轉出發生。 轉出設定可使用下列其中一個觸發器：

• 推出時:Rollout ​​命令用於藍色打印頁，或 ​​Synchronization命令用於即時副本頁。

• 修改時:源頁面已修改。

• 啟動時:源頁面被激活。

• 停用時:來源頁面已停用。

安裝的轉出配置

下表列出隨AEM安裝的轉出設定。 該表包括每個轉出配置的觸發器和同步操作。 如果安裝的轉出配置操作不符合您的要求，您可以建立新的轉出配置。

名稱	說明	觸發器	同步操作 另請參見安裝的同步操作
標準轉出設定	標準轉出設定，允許於轉出觸發時開始轉出程序，並執行下列動作: 建立、更新、刪除內容以及排序子節點。	於轉出	contentUpdate contentCopy contentDelete referencesUpdate productUpdate orderChildren
在 Blueprint 啟動時啟動	發佈來源時發佈即時副本。	啟動時	targetActivate
在 Blueprint 停用時停用	停用來源時停用即時副本。	停用	targetDeactivate
在發生修改時推送	修改來源時，將內容推送至即時副本。 使用On Modification觸發器時，請謹慎使用此轉出設定。	於修改	contentUpdate contentCopy contentDelete referencesUpdate orderChildren
在發生修改時推送 (淺層)	在修改藍圖頁面時將內容推送至即時副本，而不更新參照（例如淺層副本）。 使用On Modification觸發器時，請謹慎使用此轉出設定。	於修改	contentUpdate contentCopy contentDelete orderChildren
提升啟動	提升啟動頁面的標準轉出設定。	於轉出	contentUpdate contentCopy contentDelete referencesUpdate orderChildren markLiveRelationship
目錄頁面內容轉出設定	從目錄 Blueprint 套用頁面範本。	於轉出	contentUpdate contentCopy contentDelete referencesUpdate productCreateUpdate orderChildren
目錄頁面更新轉出設定	從目錄藍圖套用目標屬性。 必須在目錄頁面內容轉出設定後執行。	於轉出	catalogRovoltHooks
DPS 發佈轉出設定	DPS Publication轉出設定，允許在首次轉出時排除FolioProducer系結屬性，同時在轉出觸發時開始轉出程式	於轉出	contentUpdate contentCopy contentDelete referencesUpdate orderChildren dpsMetadataFilter
舊版(5.6.0)目錄轉出設定	已棄用。轉出目錄時不使用 MSM，並改用 Catalog Generator。	於轉出	editProperties

安裝的同步操作

下表列出與AEM一起安裝的同步動作。 如果安裝的操作不符合您的要求，則可以建立新的同步操作。

動作名稱	說明	屬性
contentCopy	當源節點在即時拷貝上不存在時，將節點複製到即時拷貝。 配置CQ MSM內容複製操作 服務以指定要排除的節點類型、段落項和頁面屬性。
contentDelete	刪除源上不存在的即時副本的節點。 配置CQ MSM內容刪除操 作服務以指定要排除的節點類型、段落項和頁面屬性。
contentUpdate	使用來源的變更來更新即時副本內容。 設定CQ MSM內容更新動作服 務，以指定要排除的節點類型、段落項目和頁面屬性。
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:（字串）識別屬性、目前值和新值。 有關資訊，請參閱說明。
通知	傳送已推出頁面的頁面事件。 為了獲得通知，您必須先訂閱以推出事件。
orderChildren	在即時副本上，它會根據Blueprint 上的順序，對子項（節點）進行排序
referencesUpdate	在即時副本上，此同步動作會更新參照，例如類似連結。 它會在即時副本頁面中搜尋指向藍圖中資源的路徑。找到時，會更新路徑以指向即時副本中的相關資源（而非藍圖）。 在藍圖以外具有目標的參照不會變更。 設定CQ MSM參考更新動作 服務，以指定要排除的節點類型、段落項目和頁面屬性。
targetVersion	建立即時副本的版本。 此動作必須是轉出設定中包含的唯一同步動作。
targetActivate	啟動即時副本。 此動作必須是轉出設定中包含的唯一同步動作。
targetDeactivate	停用即時副本。 此動作必須是轉出設定中包含的唯一同步動作。
工作流程	啟動由target屬性定義的工作流程（僅適用於頁面），並將即時副本視為裝載。 目標路徑是模型節點的路徑。	目標：（字串）工作流程模型的路徑。
強制	將即時副本頁面上多個ACL的權限設定為特定用戶組的只讀權限。 配置了以下ACL: ActionSet.ACTION_NAME_REMOVE ActionSet.ACTION_NAME_SET_PROPERTY ActionSet.ACTION_NAME_ACL_MODIFY 此動作僅適用於頁面。	目標：（字串）您要設定權限之群組的ID。
mandatoryContent	將即時副本頁面上多個ACL的權限設定為特定用戶組的只讀權限。 配置了以下ACL: ActionSet.ACTION_NAME_SET_PROPERTY ActionSet.ACTION_NAME_ACL_MODIFY 此動作僅適用於頁面。	目標：（字串）您要設定權限之群組的ID。
mandatoryStructure	將ActionSet.ACTION_NAME_REMOVE ACL在即時副本頁上的權限設定為特定用戶組的只讀權限。 此動作僅適用於頁面。	目標：（字串）您要設定權限之群組的ID。
VersionCopyAction	如果藍圖／來源頁面至少已發佈一次，請使用已發佈的版本建立即時副本頁面。 注意：此動作僅適用於根據已發佈的來源頁面建立即時副本頁面，不適用於更新現有的即時副本頁面。
PageMoveAction	PageMoveAction會在Blueprint中移動頁面時套用。 動作會複製（相關）LiveCopy頁面，而非將頁面從移動前的位置移至之後的位置。 PageMoveAction不會變更移動前所在位置的LiveCopy頁面。 因此，對於連續的RovoltConfigurations，它的狀態為「即時關係」而無「藍圖」。 配置CQ MSM Page Move Action服 務以指定要排除的節點類型、段落項目和頁面屬性。 此動作必須是轉出設定中包含的唯一同步動作。	prop_reference更新：（布爾值）設為true可更新參考。 預設為true。
productCreateUpdate	在目錄中建立或更新產品資源。 此動作應用於下列其中一種情況： 產生或推出目錄（或目錄區段） 用戶恢復產品元件的同步繼承。
markLiveRelationship	表示啟動建立的內容存在即時關係。
catalogRovoltHooks	執行特定目錄產生轉出勾點。 呼叫CatalogGenerator的executePageRovoltHooks和executeProductRovoltHooks方法。 請參閱AEM Javadocs中的com.adobe.cq.commerce.pim.api.CatalogGenerator。
productUpdate	更新產品目錄即時副本中的產品頁面

建立轉出配置

當安裝的轉出配置不符合您的應用程式要求時，您可以建立轉出配置:

• 建立轉出設定。
• 將同步動作新增至轉出設定。

然後，當在藍圖或即時副本頁面上設定轉出設定時，您便可使用新的轉出設定。

從同步中排除屬性和節點類型

您可以配置支援相應同步操作的多個OSGi服務，以便它們不影響特定節點類型和屬性。 例如，許多與AEM內部功能相關的屬性和子節點不應包含在即時副本中。 僅複製與頁面使用者相關的內容。

使用AEM時，有幾種方法可管理此類服務的組態設定；如需詳細資訊和建議的實務，請參閱設定OSGi。

下表列出了可以指定要排除的節點的同步操作。 該表提供了使用Web控制台配置的服務名和使用儲存庫節點配置的PID。

同步操作	Web控制台中的服務名	服務PID
contentCopy	CQ MSM內容複製動作	com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete	CQ MSM內容刪除動作	com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate	CQ MSM內容更新動作	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參考更新動作	com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

下表說明了您可以配置的屬性：

Web控制台屬性/ OSGi屬性	說明
排除的節點類型 cq.wcm.msm.action.excludednodetypes	與要從同步操作中排除的節點類型相匹配的規則運算式。
排除的段落項目 cq.wcm.msm.action.excludedparagraphitems	與要從同步操作中排除的段落項匹配的規則運算式。
排除的頁面屬性 cq.wcm.msm.action.excludedprops	與要從同步操作中排除的頁面屬性相匹配的規則運算式。
忽略Mixin NodeTypes cq.wcm.msm.action.ignoredMixin	僅適用於CQ MSM內容更新動作。 與要從同步操作中排除的mixin節點類型名稱匹配的規則運算式。

CQ MSM內容更新動作——排除

預設情況下，會排除一些屬性和節點類型，這些在​CQ MSM內容更新操作​的OSGi配置中定義，位於​排除的頁面屬性​下。

依預設，在轉出時會排除與下列規則運算式相符的屬性（亦即未更新）:

您可以視需要變更定義排除清單的運算式。

例如，如果您希望將頁面​Title​納入考慮轉出的變更中，請從排除項中移除jcr:title。 例如，使用regex:

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

配置同步以更新引用

您可以配置幾個支援與更新引用相關的相應同步操作的OSGi服務。

使用AEM時，有幾種方法可管理此類服務的組態設定；如需詳細資訊和建議的實務，請參閱設定OSGi。

下表列出了可以為其指定引用更新的同步操作。 該表提供了使用Web控制台配置的服務名和使用儲存庫節點配置的PID。

Web控制台屬性/ OSGi屬性	說明
跨巢狀LiveCopys更新參考 cq.wcm.msm.impl.action.referencesupdate.prop_updateNested	僅適用於CQ MSM參考更新動作。 選擇此選項（Web控制台）或將此布爾屬性設定為true（儲存庫配置），以替換指向位於最頂層LiveCopy分支中的任何資源的引用。
更新參考頁面 cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate	僅適用於CQ MSM Page Move Action。 選擇此選項（Web控制台）或將此布林屬性設定為true（儲存庫配置），以更新任何引用以使用原始頁來改為引用LiveCopy頁。

指定要使用的轉出配置

MSM可讓您指定一般使用的轉出組態集，並在需要時，您可以覆寫特定即時副本的組態集。 MSM提供了幾個位置，用於指定要使用的轉出配置。 位置會決定設定是否套用至特定的即時副本。

以下位置清單可指定使用的轉出組態，說明MSM如何決定要用於即時副本的轉出組態：

• 即時副本頁面屬性: 當即時副本頁面設定為使用一或多個轉出設定時，MSM會使用這些轉出設定。
• Blueprint頁面屬性 ：當即時副本以藍圖為基礎，而即時副本頁面未設定轉出設定時，會使用與Blueprint來源頁面相關聯的轉出設定。
• 即時副本父頁面屬性： 當即時副本頁面和藍圖來源頁面均未設定轉出設定時，會使用套用至即時副本頁面父頁面的轉出設定。
• 系統預設: 當無法判斷即時副本父頁面的轉出設定時，會使用系統預設的轉出設定。

例如，Blueprint使用We.Retail參考網站做為來源內容。 從Blueprint建立網站。 下列清單中的每個項目說明使用轉出組態的不同情形：

• 未將任何藍圖頁面或即時副本頁面設定為使用轉出設定。 MSM對所有即時副本頁面使用系統預設轉出設定。
• We.Retail參考網站的根頁面已設定數個轉出設定。 MSM會針對所有即時副本頁面使用這些轉出設定。
• We.Retail參考網站的根頁面已設定數個轉出設定，而即時副本網站的根頁面則設定了不同的轉出設定集。 MSM使用在即時副本網站的根頁面上設定的轉出設定。

設定即時副本頁面的轉出設定

使用轉出設定來設定即時副本頁面，以便在轉出來源頁面時使用。 預設情況下，子頁繼承配置。 當您設定轉出設定使用時，您會覆寫即時副本頁面繼承自其父項的設定。

您也可以在建立即時副本時，為即時副本頁面設定轉出設定。

1. 使用​Sites​控制台來選擇即時副本頁面。

2. 從工具欄中選擇​屬性。

3. 開啟​即時副本​標籤。

   Configuration​區段顯示頁面繼承的轉出配置。

   

4. 如果需要，請調整​即時副本繼承​標幟。 如果選中此選項，即時副本配置對所有子項都有效。

5. 清除​從父級繼承轉出配置​屬性，然後從清單中選擇一個或多個轉出配置。

   選取的轉出設定會顯示在下拉式清單下方。

   

6. 按一下或點選​Save。

設定Blueprint頁面的轉出設定

使用轉出設定設定來設定藍圖頁面，以便在展開藍圖頁面時使用。

請注意，Blueprint頁面的子頁面繼承配置。 當您設定使用轉出設定時，您可能會覆寫頁面繼承自其父項的設定。

1. 使用​Sites​控制台來選擇Blueprint的根頁面。
2. 從工具欄中選擇​屬性。
3. 開啟​Blueprint​標籤。
4. 使用下拉式選擇器，選取一或多個​轉出組態。
5. 使用​Save​保存更新。

設定系統預設轉出配置

指定轉出配置，以用作系統預設值。 若要指定預設值，請設定OSGi服務：

• Day CQ WCM Live Relationship
  Manager服務PID為
  com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

使用Web控制台或儲存庫節點配置服務。

• 在Web主控台中，要設定的屬性名稱為「預設轉出設定」。
• 使用儲存庫節點時，要配置的屬性的名稱為liverelationshipmgr.relationsconfig.default。

將此屬性值設定為轉出配置的路徑，以用作系統預設值。 預設值為/libs/msm/wcm/rolloutconfigs/default，即​標準轉出設定。