AEMaaCS:內容片段發佈API因片段無效而失敗

✨ 此內容是AI產生的,可能不準確。 產生AI辭彙

本文說明如何使用AEM as a Cloud Service /adobe/sites/cf/fragments/publish API發佈內容片段時解決失敗,其中片段會因驗證錯誤從發佈樹狀結構中移除。

說明 description

環境

Adobe Experience Manager as a Cloud Service (AEMaaCS),所有版本。

症狀

嘗試使用/adobe/sites/cf/fragments/publish API發佈內容片段時,片段無法推送至預覽或發佈環境。 下列警告會顯示在錯誤記錄檔中:

片段’

片段未發佈,且任何依賴於它的內容頁面可能無法呈現,影響發行的準備程度。 此問題特定於引用其他片段或資產的片段。 錯誤並未指定哪一個欄位或規則驗證失敗。 其他片段可能會成功發佈,或因不同的訊息(例如「無效參考」)而失敗。

原因

片段無法針對其內容片段模式驗證,因為一或多個欄位層級問題,例如超過字元限制、無效列舉值、缺少必填欄位或不允許的參考模式。 發佈工作流程會從發佈樹狀結構中移除無效的片段,以防止不一致的內容部署。

解決方法 resolution

請依照下列步驟解決問題。

  1. 在作者環境中執行GET要求給/adobe/sites/cf/fragments/<fragment-uuid>。

  2. 檢閱回應中的validationStatus區段,以取得哪些欄位驗證失敗的詳細資料。

  3. 或者,在內容片段編輯器中開啟片段,並檢查主要和所有變數是否有驗證錯誤。

  4. 處理任何標幟的欄位,例如:

    — 單行文字欄位超過255個字元(若未在模型中設定則為預設限制)。

    — 目前模型不允許值的下拉式(列舉)欄位。

    — 任何變數中必要的欄位都留空。

    — 包含超過模型允許的專案數的欄位。

    — 不存在資產或影像路徑。

    — 欄位不允許使用模型的參考片段。

    — 當前模型中不再定義的欄位資料(例如,模型更改後)。

    ​5. 進行更正後儲存片段。
    ​6. 使用/adobe/sites/cf/fragments/publish API或AEM UI重新發佈片段。
    ​7. 確認片段現在可在預覽/發佈環境中使用,且相依內容會如預期般呈現。

recommendation-more-help
experience-cloud-kcs-help-kbarticles