執行下列工作,以控制即時副本與其來源內容同步的方式和時間。
本節提供有關已安裝的轉出配置及其使用的同步操作的資訊,以及如何根據需要建立自定義配置。
每個轉出設定都使用轉出觸發器,導致轉出發生。 轉出設定可使用下列其中一個觸發器:
推出時:Rollout 命令用於藍色打印頁,或 Synchronization命令用於即時副本頁。
修改時:源頁面已修改。
啟動時:源頁面被激活。
停用時:來源頁面已停用。
使用「修改時」觸發器會影響效能。 如需詳細資訊,請參閱MSM最佳實務。
下表列出隨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屬性的值必須使用下列格式:
例如,請考慮以下editMap值:
此值編輯即時副本節點的屬性,如下所示:
|
editMap:(字串)識別屬性、目前值和新值。 有關資訊,請參閱說明。 |
通知 | 傳送已推出頁面的頁面事件。 為了獲得通知,您必須先訂閱以推出事件。 | |
orderChildren | 在即時副本上,它會根據Blueprint 上的順序,對子項(節點)進行排序 |
|
referencesUpdate | 在即時副本上,此同步動作會更新參照,例如類似連結。 設定CQ MSM參考更新動作 服務,以指定要排除的節點類型、段落項目和頁面屬性。 |
|
targetVersion | 建立即時副本的版本。 此動作必須是轉出設定中包含的唯一同步動作。 |
|
targetActivate | 啟動即時副本。 此動作必須是轉出設定中包含的唯一同步動作。 |
|
targetDeactivate | 停用即時副本。 此動作必須是轉出設定中包含的唯一同步動作。 |
|
工作流程 | 啟動由target屬性定義的工作流程(僅適用於頁面),並將即時副本視為裝載。 目標路徑是模型節點的路徑。 |
目標:(字串)工作流程模型的路徑。 |
強制 | 將即時副本頁面上多個ACL的權限設定為特定用戶組的只讀權限。 配置了以下ACL:
此動作僅適用於頁面。 |
目標:(字串)您要設定權限之群組的ID。 |
mandatoryContent | 將即時副本頁面上多個ACL的權限設定為特定用戶組的只讀權限。 配置了以下ACL:
此動作僅適用於頁面。 |
目標:(字串)您要設定權限之群組的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節點類型名稱匹配的規則運算式。 |
在Classic UI中,LiveCopy頁面的「頁面屬性」對話方塊中顯示的鎖定圖示不會反映「排除的頁面屬性」屬性的設定。 即使對於從同步操作中排除的屬性,也會顯示鎖定表徵圖。
在啟用觸控的UI中,另請參閱在頁面屬性上配置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如何決定要用於即時副本的轉出組態:
例如,Blueprint使用We.Retail參考網站做為來源內容。 從Blueprint建立網站。 下列清單中的每個項目說明使用轉出組態的不同情形:
使用轉出設定來設定即時副本頁面,以便在轉出來源頁面時使用。 預設情況下,子頁繼承配置。 當您設定轉出設定使用時,您會覆寫即時副本頁面繼承自其父項的設定。
您也可以在建立即時副本時,為即時副本頁面設定轉出設定。
使用Sites控制台來選擇即時副本頁面。
從工具欄中選擇屬性。
開啟即時副本標籤。
Configuration區段顯示頁面繼承的轉出配置。
如果需要,請調整即時副本繼承標幟。 如果選中此選項,即時副本配置對所有子項都有效。
清除從父級繼承轉出配置屬性,然後從清單中選擇一個或多個轉出配置。
選取的轉出設定會顯示在下拉式清單下方。
按一下或點選Save。
使用轉出設定設定來設定藍圖頁面,以便在展開藍圖頁面時使用。
請注意,Blueprint頁面的子頁面繼承配置。 當您設定使用轉出設定時,您可能會覆寫頁面繼承自其父項的設定。
指定轉出配置,以用作系統預設值。 若要指定預設值,請設定OSGi服務:
com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
liverelationshipmgr.relationsconfig.default
。將此屬性值設定為轉出配置的路徑,以用作系統預設值。 預設值為/libs/msm/wcm/rolloutconfigs/default
,即標準轉出設定。