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. 在创作环境中对/adobe/sites/cf/fragments/<fragment-uuid>运行GET请求。

  2. 有关哪些字段验证失败的详细信息,请查看响应中的validationStatus部分。

  3. 或者,在内容片段编辑器中打开片段,并检查主变体和所有变体是否存在验证错误。

  4. 处理任何标记的字段,例如:

    — 单行文本字段超过255个字符(如果未在模型中设置,则为默认限制)。

    — 下拉列表(枚举)字段具有当前模型不允许的值。

    — 必填字段在任何变化中都留空。

    — 包含模型所允许的项目多的字段。

    — 不存在资产或图像路径。

    — 引用的片段,其模型不允许用于该字段。

    — 当前模型中不再定义的字段数据(例如,模型更改后)。

    ​5. 进行更正后保存片段。
    ​6. 使用/adobe/sites/cf/fragments/publish API或AEM UI重新发布片段。
    ​7. 确认片段现在在预览/发布环境中可用,并且依赖内容按预期呈现。

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