内容片段模型

注意

AEM GraphQL API for Content Fragments投放可应请求提供。

请联系Adobe支持，为AEM启用API作为Cloud Service项目。

内容片段模型定义内容片段的内容结构。

要使用内容片段模型，请：

  1. 为实例启用内容片段模型功能
  2. 创建、配 置内容片段模型
  3. 启用内容片段模 型，以在创建内容片段时使用

创建内容片段模型

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

  2. 导览至适合您的配置的文件夹。

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

    注意

    如果未启用内容片段模型的使用，则​创建​选项将不可用。

  4. 指定​模型标题。如果需要，还可以添加​标记​和​说明。

    标题和说明

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

定义内容片段模型

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

注意

编辑现有内容片段模型可能会影响相关片段。

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

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

  3. 打开​Edit​所需的型号；使用快速操作，或先选择模型，然后从工具栏中选择操作。

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

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

    当字段为​必填字段​时，左窗格中显示的​标签​将标有一个星号标记 (​*)。

  4. 添加字段

    • 将所需数据类型拖动到字段的所需位置。

    • 将字段添加到模型后，右面板将显示可为该特定数据类型定义的​属性。 您可以在此处定义该字段的必需内容。
      许多属性是自解释的，有关其他详细信息，请参阅属性。

  5. 删除字段

    选择所需字段，然后单击／点按垃圾桶图标。 系统将要求您确认该操作。

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

  7. 选择​保存​以保留定义。

数据类型

可以选择数据类型来定义模型：

  • 单行文本
    • 添加一行文本的一个或多个字段；可以定义最大长度
  • 多行文本
    • 可以是富文本、纯文本或标记的文本区域
  • 数字
    • 添加一个或多个数字字段
  • 布尔型
    • 添加布尔复选框
  • 日期和时间
    • 添加日期和／或时间
  • 枚举
    • 添加一组复选框、单选按钮或下拉字段
  • 标记
    • 允许片段作者访问和选择标记区域
  • 内容引用

属性

许多属性是自解释的，对于某些属性，其他详细信息如下：

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

  • 字段
    标签输入
    字段 标签将自动生 成属性名称，然后可以根据需要手动更新该名称。

  • ValidationBasic
    验证可由Required属性等机制 ​​使用。某些数据类型具有附加验证字段。 有关更多详细信息，请参阅验证。

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

    • 富文本
    • Markdown
    • 纯文本

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

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

验证

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

  • 单行文本
    • 与预定义正则表达式进行比较。
  • 数字
    • 检查特定值。

启用或禁用内容片段模型

要完全控制内容片段模型的使用，您可以设置这些模型的状态。

启用内容片段模型

创建模型后，需要启用该模型，以便：

  • 创建新内容片段时可供选择。
  • 可以从内容片段模型中引用。
  • 可用于GraphQL;因此生成模式。

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

  • 草稿 :mew（从未启用）。
  • 禁用 :已特别禁用。

使用​启用​选项，可从以下任一位置进行：

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

启用草图或禁用模型

禁用内容片段模型

还可以禁用模型，以便：

  • 该模型不再作为创建​new​内容片段的基础。
  • 但是:
    • GraphQL模式不断生成，并且仍可查询（以避免影响JSON API）。
    • 仍然可以查询基于模型的任何内容片段并从GraphQL端点返回。
  • 模型不能再被引用，但现有引用保持不变，仍可从GraphQL端点查询和返回。

要禁用标为​Enabled​的模型，请使用以下任一选项中的​Disable​选项：

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

禁用启用的模型

删除内容片段模型

注意

删除内容片段模型可能会影响相关片段。

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

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

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

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

    注意

    如果模型被引用，则会发出警告。 采取适当措施。

发布内容片段模型

内容片段模型需要在发布任何相关内容片段时／之前发布。

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

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

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

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

    注意

    如果发布的内容片段尚未发布模型，则将显示一个选择列表来指示此情况，并且该模型将随片段一起发布。

取消发布内容片段模型

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

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

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

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

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

在此页面上