配置Live Copy同步

Adobe Experience Manager提供許多現成的同步設定。 使用Live Copy之前,您應考慮下列事項,以定義Live Copy與其來源內容同步的方式和時間。

  1. 決定現有的轉出設定是否符合您的需求
  2. 如果現有的轉出設定沒有,請決定您是否需要建立自己的轉出設定。
  3. 指定要用於Live Copy的轉出設定。

安裝和自訂轉出設定

本節提供有關已安裝轉出設定及其使用的同步動作,以及如有需要如何建立自訂設定的資訊。

注意

更新或變更現成可用的轉出設定是​not​建議。 如果需要自訂即時動作,則應將其新增至自訂轉出設定。

轉出觸發器

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

  • 轉出時:Rollout ​命令用於藍色打印頁,或Live Copy ​頁上使用Synchronized命令。
  • 修改時:已修改源頁。
  • 啟動時:源頁面已激活。
  • 停用時:源頁面已停用。
注意

使用​On Modification​觸發器可能會影響效能。 如需詳細資訊,請參閱MSM最佳實務

轉出設定

下表列出隨AEM提供的現成轉出設定。 表格包含每個轉出設定的觸發和同步動作。

名稱 說明 觸發器 同步操作
標準轉出設定 標準轉出設定可允許轉出觸發時開始轉出程式並執行動作:建立、更新、刪除內容和訂購子節點 於轉出 contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
在 Blueprint 啟動時啟動 發佈來源時發佈即時副本 啟動時 targetActivate
在 Blueprint 停用時停用 停用來源時停用即時副本 停用時 targetDeactivate
在發生修改時推送 修改來源時推送內容至Live Copy
使用「修改時」觸發時,請謹慎使用此轉出設定。
於修改 contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
在發生修改時推送 (淺層) 修改Blueprint頁面時推送內容至Live Copy,而不更新參照(例如淺層復本)
使用「修改時」觸發器時,請謹慎使用此轉出設定。
於修改 contentUpdate
contentCopy
contentDelete
orderChildren
提升啟動 提升啟動頁面的標準轉出設定。 於轉出 contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship

同步操作

下表列出隨AEM提供的現成同步動作。

動作名稱 說明 屬性
contentCopy 當Live Copy上不存在源節點時,此操作會將節點複製到Live Copy。 設定 CQ MSM Content Copy Actionservice以 指定要排除的節點類型、段落項目和頁面屬性。
contentDelete 此操作會刪除源上不存在的Live Copy節點。 設定 CQ MSM內容刪除 動作服務,以指定要排除的節點類型、段落項目和頁面屬性。
contentUpdate 此動作會使用來源的變更來更新Live Copy內容。 設定 CQ MSM內容更新動 作服務,以指定要排除的節點類型、段落項目和頁面屬性。
editProperties 此動作會編輯即時副本的屬性。 editMap屬性決定要編輯的屬性及其值。 editMap屬性的值必須使用下列格式:
[property_name_n]#[current_value]#[new_value]
current_valuenew_value是規則運算式,而n是遞增的整數。
例如,請考量下列值: editMap
sling:resourceType#/(contentpage´ homepage)#/mobilecontentpage,cq:template#/contentpage#/mobilecontentpage
此值編輯Live Copy節點的屬性,如下所示:
sling:resourceType 為或設為的 contentpagehomepage 性會設為 mobilecontentpage
cq:template 定為的 contentpage 屬性設 mobilecontentpage定。
editMap: (String) 識別屬性、目前值和新值。如需詳細資訊,請參閱說明。
notify 此動作會傳送已推出頁面的頁面事件。 若要收到通知,需先訂閱轉出事件。
orderChildren 此動作會根據Blueprint上的順序來排序子節點。
referencesUpdate 此同步動作會更新Live Copy上的參考。
它會搜尋「即時副本」頁面中指向Blueprint內之資源的路徑。找到後,會更新路徑,以指向即時副本中的相關資源。 在Blueprint外具有目標的參照不會變更。
設定CQ MSM References Update Actionservice ,以 指定要排除的節點類型、段落項目和頁面屬性。
targetVersion 此動作會建立即時副本的版本。
此動作必須是轉出設定中唯一包含的同步動作。
targetActivate 此動作會啟動「即時副本」。
此動作必須是轉出設定中唯一包含的同步動作。
targetDeactivate 此動作會停用即時副本。
此動作必須是轉出設定中唯一包含的同步動作。
workflow 此動作會啟動目標屬性定義的工作流程(僅適用於頁面),並將即時副本作為裝載。
目標路徑是模型節點的路徑。
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 如果Blueprint/來源頁面至少已發佈一次,此動作會使用已發佈的版本建立「即時副本」頁面。 注意:此動作僅適用於根據已發佈的來源頁面建立「即時副本」頁面,不適用於更新現有的「即時副本」頁面。
PageMoveAction PageMoveAction會在頁面已移入Blueprint時套用。
動作會複製,而非將「即時副本」(相關)頁面從移動前的位置移至之後的位置。
PageMoveAction 動前的位置不會變更即時副本頁面。因此,對於連續轉出設定,其狀態為即時關係,沒有藍圖。
設定 CQ MSM頁面移動 動作服務,以指定要排除的節點類型、段落項目和頁面屬性。
此動作必須是轉出設定中唯一包含的同步動作。
prop_referenceUpdate: (Boolean)設為true(預設值)以更新參考。
markLiveRelationship 此動作表示啟動建立的內容存在即時關係。

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

您可以配置多個支援相應同步操作的OSGi服務,以使其不影響特定節點類型和屬性。 例如,Live Copy中不應包含許多與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頁面移動動作 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 匹配要從同步操作中排除的混合節點類型名稱的規則表達式(僅適用於contentUpdate操作)

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

預設情況下,會排除數個屬性和節點類型,這些會定義在​CQ MSM內容更新動作​的​排除的頁面屬性​下的OSGi設定中。

依預設,轉出時會排除與下列規則運算式相符的屬性(即未更新):

即時副本排除規則

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

例如,如果您想要將頁面​Title​納入考慮轉出的變更中,請從排除項目移除jcr:title。 例如,使用規則運算式:

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

配置更新引用的同步

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

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

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

Web控制台屬性 OSGi屬性 說明
跨巢狀LiveCopy更新參考 cq.wcm.msm.impl.action.referencesupdate.prop_updateNested 在Web控制台中選擇此選項,或使用儲存庫配置將此布爾屬性設定為true以替換指向位於最頂層Live Copy分支內的任何資源的引用。 僅適用於referencesUpdate操作。
更新引用頁面 cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate 在Web控制台中選擇此選項,或使用儲存庫配置將此布爾屬性設定為true以更新任何引用,以使用原始頁來改為引用Live Copy頁。 僅適用於PageMoveAction

指定要使用的轉出設定

MSM可讓您指定一般使用的轉出設定集,並在需要時,您可以針對特定Live Copy覆寫這些設定。 MSM提供數個位置,用以指定要使用的轉出設定。 位置會決定設定是否套用至特定Live Copy。

下列位置清單可讓您指定要使用的轉出設定,說明MSM如何決定要用於即時副本的轉出設定:

  • 即時副本頁面屬性: 當即時副本頁面設定為使用一或多個轉出設定時,MSM會使用這些轉出設定。
  • Blueprint頁面屬性: 當Live Copy以Blueprint為基礎,且Live Copy頁面未以轉出設定進行設定時,會使用與Blueprint來源頁面相關聯的轉出設定。
  • Live Copy上層頁面屬性: 當Live Copy頁面和Blueprint來源頁面均未使用轉出設定進行設定時,會使用套用至Live Copy頁面上層頁面的轉出設定。
  • 系統預設: 無法判斷Live Copy上層頁面的轉出設定時,會使用系統預設的轉出設定。

例如,Blueprint使用WKND教學課程網站作為來源內容。 從Blueprint建立網站。 下列清單中的每個項目說明使用轉出設定的不同案例:

  • 未將任何Blueprint頁面或Live Copy頁面設定為使用轉出設定。 MSM會對所有Live Copy頁面使用系統預設轉出設定。
  • WKND網站的根頁面已設定數個轉出設定。 MSM會對所有Live Copy頁面使用這些轉出設定。
  • WKND網站的根頁面已設定數個轉出設定,而Live Copy網站的根頁面則設定了一組不同的轉出設定。 MSM會使用在Live Copy網站的根頁面上設定的轉出設定。

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

使用轉出設定設定設定「即時副本」頁面,以在轉出來源頁面時使用。 子頁預設繼承配置。 將轉出設定設為使用時,會覆寫即時副本頁面從其父項繼承的設定。

當您建立Live Copy時,您也可以為Live Copy頁面設定轉出設定。

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

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

  3. 開啟​Live Copy​標籤。

    Configuration​部分顯示頁面繼承的轉出配置。

    上層頁面的即時副本繼承

  4. 如果需要,請調整​即時副本繼承​標幟。 如果已勾選,Live Copy設定對所有子項都有效。

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

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

    覆寫即時副本組態繼承

  6. 按一下或點選​儲存並關閉

設定Blueprint頁面的轉出設定

使用轉出設定設定設定藍圖頁面,以在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,即​標準轉出設定

本頁內容