AEM中的内容片段模型为您的定义了内容结构 内容片段, 作为Headless内容的基础。
要使用内容片段模型,您可以:
导航到“工具”、“常规”,然后打开“内容片段模型”。
导航到适合您的配置或子配置的文件夹。
使用“创建”打开向导。
如果未启用内容片段模型,则**“创建”**选项将不可用。
指定模型标题。您还可以定义各种属性;例如,添加 标记, a 描述,并选择 启用模型 到 启用模型 如有必要。
欲知关于 默认预览URL模式 请参阅 内容片段模型 — 属性.
使用“创建”以保存空模型。将显示一条消息,指示操作是否成功,您可以选择“打开”来立即编辑模型,或“完成”以返回到控制台。
内容片段模型通过选择“数据类型”,有效地定义了结果内容片段的结构。使用模型编辑器,您可以添加数据类型的实例,然后对其进行配置以创建必填字段:
编辑现有内容片段模型可能会影响从属片段。
导航到“工具”、“常规”,然后打开“内容片段模型”。
导航到包含内容片段模型的文件夹。
打开所需的模型进行“编辑”;使用快速操作或选择模型,然后从工具栏中选择操作。
打开模型编辑器后,会显示:
当字段为必填时,左侧窗格中指示的标记会标有星号 (*)。
添加字段
将字段的必需数据类型拖到所需位置:
将字段添加到模型后,右侧面板将显示可以为该特定数据类型定义的属性。您可以在此定义该字段的必需内容。
许多属性的含义一目了然,有关更多详细信息,请参阅属性。
键入字段标签将自动完成属性名称;如果为空,则以后可手动更新。
当为数据类型手动更新某个属性名称时,请注意,名称必须仅包含 A – Z、a – z、0 – 9 和下划线“_”作为特殊字符。
如果在 AEM 早期版本中创建的模型包含非法字符,请移除或更新这些字符。
例如:
移除字段
选择必填字段,然后选择垃圾桶图标。 系统会要求您确认该操作。
添加所有必填字段,并根据需要定义相关属性。例如:
选择“保存”来保留定义。
有一批数据类型可用于定义您的模型:
此数据类型仅用于格式设置,因此 AEM GraphQL 架构会忽略此数据类型。
许多属性含义一目了然,对于某些属性,其他详细信息如下:
属性名称
手动更新数据类型的此属性时,请注意名称必须仅包含** A – Z、a – z、0 – 9 和下划线“_”作为特殊字符。
如果在 AEM 早期版本中创建的模型包含非法字符,请移除或更新这些字符。
呈现为
用于在片段中实现/呈现字段的各种选项。通常,此属性允许您定义作者是看到字段的单个实例,还是允许作者创建多个实例。 时间 多个字段 用于定义项目的最小和最大数量 — 请参阅 验证 以了解更多详细信息。
字段标签
输入 字段标签 将自动生成 属性名称,如有必要,可以手动更新。
验证
基本验证可由以下机制提供: 必需 属性。某些数据类型具有附加的验证字段。请参阅验证,了解更多详细信息。
对于数据类型多行文本,可将默认类型定义为以下任一类型:
如果未指定,则默认值富文本用于此字段。
更改内容片段模型中的默认类型仅会对在编辑器中打开并保存的现有相关内容片段生效。
独特
对于从当前模型创建的所有内容片段,内容(适用于特定字段)必须是唯一的。
用于确保内容作者不能重复已添加到同一模型的另一个片段中的内容。
例如,内容片段模型中名为 Country
的单行文本字段在两个相关内容片段中不能具有值Japan
。尝试第二个实例时会发出警告。
确保每个语言根的唯一性。
变体可以具有与同一片段变体相同的唯一值,但与其他片段变体中使用的值不同。
如果您想使用 MSM(创建内容片段的副本),则应从各个内容片段模型中使用的任何数据类型中删除任何独特的约束。
有关特定数据类型及其属性的更多详细信息,请参阅内容参考。
有关特定数据类型及其属性的更多详细信息,请参阅片段引用(嵌套片段)。
可翻译
选中内容片段模型编辑器中字段上的可翻译复选框将:
/content/dam/<sites-configuration>
。<translatable>
Content Fragment 字段上的属性设置为 yes
,以允许 GraphQL 查询过滤仅包含可翻译内容的 JSON 输出。现在,各种数据类型都可以定义在结果片段中输入内容时的验证要求:
单行文本
数字
内容引用
片段引用
最小项目数 / 项目的最大数量
已定义为 多个字段 (设置 呈现为)提供了以下选项:
已验证以下各项:
内容片段可以使用以下任一数据类型形成嵌套内容:
片段引用(嵌套片段)
引用其他片段,具体取决于指定的特定模型。
让您包含/检索结构化数据。
此方法与使用 GraphQL 内容片段的 Headless 内容投放特别相关。
AEM 具有以下重复保护:
内容引用
这会阻止用户添加对当前片段的引用。这可能导致出现空的片段引用选取器对话框。
GraphQL 中的片段引用
如果创建一个深层查询,且该查询返回多个相互引用的内容片段,则该查询在第一次出现时将返回空值。
内容引用让您呈现来自其他源的内容,例如,图像或内容片段。
除了标准属性之外,您还可以指定:
“片段引用”会引用一个或多个内容片段。在检索应用程序中使用的内容时,此功能特别有意义,因为它让您检索具有多个层的结构化数据。
例如:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
除了标准属性之外,您还可以定义:
呈现为:
多字段 – 片段作者可以创建多个单个引用
片段 – 允许片段作者选择对片段的单个引用
模型类型
可以选择多个模型。在创作内容片段时,必须使用这些模型创建任何引用的片段。
根路径
这会为引用的任何片段指定根路径。
允许创建片段
这将允许片段作者根据相应的模型创建片段。
已建立重复保护机制。它禁止用户在片段引用中选择当前内容片段。这可能导致出现空的片段引用选取器对话框。
GraphQL 还对片段引用提供了定期保护。如果在两个相互引用的内容片段之间创建深层查询,则将返回空值。
您可以编辑内容片段模型的“属性”:
模型标题
标记
描述
上传图像
默认预览 URL 模式
这仅由 新建 内容片段编辑器。 请参阅 内容片段模型 以了解详细信息。
要完全控制内容片段模型的使用,可设置其状态。
创建模型时必须启用该模型,以便:
要启用标记为以下任一类型的模型:
您可以从以下任一位置使用“启用”选项:
也可以禁用模型,这样:
要禁用标记为已启用的模型,您可以使用以下任一选项中的禁用选项:
要实施内容管理,您可以在 Assets 文件夹中配置策略,以控制允许在该文件夹中创建片段的内容片段模型。
该机制类似于允许在页面的高级属性中为页面及其子页面设置页面模板。
要为允许的内容片段模型配置策略:
导航并打开属性,以访问所需的 Assets 文件夹。
打开策略选项卡,您可以在其中配置:
继承自<folder>
创建新子文件夹时,会自动继承策略;如果子文件夹需要允许与父文件夹不同的模型,则可以重新配置策略(并中断继承)。
按照路径允许的内容片段模型
可以允许使用多个模型。
按标记允许的内容片段模型
可以允许使用多个模型。
保存任何更改。
文件夹允许的内容片段模型解析如下:
删除内容片段模型可能会影响从属片段。
要删除内容片段模型,请执行以下操作:
导航到“工具”、“常规”,然后打开“内容片段模型”。
导航到包含内容片段模型的文件夹。
选择您的模型,然后从工具栏中删除。
如果引用了模型,则会发出警告。采取适当措施。
在发布任何相关内容片段时/之前,需要发布内容片段模型。
要发布内容片段模型,请执行以下操作:
导航到“工具”、“常规”,然后打开“内容片段模型”。
导航到包含内容片段模型的文件夹。
选择您的模型,然后从工具栏中“发布”。
控制台中会指示已发布状态。
如果发布的内容片段的模型尚未发布,则会显示一个选择列表来指示该情况,并且模型会随该片段一起发布。
如果任何片段未引用内容片段模型,则可以取消发布这些模型。
要取消发布内容片段模型,请执行以下操作:
导航到“工具”、“常规”,然后打开“内容片段模型”。
导航到包含内容片段模型的文件夹。
选择您的模型,然后从工具栏中选择取消发布。控制台中会指示已发布状态。
如果您尝试取消发布一个或多个片段当前使用的模型,则会出现错误警告,通知您:
该消息建议您检查引用面板,以进一步调查:
此功能为已发布的内容片段模型提供管理服务。
内容片段模型确定 AEM 中 GraphQL 查询的架构。
AEM GraphQL 架构在创建内容片段模型后即会创建,并且它们可以同时存在于创作和发布环境中。
发布架构是最为关键,因为它们为 JSON 格式的内容片段的实时投放奠定了基础。
修改内容片段模型或进行其他编辑时,可能会出现问题。这意味着架构发生更改,进而可能影响现有 GraphQL 查询。
向内容片段模型添加新字段通常不应产生任何有害影响。但是,修改现有数据字段(例如,其名称)或删除字段定义时,将在请求这些字段时中断现有 GraphQL 查询。
使用户了解在编辑已用于实时内容投放的模型(即已发布的模型)时的风险。
此外,还可以避免意外的更改。
如果重新发布修改后的模型,这两种情况下都可能中断查询。
为了解决这些问题,内容片段模型在发布后立即在作者上被锁定为只读模式。表示为 已锁定:
当模型已锁定(在“只读”模式下),您可以查看模型的内容和结构,但无法进行编辑。
您可以从控制台或模型编辑器中管理已锁定模型:
控制台
从控制台中,您可以使用解锁和锁定操作管理制度模式:
您可以解锁用于启用编辑的模型。
如果您选择解锁,则会显示警告,您必须确认解锁操作:
然后,可以打开模型进行编辑。
您之后还可以锁定模型。
重新发布模型会立即将其重新发布为已锁定(只读)模式。
模型编辑器
打开锁定的模型时,系统会发出警告,并会显示三个操作:取消、查看只读、编辑:
如果您选择“查看只读”,则您可以查看模型的内容和结构:
如果您选择“编辑”,则您可以编辑并保存更新:
顶部可能仍会显示警告,但此时模型已由现有内容片段使用。
“取消”则将返回控制台。