在Adobe Experience Manager作为Cloud Service,内容片段扩展了标准资产;请参阅:
内容片段的基本组成部分为:
单个内容片段基于内容片段模型:
内容片段模型定义内容片段在创建时的结构。
片段引用模型;因此,对模型所做的更改可能会/会影响任何从属片段。
模型是数据类型的构建。
添加新变量等的函数必须相应更新片段。
要显示/呈现内容片段,您的帐户必须对模型具有read
权限。
对现有内容片段模型的任何更改都可能影响相关片段;这会导致这些片段中的孤立属性。
内容片段管理(CFM)是AEM Assets的一部分,作为:
内容片段被视为站点功能,因为:
内容片段会基于内容片段模型映射到单个资产:
所有内容都存储在资产的jcr:content/data
节点下:
元素数据存储在主控子节点下:
jcr:content/data/master
变体存储在子节点下,子节点带有变体的名称:
例如,jcr:content/data/myvariation
每个元素的数据作为具有元素名称的属性存储在相应的子节点中:
例如,元素text
的内容作为属性text
存储在jcr:content/data/master
上
元数据和相关内容存储在jcr:content/metadata
下
除标题和说明外,标题和说明不被视为传统元数据并存储在
jcr:content
与标准资产一样,内容片段位于以下位置:
/content/dam
有关详细信息,请参阅内容片段——删除注意事项。
要与Assets核心集成,请执行以下操作:
内容片段管理(CFM)功能构建于资产核心之上。
CFM为卡/列/列表视图中的项目提供其自己的实现;这些插件可插入现有资产内容呈现实施。
已扩展多个资产组件,以满足内容片段的需要。
内容片段组件是核心组件的一部分。 有关详细信息,请参阅开发核心组件。
内容片段可以从AEM页面进行引用,就像任何其他资产类型一样。 AEM提供内容片段核心组件 —— 一个组件,允许您在页面上包含内容片段。 您还可以扩展此内容片段核心组件。
组件使用fragmentPath
属性引用实际内容片段。 fragmentPath
属性的处理方式与其他资产类型的类似属性相同;例如,当内容片段被移动到其他位置时。
组件允许您选择要显示的变量。
此外,还可以选择一系列段落来限制输出;例如,这可用于多列输出。
组件允许中间内容:
在此组件中,您可以放置其他资产(图像等) 在引用片段的段落之间。
对于中间内容,您需要:
注意不稳定的参考资料的可能性;中间内容(在创作页面时添加)与它位于旁边的段落没有固定关系,在中间内容的位置之前插入新段落(在内容片段编辑器中)可能会丢失相对位置
考虑其他参数(如变体和段落过滤器),以配置页面上呈现的内容
内容片段模型:
在页面上使用内容片段时,将引用其基于的内容片段模型。
这意味着,如果发布页面时尚未发布模型,则会标记该模型并将该模型添加到要随页面一起发布的资源。
内容片段可与以下内容集成:
翻译
内容片段与AEM翻译工作流程完全集成。 在建筑层面,这意味着:
内容片段的个别翻译实际上是单独的片段;例如:
它们位于不同的语言根系下;但在相关语言根目录下共享完全相同的相对路径:
/content/dam/<path>/en/<to>/<fragment>
与
/content/dam/<path>/de/<to>/<fragment>
除了基于规则的路径之外,内容片段的不同语言版本之间没有进一步的联系;它们作为两个单独的片段处理,但UI提供了在语言变体之间导航的方法。
AEM转换工作流可与/content
一起使用:
/conf
中,因此此类转换中不包含这些模型。 可以将UI字符串国际化。元数据架构
内容片段(重新)使用元数据模式,它可以用标准资产进行定义。
CFM提供其自己的特定模式:
/libs/dam/content/schemaeditors/forms/contentfragment
如果需要,可以扩展此功能。
相应的模式表单与片段编辑器集成。
您可以使用服务器端API访问您的内容片段;请参阅:
强烈建议使用服务器端API,而不是直接访问内容结构。
以下三个接口可用作入口点:
内容片段 (ContentFragment)
此界面允许您以抽象方式处理内容片段。
该界面为您提供了以下方法:
管理基本数据(例如,获取名称;get/set title/description)
访问元数据
访问元素:
列表元素
按名称获取元素
创建新元素(请参阅警告)
访问元素数据(请参阅ContentElement
)
为片段定义的列表变量
全局创建新变量
管理关联内容:
访问片段的模型
表示片段主元素的接口包括:
内容元素 (ContentElement)
内容变化 (ContentVariation)
所有三个接口(ContentFragment
、ContentElement
、ContentVariation
)都扩展了Versionable
接口,该接口添加了内容片段所需的版本控制功能:
可以调整以下内容:
ContentFragment
可适用于:
Resource
-基础Sling资源;直接更新基础 Resource
需要重建对 ContentFragment
象。
Asset
-表示 Asset
内容片段的DAM抽象;直接更 Asset
新需要重建对 ContentFragment
象。
ContentElement
可适用于:
ElementTemplate
-用于访问元素的结构信息。Resource
可适用于:
ContentFragment
应当指出:
整个API设计为不自动保留更改(除非API JavaDoc中另有说明)。 因此,您始终必须提交相应请求的资源解析程序(或您实际使用的解析程序)。
可能需要付出额外努力的任务:
强烈建议从ContentFragment
创建新变体。 这可确保所有元素共享此变体,并确保根据需要更新相应的全局数据结构以反映内容结构中新创建的变体。
使用ContentElement.removeVariation()
通过元素删除现有变量不会更新分配给该变量的全局数据结构。 要确保这些数据结构保持同步,请改用ContentFragment.removeVariation()
,它可全局删除变量。
客户端API是内部的。
请参阅以下内容:
filter.xml
内容片段管理的filter.xml
已配置为不与资产核心内容包重叠。
请考虑此背景信息。 您不应在此更改任何内容(因为在存储库中它被标记为专用区域),但在某些情况下,它可能有助于了解内部的工作方式。
编辑内容片段(可以跨多个视图(= HTML页面))是原子的。 由于原子多视图编辑功能不是典型的AEM概念,因此内容片段使用所谓的编辑会话。
当用户在编辑器中打开内容片段时,将启动编辑会话。 当用户通过选择保存或取消离开编辑器时,编辑会话即结束。
从技术上讲,所有编辑操作都是对实时内容进行的,就像所有其他AEM编辑操作一样。 启动编辑会话时,将创建当前未编辑状态的某个版本。 如果用户取消编辑,则恢复该版本。 如果用户单击Save,则不会执行任何特定操作,因为所有编辑操作都对live内容执行,因此所有更改都已被保留。 此外,单击保存将触发一些后台处理(如创建全文搜索信息和/或处理混合媒体资产)。
边缘案件有安全措施;例如,如果用户尝试离开编辑器而不保存或取消编辑会话。 此外,还可定期自动保存以防止数据丢失。
请注意,两个用户可以同时编辑同一内容片段,因此可能会覆盖彼此的更改。 为防止出现这种情况,需要通过对片段应用DAM管理员的Checkout操作来锁定内容片段。
要实现此目标,您可以调整表示API的资源以:
com.adobe.cq.dam.cfm.ContentFragment
例如:
// first, get the resource
Resource fragmentResource = resourceResolver.getResource("/content/dam/fragments/my-fragment");
// then adapt it
if (fragmentResource != null) {
ContentFragment fragment = fragmentResource.adaptTo(ContentFragment.class);
// the resource is now accessible through the API
}
要以编程方式创建新内容片段,您需要使用
FragmentTemplate
根据模型资源调整。
例如:
Resource modelRsc = resourceResolver.getResource("...");
FragmentTemplate tpl = modelRsc.adaptTo(FragmentTemplate.class);
ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");
自动保存间隔(以秒为单位)可以使用配置管理器(ConfMgr)进行定义:
节点:<conf-root>/settings/dam/cfm/jcr:content
属性名称: autoSaveInterval
类型: Long
默认:600
(10分钟);这在/libs/settings/dam/cfm/jcr:content
上定义
如果要设置5分钟的自动保存间隔,您需要定义节点上的属性;例如:
节点:/conf/global/settings/dam/cfm/jcr:content
属性名称: autoSaveInterval
类型: Long
值:300
(5分钟等于300秒)
有关更多信息,请参阅