使用内容片段

注意

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

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

以Adobe Experience Manager(AEM)为Cloud Service，内容片段允许您设计、创建、管理和发布与页面无关的内容。它们允许您准备内容，准备好在多个位置／多个渠道使用。

内容片段包含结构化内容：

它们基于内容片段模型，该模型预定义所生成片段的结构。
此结构可以介于以下两种类型之间：
- 基本
  - 例如，单行多行文本字段。
  - 可用于准备直接的内容以用于页面创作。
- 复杂
  - 多种数据类型不同的字段的组合，包括文本、数字、布尔值、数据和时间等。
  - 可用于准备更多结构化内容以进行页面创作，或用于投放应用程序。

使用AEM核心组件的Sling Model(JSON)导出功能，内容片段也可以以JSON格式交付。这种投放:

使您能够使用组件管理片段中要传送的元素
允许批量投放，方法是在用于API投放的页面上添加多个内容片段核心组件

本页和以下各页涵盖创建、配置、维护和使用内容片段的任务:

为实例启用内容片段功能
内容片段模型 -启用、创建和定义模型
管理内容片段 -创建您的内容片段；然后，编辑、发布和引用
变量——创作片段内容 -创作片段内容并创建主控的变量
标记 -对片段使用标记语法
使用关联内容 -添加关联内容
元数据——片段属性 -查看和编辑片段属性
将内容片段与GraphQL结合使用，以提供内容以用于您的应用程序。为此，您可以预览JSON输出。

注意

这些页面可以结合以下内容进行阅读：

通信渠道的数量每年都在增加。通常，渠道指投放机制，如：

渠道;例如，桌面、移动设备。
投放形式，以物理渠道;例如，“产品详细信息页”、“产品类别页”（适用于桌面）或“移动网络”（适用于移动设备）、“移动应用程序”。

但是，您（可能）不希望对所有渠道使用完全相同的内容——您需要根据特定渠道优化您的内容。

内容片段允许您：

考虑如何跨目标有效地触及受众。
创建和管理渠道中性编辑内容。
为各种渠道构建内容池。
为特定渠道设计内容变体。
通过插入资产（混合媒体片段）将图像添加到文本。

然后，可以组合这些内容片段，以便在各种渠道上提供体验。

注意

内容片段和**体验片段**是 AEM 中的两个不同功能：

内容片段是编辑内容，可用于访问结构化数据，包括文本、数字和日期等。它们是纯内容，具有定义和结构，但没有其他可视设计和／或布局。
体验片段是经过充分布局的内容；例如，网页的一个片段。

体验片段可以包含内容片段形式的内容，反之则不行。

有关详细信息，另请参阅了解AEM中的内容片段和体验片段。

内容片段和内容服务

AEM Content Services设计为在AEM关注网页之外对内容进行投放和描述。

它们使用标准化方法向非传统AEM网页的渠道提供内容投放，这些方法可供任何客户使用。这些渠道可以包括：

单页应用程序
本机移动应用程序
aem以外的其他渠道和触点

投放是使用JSON导出器以JSON格式生成的。

AEM内容片段可用于描述和管理结构化内容。结构化内容在可包含各种内容类型的模型中进行定义；包括文本、数字数据、布尔值、日期和时间等。

结合AEM核心组件的JSON导出功能，此结构化内容随后可用于向AEM页面以外的渠道提供AEM内容。

注意

有关AEM Sites作为Cloud Service的无头开发的简介，请参见无头和AEM。

注意

AEM还支持片段内容的翻译。

内容类型

内容片段包括：

存储为资产:
- 内容片段（及其变量）可以从资产控制台创建和维护。
- 在内容片段编辑器中创作和编辑。
在页面编辑器中通过内容片段组件（引用组件）使用：
- 内容片段组件对页面作者可用。它允许他们以HTML或JSON格式引用和提供所需的内容片段。
可使用AEM GraphQL API访问。

内容片段是一种内容结构，它：

没有布局或设计（在富文本模式下可以设置一些文本格式）。
包含一个或多个组成部分。
可以包含或连接到图像。
在页面上引用时，可以使用中间内容。
独立于投放机制(即页面、渠道)。

可视资产的片段

为了使作者能够更好地控制其内容，可以将图像添加到内容片段和／或与内容片段集成。

资产可以通过多种方式与内容片段一起使用；各自有其优势：

插入资产片段（混合媒体片段）
- 是片段的一个完整部分（请参阅内容片段的组成部分）。
- 定义资产的位置。
- 有关详细信息，请参阅片段编辑器中的将资产插入片段。
注意

插入到内容片段本身中的可视资产会附加到前一段落。将片段添加到页面时，在添加中间内容时，这些资产会与该段落相关移动。
关联的内容
- 连接到片段；但不是片段的固定部分（请参阅内容片段的组成部分）。
- 提供一定的定位灵活性。
- 在页面上使用片段时，可轻松地使用（作为中间内容）。
- 有关详细信息，请参阅关联内容。
页面编辑器的资产浏览器中的可用资产
- 允许完全灵活地选择资产。
- 提供一定的定位灵活性。
- 不提供为特定片段批准的概念。
- 有关详细信息，请参阅资产浏览器。

内容片段的组成部分

内容片段资产由以下部分（直接或间接）组成：

片段元素
- 元素与包含内容的数据字段关联。
- 您可以使用内容模型创建内容片段。模型中指定的元素（字段）定义片段的结构。这些元素（字段）可以是多种数据类型。
片段段落
- 文本块（通常是多行文本），它们以单个实体分隔。
- 在富文本、标记下拉模式中，段落可以格式化为标题，在这种情况下，它和以下段落同属一个单位。
- 在页面创作过程中启用内容控制。
插入到片段（混合媒体片段）中的资产
- 插入到实际片段中并用作片段内部内容的资产（图像）。
- 嵌入在片段的段落系统中。
- 在页面](/docs/experience-manager-cloud-service/sites/authoring/fundamentals/content-fragments.html?lang=zh-Hans)上使用／引用[片段时，可以设置格式。
- 只能使用片段编辑器添加到片段、从片段中删除片段或在片段中移动片段。无法在页面编辑器中执行这些操作。
- 只能在片段编辑器](/docs/experience-manager-cloud-service/assets/content-fragments/content-fragments-variations.html?lang=zh-Hans#inserting-assets-into-your-fragment)中使用[富文本格式的片段中添加、删除或移动该片段。
- 只能添加到多行文本元素（任何片段类型）。
- 附加到前面的文本（段落）。
  
  注意
  
  通过切换为纯文本格式，可以（无意中）从片段中删除资产。
  
  注意
  
  在页面上使用片段时，资产也可以添加为附加（中间）内容;使用资产浏览器中的关联内容或资产。
关联的内容
- 这是片段外部的内容，但与片段的编辑相关。通常是图像、视频或其他片段。
- 将片段添加到页面时，集合中的单个资产可用于页面编辑器中的片段。这意味着它们是可选的，具体取决于特定渠道的要求。
- 资产通过集合](/docs/experience-manager-cloud-service/assets/content-fragments/content-fragments-assoc-content.html?lang=zh-Hans)与片段关联；关联的集合允许作者决定在创作页面时要使用哪些资产。[
  - 集合可以作为默认内容与片段关联，也可以由作者在片段创作过程中关联。
  - 资产(DAM) 集合是片段关联内容的基础。
- （可选）您也可以将片段本身添加到集合以帮助跟踪。
片段元数据
- 使用资产元数据模式。
- 在以下情况下可以创建标记：
  - 创建和创作片段
  - 或更高版本：
    - 通过从控制台查看／编辑片段属性
    - 通过在片段编辑器中编辑元数据
注意

元数据处理用户档案不适用于内容片段。
母版
- 碎片的一个完整部分
  - 每个内容片段都有一个主控实例。
  - 主控无法删除。
- 主控可在变量下的片段编辑器中访问。
- 主控不是变体，而是所有变体的基础。
变量
- 特定于编辑目的的片段文本的呈现；可以与渠道相关，但不是强制性的，也可以是临时本地修改。
- 创建为主控的副本，但可以根据需要进行编辑；这些变体之间通常存在内容重叠。
- 可以在片段创作过程中定义。
- 存储在片段中，以帮助避免内容副本的散布。
- 如果主控内容已更新，变量可以为synchronized且主控。
- 可以是Asgumated，以快速将文本截断为预定义的长度。
- 位于片段编辑器的变量选项卡下。