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
請依照下列步驟解決問題。
-
在作者環境中執行GET要求給
/adobe/sites/cf/fragments/<fragment-uuid>。 -
檢閱回應中的
validationStatus區段,以取得哪些欄位驗證失敗的詳細資料。 -
或者,在內容片段編輯器中開啟片段,並檢查主要和所有變數是否有驗證錯誤。
-
處理任何標幟的欄位,例如:
— 單行文字欄位超過255個字元(若未在模型中設定則為預設限制)。
— 目前模型不允許值的下拉式(列舉)欄位。
— 任何變數中必要的欄位都留空。
— 包含超過模型允許的專案數的欄位。
— 不存在資產或影像路徑。
— 欄位不允許使用模型的參考片段。
— 當前模型中不再定義的欄位資料(例如,模型更改後)。
5. 進行更正後儲存片段。
6. 使用/adobe/sites/cf/fragments/publish API或AEM UI重新發佈片段。
7. 確認片段現在可在預覽/發佈環境中使用,且相依內容會如預期般呈現。