内容片段模型

Adobe Experience Manager (AEM) as a Cloud Service 中的内容片段模型定义内容片段的内容结构。随后可使用这些片段创作页面或作为 Headless 内容的基础。

要使用内容片段模型，您可以：

1. 为您的实例启用内容片段模型功能
2. 创建和配置，内容片段模型
3. 启用您的内容片段模型，以便在创建内容片段时使用
4. 通过配置策略，允许在所需的 Assets 文件夹上创建内容片段模型。

创建内容片段模型

1. 导航到​“工具”、“常规”，然后打开​“内容片段模型”。

2. 导航到适合您的配置或子配置的文件夹。

3. 使用​创建​打开向导。

   注意

   如果尚未允许使用内容片段模型，则将没有​创建​选项可用。

4. 指定​模型标题。还可定义多种属性；例如，添加​标记、描述，如果需要，请选择​启用模型​以启用模型，并定义
   默认预览 URL 模式。

   注意

   有关完整详细信息，请参阅内容片段模型 - 属性。

   

5. 使用​创建​保存空模型。随后将显示一条消息，指示操作成功，您可选择​打开​以立即编辑模型或选择​完成​以返回控制台。

内容片段模型 – 属性

在您创建模型时定义这些属性，随后可用内容片段模型的​属性​选项编辑这些属性：

• 基本

  • 模型标题

  • 标记

  • 描述

  • 启用模型

  • 默认预览 URL 模式
    通过内容片段编辑器，作者可在外部前端应用程序中​预览​其内容。在配置​预览服务​后，添加该前端应用程序的 URL。

    预览 URL 应遵循此模式：
    https://<preview_url>?param=${expression}

    可用的表达式为：

    • ${contentFragment.path}
    • ${contentFragment.model.path}
    • ${contentFragment.model.name}
    • ${contentFragment.variation}
    • ${contentFragment.id}

  • 上传图像

定义内容片段模型

内容片段模型使用一批​数据类型​有效地定义所得内容片段的结构。可使用模型编辑器添加数据类型的实例，然后配置它们以创建必填字段：

1. 导航到​工具、常规，然后打开​内容片段模型。

2. 导航到容纳您的内容片段模型的文件夹。

3. 打开所需的模型进行​“编辑”；使用快速操作或选择模型，然后从工具栏中选择操作。

   打开模型编辑器后，会显示：

   • 左：字段已定义
   • 右侧：可用于创建字段的​数据类型（可在创建字段后使用的​属性）
   注意

   将字段定义为​必填​时，将为左侧窗格中所示的​标签​标星号 (*)。

1. 添加字段

   • 将字段的必需数据类型拖到所需位置：

     

   • 将字段添加到模型后，右侧面板将显示可以为该特定数据类型定义的​属性。您可以在此定义该字段的必需内容。

     • 许多属性的含义一目了然，有关更多详细信息，请参阅属性。

     • 键入​字段标签​将自动补全​属性名称 - 如果为空，则以后可手动更新它。

       注意

       在手动更新数据类型的​属性名称​属性时，名称必须​仅​包含 A-Z、a-z、0-9 和作为特殊字符的下划线“_”。

       如果在 AEM 早期版本中创建的模型包含非法字符，请移除或更新这些字符。

     例如：

     

2. 移除字段

   选择必填字段，然后选择垃圾桶图标。 系统会要求您确认该操作。

   

3. 添加所有必填字段，并根据需要定义相关属性。例如：

   

4. 选择​“保存”​来保留定义。

数据类型

有一批数据类型可用于定义您的模型：

• 单行文本

  • 添加单行文本的一个或多个字段；可以定义最大长度

• 多行文本

  • 一个文本区域，它可为富文本、纯文本或 Markdown
  注意

  在模型中由​默认类型​属性定义该文本区域是富文本、纯文本还是 Markdown。

  无法从内容片段编辑器更改此格式，而只能从模型更改。

• 数字

  • 添加一个或多个数字字段

• 布尔型

  • 添加布尔复选框

• 日期和时间

  • 添加日期和/或时间

• 枚举

  • 添加一组复选框、单选按钮或下拉列表字段

• 标记

  • 允许片段作者访问和选择标记区域

• 内容引用

  • 引用任何类型的其他内容；可用于创建嵌套内容
  • 如果图像被引用，您可以选择显示缩略图

• 片段引用

  • 引用其他内容片段；可用于创建嵌套内容
  • 数据类型可配置为允许片段作者执行以下操作：
    • 直接编辑引用的片段。
    • 根据相应的模型创建新内容片段

• JSON 对象

  • 使内容片段作者可将 JSON 语法输入到片段的相应元素中。
    • 使 AEM 可存储您从另一服务复制/粘贴的直接 JSON。
    • JSON 将被传递，并在 GraphQL 中作为 JSON 输出。
    • 在内容片段编辑器中包括 JSON 语法高亮显示、自动补全和错误高亮显示。

• 选项卡占位符

  • 允许引入选项卡，以供在编辑内容片段内容时使用。

    • 这些选项卡在模型编辑器中显示为分隔条，用于分隔内容数据类型的列表的各个部分。每个实例表示一个新选项卡的开始。
    • 在片段编辑器中，每个实例都显示为一个选项卡。
    注意

    此数据类型仅用于格式设置，因此 AEM GraphQL 架构会忽略此数据类型。

属性

许多属性含义一目了然，对于某些属性，其他详细信息如下：

• 属性名称

  在手动更新数据类型的此属性时，名称​必须仅​包含 A-Z、a-z、0-9 和作为特殊字符的下划线“_”。

  注意

  如果在 AEM 早期版本中创建的模型包含非法字符，请移除或更新这些字符。

• 呈现为
  用于在片段中实现/呈现字段的各种选项。通常，这允许您定义作者是看到字段的单个实例，还是允许作者创建多个实例。

• 字段标签
  输入 字段标签 自动生成 属性名称，如有必要，可以手动更新。

• 验证
  基本验证可由以下机制提供： 必需 属性。某些数据类型具有附加的验证字段。请参阅验证，了解更多详细信息。

• 对于数据类型​多行文本，可将​默认类型​定义为以下任一类型：

  • 富文本
  • Markdown
  • 纯文本

  如果未指定，则默认值​富文本​用于此字段。

  在编辑器中打开并保存现有相关的内容片段后，更改内容片段模型中的​默认类型​才对该片段生效。

• 唯一
  （特定字段的）内容必须在从当前模型创建的所有内容片段上都唯一。

  用于确保内容作者不能重复已添加到同一模型的另一个片段中的内容。

  例如，内容片段模型中名为 Country 的​单行文本​字段在两个相关内容片段中不能具有值Japan。尝试第二个实例时会发出警告。

  注意

  确保每个语言根的唯一性。

  注意

  变体可以具有与同一片段变体相同的​唯一​值，但与其他片段变体中使用的值不同。

• 有关特定数据类型及其属性的更多详细信息，请参阅​内容参考。

• 有关特定数据类型及其属性的更多详细信息，请参阅​片段引用（嵌套片段）。

• 可翻译

  选中内容片段模型编辑器中字段上的​可翻译​复选框将：

  • 如果属性名称尚不存在，请确保字段的属性名称已添加到翻译配置上下文/content/dam/<sites-configuration>。
  • 对于 GraphQL：请将 <translatable>Content Fragment 字段上的属性设置为 yes，以允许 GraphQL 查询过滤仅包含可翻译内容的 JSON 输出。

验证

现在，各种数据类型都可以定义在结果片段中输入内容时的验证要求：

• 单行文本
  • 与预定义正则表达式进行比较。
• 数字
  • 检查特定值。
• 内容引用
  • 测试特定类型的内容。
  • 只能引用指定文件大小或更小的资源。
  • 只能引用预定义的宽度和/或高度范围（以像素为单位）内的图像。
• 片段引用
  • 为特定的内容片段模型测试。

使用引用表单嵌套内容

内容片段可以使用以下任一数据类型形成嵌套内容：

• 内容引用

  • 提供对其他内容的简单引用；任何类型的。
  • 可以为一个或多个引用（在生成的片段中）配置。

• 片段引用（嵌套片段）

  • 引用其他片段，具体取决于指定的特定模型。

  • 允许您包含/检索结构化数据。

    注意

    当您使用通过 GraphQL 使用内容片段投放 Headless 内容时，此方法尤其值得关注。

    * 可为（所得片段中的）一个或多个引用配置它。

内容引用

通过内容引用，可从图像、页面或体验片段等另一来源呈现内容。

除了标准属性之外，您还可以指定：

• 根路径，它指定要将任何引用的内容存储在何处

  注意

  如果您在使用内容片段编辑器时要在此字段中直接上传并引用图像，则必须指定此属性。

  有关进一步详细信息，请参阅引用图像。

• 可引用的内容类型

  注意

  如果您在使用内容片段编辑器时要直接在此字段中上传并引用图像，则其中必须包括​图像。

  有关进一步详细信息，请参阅引用图像。

• 文件大小限制

• 如果引用了图像：

  • 显示缩略图
  • 图像高度和宽度的限制

片段引用（嵌套片段）

片段引用将引用一个或多个内容片段。在检索内容以供用于您的应用程序时，此功能尤其值得关注，因为通过此功能可检索有多层的结构化数据。

例如：

• 定义员工详细信息的模型；包括：
  • 对定义雇主（公司）的模型的引用

type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}

除了标准属性之外，您还可以定义：

• 呈现为:

  • 多字段 – 片段作者可以创建多个单个引用

  • 片段 – 允许片段作者选择对片段的单个引用

• 模型类型
  可以选择多个模型。在添加对内容片段的引用时，必须使用这些模型创建任何引用的片段。

• 根路径
  这会为引用的任何片段指定根路径。

• 允许创建片段

  这将允许片段作者根据相应的模型创建片段。

  • 片段引用组合 – 允许片段作者通过选择多个片段来构建复合

  

启用或禁用内容片段模型

可​启用​或​禁用​内容片段模型，从而全面控制其使用。

启用内容片段模型

创建模型后必须启用它，以使其：

• 可在创建内容片段时进行选择。
• 可以在内容片段模型中引用。
• 可用于 GraphQL；这样就会生成架构。

要启用标记为以下任一类型的模型：

• 草稿：新（从未启用）。
• 已禁用：已被特别禁用。

您可以从以下任一位置使用​“启用”​选项：

• 选择所需的“模型”时，顶部工具栏。
• 相应的快速操作（将鼠标悬停在所需模型上）。

禁用内容片段模型

也可以禁用模型，这样：

• 该模型将无法再用来创建​新​内容片段。
• 但是:
  • GraphQL 架构一直在生成，并且仍可查询（以避免影响 JSON API）。
  • 仍可以从 GraphQL 端点查询和返回任何基于模型的内容片段。
• 该模型无法再次引用，但现有引用将保持不变，并且仍可以从 GraphQL 端点查询和返回。

要禁用标为​已启用​的模型，可从以下任意一处使用​禁用​选项：

• 选择所需的“模型”时，顶部工具栏。
• 相应的快速操作（将鼠标悬停在所需模型上）。

允许在 Assets 文件夹中使用内容片段模型

要实施内容管理，您可以在 Assets 文件夹中配置​策略，以控制允许在该文件夹中创建片段的内容片段模型。

要为​允许的内容片段模型​配置​策略：

1. 导航并打开​属性，以访问所需的 Assets 文件夹。

2. 打开​策略​选项卡，您可以在其中配置：

   • 继承自<folder>

     在创建新的子文件夹时自动继承策略；如果子文件夹需要允许模型与父文件夹不同，则可重新配置策略（并中断继承）。

   • 按照路径允许的内容片段模型

     可以允许使用多个模型。

   • 按标记允许的内容片段模型

     可以允许使用多个模型。

   

3. 保存​任何更改。

文件夹允许的内容片段模型解析如下：

• 针对​允许的内容片段模型​的​策略。
• 如果为空，请尝试使用继承规则确定策略。
• 如果继承链未投放结果，请查看 Cloud Services 文件夹的配置（也请先直接配置，然后通过继承配置）。
• 如果以上所有内容均未提供任何结果，则该文件夹不允许使用模型。

删除内容片段模型

要删除内容片段模型，请执行以下操作：

1. 导航到​工具、常规，然后打开​内容片段模型。

2. 导航到容纳您的内容片段模型的文件夹。

3. 选择您的模型，然后从工具栏中选择​删除。

   注意

   如果引用该模型，则显示一条警告，以使您可执行适当的操作。

发布内容片段模型

需要在发布任何从属的内容片段时/之前发布内容片段模型。

要发布内容片段模型，请执行以下操作：

1. 导航到​工具、常规，然后打开​内容片段模型。

2. 导航到容纳您的内容片段模型的文件夹。

3. 选择您的模型，然后从工具栏中选择​发布。随后将在控制台中显示已发布状态。

   注意

   如果发布尚未发布其模型的内容片段，则将有一个选择列表指出这一点，并将与该片段一起发布模型。

取消发布内容片段模型

如果没有任何片段引用内容片段模型，则可取消发布这些模型。

要取消发布内容片段模型，请执行以下操作：

1. 导航到​工具、常规，然后打开​内容片段模型。

2. 导航到容纳您的内容片段模型的文件夹。

3. 选择您的模型，然后从工具栏中选择​取消发布。控制台中会指示已发布状态。

如果尝试取消发布当前由一个或多个片段使用的模型，则显示一条错误警告。例如：

该消息建议您检查引用面板以进一步调查：

锁定（已发布）内容片段模型

此功能为已发布的内容片段模型提供管理服务。

挑战

• 内容片段模型确定 AEM 中 GraphQL 查询的架构。

  • AEM GraphQL 架构在创建内容片段模型后即会创建，并且它们可以同时存在于创作和发布环境中。

  • 发布架构是最为关键，因为它们为 JSON 格式的内容片段的实时投放奠定了基础。

• 修改内容片段模型或进行其他编辑时，可能会出现问题。这意味着架构发生更改，进而可能影响现有 GraphQL 查询。

• 向内容片段模型添加新字段通常不应产生任何有害影响。但是，修改现有数据字段（例如，其名称）或删除字段定义时，将在请求这些字段时中断现有 GraphQL 查询。

要求

• 使用户了解在编辑已用于实时内容投放的模型（即已发布的模型）时的风险。

• 此外，还可以避免意外的更改。

如果重新发布经过修改的模型，则这些条件中的任意一项都可能会中断查询。

解决方案

为了解决这些问题，内容片段模型在发布后立即在作者上被​锁定为​只读模式。已锁定​指示此状态：

当模型​已锁定（在“只读”模式下），您可以查看模型的内容和结构，但无法进行编辑。

您可以从控制台或模型编辑器中管理​已锁定​模型：

• 控制台

  从控制台中，您可以使用​解锁​和​锁定​操作管理制度模式：

  

  • 您可以​解锁​用于启用编辑的模型。

    如果您选择​解锁，则显示一条警告，而您必须确认​解锁​操作：
    

    然后，可以打开模型进行编辑。

  • 您之后还可以​锁定​模型。

  • 重新发布模型将立即使它恢复​已锁定（只读）模式。

• 模型编辑器

  • 打开锁定的模型时，系统会发出警告，并会显示三个操作：取消、查看只读、编辑：

    

  • 如果您选择​查看只读，则您可以查看模型的内容和结构：

    

  • 如果您选择​编辑，则您可以编辑并保存您的更新：

    

    注意

    顶部可能仍会显示警告，但此时模型已由现有内容片段使用。

  • 取消​将带您返回控制台。