体验片段 experience-fragments

基础知识 the-basics

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

体验片段母版、变体或同时使用两者：

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

纯 HTML 演绎版 the-plain-html-rendition

使用URL中的.plain.选择器，您可以访问纯HTML演绎版。

可以从浏览器中找到此演绎版。 但是，其主要目的是允许其他应用程序（例如，第三方Web应用程序、自定义移动实施）仅使用URL直接访问体验片段的内容。

纯HTML演绎版将协议、主机和上下文路径添加到路径中，这些路径为：

例如：

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

纯格式副本选择器使用转换器，而不是其他脚本。 Sling重写器用作转换器。 此转换器的配置如下：

配置HTML演绎版生成 configuring-html-rendition-generation

HTML演绎版使用Sling重写器管道生成。 管道定义于/libs/experience-fragments/config/rewriter/experiencefragments。 HTML转换器支持以下选项：

Adobe建议使用叠加配置重写器。 查看AEM as a Cloud Service🔗中的叠加。

体验片段的模板 templates-for-experience-fragments

为体验片段开发新模板时，您可以遵循可编辑模板的标准实践。

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

体验片段的组件 components-for-experience-fragments

开发用于体验片段/中的组件应遵循标准实践。

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

体验片段链接重写器提供程序 — HTML the-experience-fragment-link-rewriter-provider-html

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

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

默认链接重写 default-link-rewriting

使用“导出到目标”功能，您可以：

此功能可以在AEM的创作实例上启用。 它需要有效的Adobe Target配置以及Link Externalizer配置。

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

默认情况下，构造TargetHTML选件时，会向AEM中的自定义Sling选择器发送请求。 此选择器名为.nocloudconfigs.html。 顾名思义，它创建了体验片段的纯HTML渲染，但不包括云配置（这会是多余的信息）。

生成HTML页面后，Sling重写器管道将修改为输出：

使用开箱即用的实施时，上述流程应足以从体验片段生成Target选件，然后将其导出到Adobe Target。 但是，有一些用例未在此流程中说明。 其中有些未说明的案例包括：

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

链接重写器提供程序界面 link-rewriter-provider-interface

对于default未涵盖的更复杂的情况，AEM提供链接重写器提供程序接口。 此接口是您可以在捆绑包中作为服务实现的ConsumerType接口。 它绕过AEM对HTML选件的内部链接执行的修改（从Experience Fragment渲染）。 利用此界面，您可以根据业务需求自定义内部HTML链接的重写流程。

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

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

public interface ExperienceFragmentLinkRewriterProvider {

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

    boolean shouldRewrite(ExperienceFragmentVariation experienceFragment);

    int getPriority();

}

如何使用链接重写器提供程序界面 how-to-use-the-link-rewriter-provider-interface

要使用该接口，首先必须创建一个包，其中包含用于实现链接重写器提供程序接口的新服务组件。

此服务用于插入Experience Fragment Export to 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

向系统指示当对特定体验片段变量调用“导出到Target”时是否必须重写链接。 您可以实施以下方法：

shouldRewrite(ExperienceFragmentVariation experienceFragment);

例如：

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

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

在上例中，您要重写：

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

rewriteLink rewritelink

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

rewriteLink(String link, String tag, String attribute)

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

例如，如果Export to Target系统正在处理此元素，您可以将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中所示：

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;
}

优先级 — getPriority priorities-getpriority

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

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

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