AEM中的内容片段模型定义内容片段的内容结构,用作无头内容的基础。
要使用内容片段模型,您可以:
导航到工具、资产,然后打开内容片段模型。
导航到适合您的配置的文件夹。
使用Create打开向导。
如果对内容片段模型的使用尚未启用,则创建选项将不可用。
指定模型标题。您还可以添加Tags、Description,并根据需要选择将模型启用到启用模型。
使用Create保存空模型。 将显示一条消息,指示操作成功,您可以选择打开以立即编辑模型,或选择完成以返回到控制台。
内容片段模型使用数据类型的选项有效地定义了生成的内容片段的结构。 使用模型编辑器,您可以添加数据类型的实例,然后对其进行配置以创建必填字段:
编辑现有内容片段模型可能会影响依赖的片段。
导航到工具、资产,然后打开内容片段模型。
导航到包含内容片段模型的文件夹。
打开Edit所需的模型;使用快速操作,或选择模型,然后从工具栏中选择操作。
打开模型编辑器后,会显示:
当字段为必填字段时,左窗格中显示的标签将标有一个星号标记 (*)。
添加字段
将字段的必需数据类型拖到所需位置:
将字段添加到模型后,右侧面板将显示可为该特定数据类型定义的属性。 您可以在此定义该字段的必需内容。
许多属性都不言而喻,有关更多详细信息,请参阅属性。
键入字段标签将自动完成属性名称 — 如果为空,随后可手动更新。
手动更新数据类型的属性属性名称时,请注意,名称必须仅包含拉丁字符、数字和下划线“_”作为特殊字符。
如果在AEM早期版本中创建的模型包含非法字符,请删除或更新这些字符。
例如:
删除字段
选择必填字段,然后单击/点按垃圾桶图标。 系统将要求您确认该操作。
添加所有必填字段,并根据需要定义相关属性。 例如:
选择Save以保留定义。
可以选择数据类型以定义模型:
允许引入选项卡,以在编辑内容片段内容时使用。
这将在模型编辑器中显示为分隔符,用于分隔内容数据类型列表的各个部分。 每个实例表示新选项卡的开头。
在片段编辑器中,每个实例都将显示为一个选项卡。
此数据类型仅用于格式设置,因此AEM GraphQL架构会忽略此数据类型。
许多属性不言而喻,对于某些属性,其他详细信息如下:
属性名称
在手动更新数据类型的此属性时,请注意,名称必须只包含**拉丁字符、数字和下划线“_”作为特殊字符。
如果在AEM早期版本中创建的模型包含非法字符,请删除或更新这些字符。
呈现
方式用于在片段中实现/呈现字段的各种选项。通常,这允许您定义作者将看到字段的单个实例,还是允许创建多个实例。
字段
标签输入
字段 标签将自动生成 属性名称,然后可以根据需要手动更新属性名称。
ValidationBasic验证可由Requiredproperty等机制 使用。某些数据类型具有附加的验证字段。 有关更多详细信息,请参阅验证。
对于数据类型多行文本,可将默认类型定义为以下任一类型:
如果未指定,则此字段将使用默认值富文本。
更改内容片段模型中的默认类型仅会对在编辑器中打开并保存的现有相关内容片段生效。
对于从当前模型创建的所有内容片段,UniqueContent(对于特定字段)必须是唯一的。
用于确保内容作者不能重复已在同一模型的另一个片段中添加的内容。
例如,内容片段模型中名为Country
的单行文本字段不能在两个从属内容片段中具有值Japan
。 尝试第二个实例时将发出警告。
确保每个语言根的唯一性。
变量可以具有与同一片段的变量相同的唯一值,但与其他片段的任何变量中使用的值不同。
有关该特定数据类型及其属性的更多详细信息,请参阅内容引用。
有关该特定数据类型及其属性的更多详细信息,请参阅片段引用(嵌套片段)。
各种数据类型现在包括定义在结果片段中输入内容时的验证要求:
内容片段可以使用以下任一数据类型形成嵌套内容:
片段引用 (嵌套片段)
引用其他片段,具体取决于指定的特定模型。
允许您包含/检索结构化数据。
此方法特别需要与结合使用内容片段和GraphQL的无头内容交付结合使用。
AEM具有以下重复保护:
内容引用允许您渲染来自其他源的内容;例如,图像或内容片段。
除了标准属性之外,您还可以指定:
片段引用引用引用一个或多个内容片段。 此功能在检索内容以在您的应用程序中使用时特别感兴趣,因为它允许您使用多个层来检索结构化数据。
例如:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
与结合使用内容片段和GraphQL的无头内容交付特别值得关注。
除了标准属性之外,您还可以定义:
呈现为:
多字段 — 片段作者可以创建多个单独的引用
fragmentreference — 允许片段作者选择对片段的单个引用
模型
类型可选择多个模型。创作内容片段时,必须使用这些模型创建了任何引用的片段。
根路
径这为引用的任何片段指定根路径。
允许创建片段
这将允许片段作者根据相应的模型创建新片段。
已建立复发保护机制。 它禁止用户在片段引用中选择当前内容片段。 这可能导致出现空的片段引用选取器对话框。
GraphQL中还对片段引用提供了定期保护。 如果在两个相互引用的内容片段之间创建深层查询,则将返回空值。
要完全控制内容片段模型的使用,可设置其状态。
创建模型后,需要启用该模型,以便:
要启用标记为以下任一类型的模型:
使用以下任一位置的Enable选项:
也可以禁用模型,以便:
要禁用标记为Enabled的模型,请使用以下任一位置的Disable选项:
要实施内容管理,您可以在Assets文件夹上配置Policys以控制允许在该文件夹中创建片段的内容片段模型。
该机制类似于在页面的高级属性中允许页面模板🔗及其子项。
要为允许的内容片段模型配置策略,请执行以下操作:
导航并打开所需Assets文件夹的属性 。
打开Policys选项卡,您可以在其中配置:
继承自<folder>
创建新子文件夹时,会自动继承策略;如果子文件夹需要允许与父文件夹不同的模型,则可以重新配置策略(并中断继承)。
按照路径允许的内容片段模型
可以允许使用多个模型。
允许的内容片段模型(按标记)
可以允许使用多个模型。
保存任何更改。
文件夹允许的内容片段模型将按照以下方式进行解析:
删除内容片段模型可能会影响相关片段。
要删除内容片段模型,请执行以下操作:
导航到工具、资产,然后打开内容片段模型。
导航到包含内容片段模型的文件夹。
选择模型,然后从工具栏中选择Delete。
如果引用了模型,则会发出警告。 采取适当措施。
在发布任何相关内容片段时/之前,需要发布内容片段模型。
要发布内容片段模型,请执行以下操作:
导航到工具、资产,然后打开内容片段模型。
导航到包含内容片段模型的文件夹。
选择您的模型,然后从工具栏中选择Publish 。
控制台中将指示已发布状态。
如果发布的内容片段的模型尚未发布,则会显示一个选择列表来指示该情况,并且模型将随该片段一起发布。
如果任何片段未引用内容片段模型,则可以取消发布这些模型。
要取消发布内容片段模型,请执行以下操作:
导航到工具、资产,然后打开内容片段模型。
导航到包含内容片段模型的文件夹。
选择您的模型,然后从工具栏中选择取消发布 。
控制台中将指示已发布状态。
您可以编辑内容片段模型的属性: