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
请按照以下步骤解决问题。
-
在创作环境中对
/adobe/sites/cf/fragments/<fragment-uuid>运行GET请求。 -
有关哪些字段验证失败的详细信息,请查看响应中的
validationStatus部分。 -
或者,在内容片段编辑器中打开片段,并检查主变体和所有变体是否存在验证错误。
-
处理任何标记的字段,例如:
— 单行文本字段超过255个字符(如果未在模型中设置,则为默认限制)。
— 下拉列表(枚举)字段具有当前模型不允许的值。
— 必填字段在任何变化中都留空。
— 包含模型所允许的项目多的字段。
— 不存在资产或图像路径。
— 引用的片段,其模型不允许用于该字段。
— 当前模型中不再定义的字段数据(例如,模型更改后)。
5. 进行更正后保存片段。
6. 使用/adobe/sites/cf/fragments/publish API或AEM UI重新发布片段。
7. 确认片段现在在预览/发布环境中可用,并且依赖内容按预期呈现。