複寫

Adobe Experience Manager as a Cloud Service使用Sling Content Distribution功能，將內容移動至在AEM執行階段以外Adobe I/O上執行的管道服務。

注意

如需詳細資訊，請參閱分送 。

發佈內容的方法

快速取消/發佈 — 計畫取消/發佈

這可讓您立即發佈所選頁面，而無需透過「管理出版物」方法提供其他選項。

如需詳細資訊，請參閱管理出版物。

開啟和關閉時間 — 觸發配置

從「頁面屬性」的「基本」頁簽中可以找到​「開啟時間」​和​「關閉時間」​的其他可能性。

要實現自動複製，您需要在OSGi配置 開啟關閉觸發配置​中啟用​自動複製:

OSGi On Off觸發器配置

管理發佈

「管理出版物」提供的選項比「快速發佈」更多，可包含子頁面、自訂參考、啟動任何適用的工作流程，以及提供在稍後發佈的選項。

將「稍後發佈」選項的資料夾子項納入會叫用「發佈內容樹」工作流程，如本文所述。

您可以在Publishing Fundamentals檔案中找到有關管理發布的更多詳細資訊。

樹激活

注意

此方法應視為已過時，並將於2021年9月30日或之後移除，因為它不會保留狀態，且可擴充性較其他方法低。 Adobe的建議是改用管理發布或工作流程方法

要執行樹激活：

  1. 從AEM「開始」功能表導覽至「工具>部署>發佈」

  2. 選取卡片​publish

  3. 進入發佈Web控制台UI後，選擇Distribute

  4. 在路徑瀏覽器中選擇路徑，根據需要選擇添加節點、樹或刪除，然後選擇​Submit

為獲得最佳效能，使用此功能時請遵循以下准則：

  • 建議一次複製少於100個路徑，並設定500個路徑硬限制。
  • 複製內容的總大小必須低於5 MB。 這僅包括節點和屬性，但不包括任何二進位檔，其中包括工作流程套件和內容套件。

發佈內容樹工作流

您可以選擇​工具 — 工作流 — 模型​並複製​發佈內容樹​現成可用的工作流模型，如下所示：

請勿修改或調用原始模型。 請務必先複製模型，然後修改或叫用該復本。

如同所有工作流程，您也可以透過API叫用。 如需詳細資訊，請參閱以程式設計方式🔗與工作流程互動。

或者，您也可以建立使用Publish Content Tree流程步驟的「工作流模型」來實現此目標：

  1. 從AEM as a Cloud Service首頁，前往​工具 — 工作流程 — 模型

  2. 在「工作流模型」頁面中，按螢幕右上角的​Create

  3. 新增標題和名稱至模型。 如需詳細資訊，請參閱建立工作流模型

  4. 從清單中選擇新建立的模型，然後按​Edit

  5. 在以下窗口中，將「處理步驟」(Process Step)拖放到當前模型流中：

    程序步驟

  6. 按一下流量中的「處理」步驟，然後按扳手圖示選取​設定

  7. 按一下​Process​頁簽，然後從下拉清單中選擇Publish Content Tree

    樹狀激活

  8. 在​參數​欄位中設定任何其他參數。 多個逗號分隔引數可以字串在一起。 例如：

    enableVersion=true,agentId=publish

    注意

    如需參數清單，請參閱下方的​參數​一節。

  9. 按下​Done​以儲存工作流程模型。

參數

  • replicateAsParticipant （布林值，預設值） false)。如果配置為true，則複製使用執行參與者步驟的主體的userid。
  • enableVersion （布林值，預設值） true)。此參數會決定是否在復寫時建立新版本。
  • agentId （字串值，預設值表示僅使用發佈的代理）。建議您明確說明agentId;例如，設定它：發佈。 將代理設定為preview將發佈到預覽服務
  • filters （字串值，預設值表示所有路徑皆已啟用）。可用值包括：
    • onlyActivated — 只有未標示為已啟用的路徑才會啟用。
    • onlyModified — 僅啟用已啟用且修改日期晚於啟用日期的路徑。
    • 上方可以用垂直號「|」來ORed。 例如， onlyActivated|onlyModified。

記錄

樹激活工作流步驟開始時，它將在INFO日誌級別上記錄其配置參數。 啟動路徑時，也會記錄INFO陳述式。

然後，在複製所有路徑後，將記錄最終的INFO語句。

此外，您可以將com.day.cq.wcm.workflow.process.impl以下記錄器的記錄層級增加為「除錯/TRACE」，以取得更多記錄資訊。

如果發生錯誤，工作流程步驟會以WorkflowException終止，其中會包含基礎的例外。

以下是範例發佈內容樹狀結構工作流程期間產生的記錄檔範例：

21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false

21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms

繼續支援

工作流程會以區塊處理內容，每個區塊代表要發佈之完整內容的子集。 如果由於任何原因，工作流被系統停止，它將重新啟動並處理尚未處理的區塊。 記錄陳述式會指出內容已從特定路徑繼續。

復寫API

您可以使用AEM中精選的取代API作為Cloud Service來發佈內容。

如需詳細資訊，請參閱API檔案。

API的基本使用

@Reference
Replicator replicator;
@Reference
ReplicationStatusProvider replicationStatusProvider;

....
Session session = ...
// Activate a single page to all agents, which are active by default
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en");
// Activate multiple pages (but try to limit it to approx 100 at max)
replicator.replicate(session,ReplicationActionType.ACTIVATE, new String[]{"/content/we-retail/en","/content/we-retail/de"});

// ways to get the replication status
Resource enResource = resourceResolver.getResource("/content/we-retail/en");
Resource deResource = resourceResolver.getResource("/content/we-retail/de");
ReplicationStatus enStatus = enResource.adaptTo(ReplicationStatus.class);
// if you need to get the status for more more than 1 resource at once, this approach is more performant
Map<String,ReplicationStatus> allStatus = replicationStatusProvider.getBatchReplicationStatus(enResource,deResource);

使用特定代理進行複製

如上例所示，複製資源時，將僅使用預設活動的代理。 在AEM as aCloud Service中，這只會是名為「發佈」的代理程式，將作者連接至發佈層級。

為支援預覽功能，已新增名為「預覽」的新代理，預設為非作用中。 此代理程式用於將作者連接至預覽層。 如果只想通過預覽代理進行複製，則需要通過AgentFilter顯式選擇此預覽代理。

請參閱下列範例，了解如何執行此作業：

private static final String PREVIEW_AGENT = "preview";

ReplicationStatus beforeStatus = enResource.adaptTo(ReplicationStatus.class); // beforeStatus.isActivated == false

ReplicationOptions options = new ReplicationOptions();
options.setFilter(new AgentFilter() {
  @Override
  public boolean isIncluded (Agent agent) {
    return agent.getId().equals(PREVIEW_AGENT);
  }
});
// will replicate only to preview
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en", options);

ReplicationStatus afterStatus = enResource.adaptTo(ReplicationStatus.class); // afterStatus.isActivated == false
ReplicationStatus previewStatus = afterStatus.getStatusForAgent(PREVIEW_AGENT); // previewStatus.isActivated == true

如果您未提供此類篩選器且僅使用「發佈」代理，則不會使用「預覽」代理，且復寫動作不會影響預覽層。

僅當複製操作包含至少一個預設活動的代理時，才會修改資源的整體ReplicationStatus。 在上例中，情況並非如此，因為復寫僅使用「預覽」代理。 因此，您需要使用新的getStatusForAgent()方法，該方法允許查詢特定代理的狀態。 此方法也適用於「發佈」代理程式。 如果使用提供的代理完成了任何複製操作，則返回非空值。

復寫API路徑和大小限制

建議複製少於100個路徑，其中500個是硬限制。 超過硬限制時，將引發ReplicationException。 如果您的應用程式邏輯不需要原子複製，則可通過將ReplicationOptions.setUseAtomicCalls設定為false來克服此限制，這將接受任意數量的路徑，但在內部建立儲存桶以保持在此限制以下。 每個復寫呼叫傳輸的內容量不得超過5 MB，其中包含節點和屬性，但不得有任何二進位檔（工作流程套件和內容套件視為二進位檔）。

疑難排解

若要疑難排解復寫，請導覽至AEM製作服務Web UI中的復寫佇列：

  1. 從AEM「開始」功能表導覽至「工具>部署>發佈」
  2. 選取卡片​publish
  3. 檢查應為綠色的隊列狀態
  4. 您可以測試與復寫服務的連線
  5. 選擇​Logs​頁簽，該頁簽顯示內容發佈的歷史記錄

如果無法發佈內容，則會從AEM發佈服務還原整個發佈。
在這種情況下，可編輯的主隊列將顯示紅色狀態，應進行審核，以確定哪些項導致取消發佈。 按一下該佇列，其待定項目便會顯示，如有需要，可從中清除單一項目或所有項目。

本頁內容