内容片段模型

注意

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. 从工具栏中选择您的型号,然后选择​取消发布
    发布状态将在控制台中指示。

在此页面上