体验片段

基本信息

体验片段是由一个或多个组件构成的组件组，包括可在页面内引用的内容和布局。

体验片段主控和/或变体使用：

sling:resourceType : /libs/cq/experience-fragments/components/xfpage

由于没有/libs/cq/experience-fragments/components/xfpage/xfpage.html，因此它会还原为

sling:resourceSuperType : wcm/foundation/components/page

纯 HTML 演绎版

使用URL中的.plain.选择器，可以访问纯HTML呈现版本。

可以从浏览器获取该功能，但其主要用途是允许其他应用程序（例如，第三方Web应用程序、自定义移动设备实施）仅使用URL直接访问体验片段的内容。

纯HTML呈现版本将协议、主机和上下文路径添加到以下路径：

类型：src、href或action
或结束于：-src或-href

例如：

.../brooklyn-coat/master.plain.html

注意

链接始终引用发布实例。这些链接将由第三方使用，因此链接将始终从发布实例中调用，而不是从作者调用。

纯HTML呈现版本

纯格式副本选择器使用变压器，而不是其他脚本；Sling Rewriter用作变压器。此配置位于

/libs/experience-fragments/config/rewriter/experiencefragments

社交变体可以在社交媒体（文本和图像）上发布。在AEM中，这些社交变体可以包含组件；例如，文本组件、图像组件。

社交帖子的图像和文本可以从任何深度级别（在构建基块或布局容器中）的任意图像资源类型或文本资源类型中获取。

社交变化还允许在（在发布环境）执行社交操作时考虑构建基块。

要将正确的文本和图像发布到社交媒体网络，如果您要开发自己的自定义组件，则需要遵守一些惯例。

为此，必须使用以下属性：

用于提取图像
- fileReference
- fileName
用于提取文本
- text

不考虑不使用本公约的组成部分。

体验片段的模板

注意

** 体验片段支持可导入的模板。

在为体验片段开发新模板时，您可以按照可编辑模板的标准实践操作。

要创建由创建体验片段向导检测到的体验片段模板，您必须遵循以下规则集之一：

两者:
1. 模板的资源类型（初始节点）必须继承自：
  
  cq/experience-fragments/components/xfpage
2. 并且模板的名称必须以下面的开头：
  
  experience-fragments
  这允许用户在/content/experience-fragments中创建体验片段，作为
  cq:allowedTemplates 此文件夹的属性包含名称以开头的所有模 experience-fragment板。客户可以更新此属性以包含他们自己的命名方案或模板位置。
允许在体验片段控制台中配置模板扫描。

体验片段的组件

开发与体验片段一起使用/在中使用的组件遵循标准实践。

唯一的额外配置是确保模板上允许使用组件，这是通过内容策略实现的。

体验片段链接重写程序提供程序 — HTML

在AEM中，您可以创建体验片段。体验片段：

包含一组组件和一个布局，
可以独立于AEM页面存在。

此类组的一个用例用于将内容嵌入第三方接触点，如Adobe Target。

默认链路重写

使用导出到Target功能，您可以：

创建体验片段，
添加组件，
然后，将其导出为HTML格式或JSON格式的Adobe Target选件。

此功能可以在AEM的创作实例上启用。它需要有效的Adobe Target配置和链接外部器的配置。

链接外部器用于确定创建目标选件的HTML版本时所需的正确URL，该版本随后会发送到Adobe Target。这是必需的，因为Adobe Target要求可以公开访问Target HTML选件内的所有链接；这意味着必须先发布链接引用的任何资源以及体验片段本身，然后才能使用这些资源。

默认情况下，当您构建Target HTML选件时，会向AEM中的自定义Sling选择器发送请求。此选择器名为.nocloudconfigs.html。正如其名称所暗示的，它会创建体验片段的纯HTML渲染，但不包括云配置（这将是多余的信息）。

生成HTML页面后，Sling重写器管道会对输出进行修改：

html、head和body元素将替换为div元素。将删除meta、noscript和title元素（它们是原始head元素的子元素，在被div元素替换时不考虑这些元素）。

这样做是为了确保HTML Target选件可以包含在Target活动中。
AEM会修改HTML中存在的任何内部链接，以便它们指向已发布的资源。

要确定要修改的链接， AEM对HTML元素属性遵循以下模式：
1. src 属性
2. href 属性
3. *-src 属性（如data-src、custom-src等）
4. *-href 属性( data-href如、 custom-href、 img-href等)
注意

在大多数情况下，HTML中的内部链接是相对链接，但在某些情况下，自定义组件会在HTML中提供完整的URL。默认情况下，AEM会忽略这些完整的URL，且不会进行任何修改。

这些属性中的链接通过AEM Link Externalizer publishLink()运行，以便重新创建URL，就像它在已发布的实例上一样，公开提供。

使用现成的实施时，上述流程应该足以从体验片段中生成Target选件，然后将其导出到Adobe Target。但是，有些用例在此过程中没有说明；这包括：

Sling映射仅在发布实例上可用
调度程序重定向

对于这些用例，AEM提供了链接重写程序提供程序界面。

链接重写程序提供程序接口

对于更复杂的情况（未包含在default中），AEM提供了链接重写程序提供程序接口。这是一个ConsumerType接口，您可以在包中作为服务进行实施。它会绕过AEM对从体验片段呈现的HTML选件的内部链接所执行的修改。此界面允许您自定义重写内部HTML链接的过程，以符合您的业务需求。

将此接口作为服务实施的用例示例包括：

Sling映射在发布实例上启用，但在创作实例上未启用
调度程序或类似技术用于在内部重定向URL
资源有sling:alias mechanisms

注意

此界面仅处理生成的Target选件中的内部HTML链接。

链接重写程序提供程序接口(ExperienceFragmentLinkRewriterProvider)如下所示：

public interface ExperienceFragmentLinkRewriterProvider {

    String rewriteLink(String link, String tag, String attribute);

    boolean shouldRewrite(ExperienceFragmentVariation experienceFragment);

    int getPriority();

}

如何使用链接重写器提供程序接口

要使用接口，您首先需要创建一个包，其中包含一个实施链接重写程序提供程序接口的新服务组件。

此服务将用于插入体验片段导出到Target的重写，以便能够访问各种链接。

例如，ComponentService:

import com.adobe.cq.xf.ExperienceFragmentLinkRewriterProvider;
import com.adobe.cq.xf.ExperienceFragmentVariation;
import org.osgi.service.component.annotations.Service;
import org.osgi.service.component.annotations.Component;

@Component
@Service
public class GeneralLinkRewriter implements ExperienceFragmentLinkRewriterProvider {

    @Override
    public String rewriteLink(String link, String tag, String attribute) {
        return null;
    }

    @Override
    public boolean shouldRewrite(ExperienceFragmentVariation experienceFragment) {
        return false;
    }

    @Override
    public int getPriority() {
        return 0;
    }

}

为了使服务正常工作，现在需要在服务中实施以下三种方法：

[shouldRewrite](#shouldrewrite)
[rewriteLink](#rewritelink)
- rewriteLinkExample2
[getPriority](#priorities-getpriority)

shouldRewrite

您需要向系统指示在对特定体验片段变量中的“导出到Target”调用时，系统是否需要重写链接。为此，请实施以下方法：

shouldRewrite(ExperienceFragmentVariation experienceFragment);

例如：

@Override
public boolean shouldRewrite(ExperienceFragmentVariation experienceFragment) {
    return experienceFragment.getPath().equals("/content/experience-fragment/master");
}

此方法将作为参数接收导出到Target系统当前正在重写的体验片段变量。

在以上示例中，我们希望重写：

src中存在的链接
href 仅属性
对于特定体验片段：
/content/experience-fragment/master

通过导出到Target系统的任何其他体验片段都将被忽略，并且不会受此服务中实施的更改的影响。

rewriteLink

对于受重写过程影响的体验片段变体，它将继续让服务处理链接重写。每当在内部HTML中遇到链接时，都会调用以下方法：

rewriteLink(String link, String tag, String attribute)

作为输入，方法接收参数：

link不为目标组件考虑
String 当前正在处理的链接的表示形式。这通常是指向创作实例上资源的相对URL。
tag
当前正在处理的HTML元素的名称。
attribute
确切的属性名称。

例如，如果导出到目标系统当前正在处理此元素，则可以将CSSInclude定义为：

<link rel="stylesheet" href="/etc.clientlibs/foundation/clientlibs/main.css" type="text/css">

使用以下参数完成对rewriteLink()方法的调用：

rewriteLink(link="/etc.clientlibs/foundation/clientlibs/main.css", tag="link", attribute="href" )

创建服务时，您可以根据给定的输入做出决策，然后相应地重写链接。

例如，我们要删除URL的/etc.clientlibs部分并添加相应的外部域。为了简单起见，我们将考虑我们有权访问您服务的资源解析程序，如rewriteLinkExample2中所示：

注意

有关如何通过服务用户获取资源解析程序的更多信息，请参阅AEM中的服务用户。

private ResourceResolver resolver;

private Externalizer externalizer;

@Override
public String rewriteLink(String link, String tag, String attribute) {

    // get the externalizer service
    externalizer = resolver.adaptTo(Externalizer.class);
    if(externalizer == null) {
        // if there was an error, then we do not modify the link
        return null;
    }

    // remove leading /etc.clientlibs from resource link before externalizing
    link = link.replaceAll("/etc.clientlibs", "");

    // considering that we configured our publish domain, we directly apply the publishLink() method
    link = externalizer.publishLink(resolver, link);

    return link;
}

注意

如果上述方法返回null，则导出到目标系统将原样保留该链接，该链接是指向资源的相对链接。

优先级 — getPriority

需要多项服务以满足不同类型的体验片段的需求，甚至需要通用服务来处理所有体验片段的外部化和映射，这种情况并不罕见。在这些情况下，可能会发生与使用哪项服务有关的冲突，因此AEM提供了为不同服务定义优先级的可能性。使用以下方法指定优先级：

getPriority()

此方法允许使用多种服务，其中shouldRewrite()方法为同一体验片段返回true。从getPriority()方法返回最高值的服务是用于处理体验片段变量的服务。

例如，您可以有一个GenericLinkRewriterProvider来处理所有体验片段的基本映射，以及当shouldRewrite()方法返回所有体验片段变量的true时。对于多个特定的体验片段，您可能需要特殊处理，因此在这种情况下，您可以提供SpecificLinkRewriterProvider，对于该shouldRewrite()方法，仅对某些体验片段变量返回true。要确保选择SpecificLinkRewriterProvider来处理这些体验片段变量，它必须在其getPriority()方法中返回一个大于GenericLinkRewriterProvider.的数字

adobe.com 上的资源

Ecommerce Integrations Personalized Experiences Responsive Forms Content As A Service Digital Asset Management Content Management System