경험 조각 experience-fragments

기본 사항 the-basics

경험 조각은(는) 페이지 내에서 참조할 수 있는 콘텐츠 및 레이아웃을 포함한 하나 이상의 구성 요소 그룹입니다.

경험 조각 기본, 변형 또는 두 가지 모두 는 다음을 사용합니다.

/libs/cq/experience-fragments/components/xfpage/xfpage.html이(가) 없으므로 다음으로 되돌아감

일반 HTML 렌디션 the-plain-html-rendition

URL에서 .plain. 선택기를 사용하여 일반 HTML 렌디션에 액세스할 수 있습니다.

이 렌디션은 브라우저에서 사용할 수 있습니다. 그러나 주요 목적은 다른 애플리케이션(예: 서드파티 웹 앱, 사용자 지정 모바일 구현)이 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

Export to Target 기능을 사용하여 다음과 같은 작업을 수행할 수 있습니다.

이 기능은 AEM의 작성자 인스턴스에서 활성화할 수 있습니다. 유효한 Adobe Target 구성 및 링크 외부화에 대한 구성이 필요합니다.

링크 외부화는 Target 오퍼의 HTML 버전을 생성할 때 필요한 올바른 URL을 결정하고 이를 Adobe Target으로 전송하는 데 사용됩니다. Adobe Target에서는 Target HTML 오퍼 내의 모든 링크에 공개적으로 액세스할 수 있어야 하므로 이 프로세스가 필요합니다. 즉, 링크가 참조하는 모든 리소스 및 경험 조각 자체를 사용하려면 먼저 게시해야 합니다.

기본적으로 Target HTML 오퍼를 구성하면 요청이 AEM의 사용자 지정 Sling 선택기로 전송됩니다. 이 선택기를 .nocloudconfigs.html이라고 합니다. 이름에서 알 수 있듯이, 경험 조각의 일반 HTML 렌더링을 만들지만, 클라우드 구성(불필요한 정보)은 포함하지 않습니다.

HTML 페이지를 생성하면 Sling 재작성기 파이프라인이 출력으로 수정됩니다.

기본 구현을 사용하는 경우 위에 설명된 프로세스로 경험 조각에서 Target 오퍼를 생성한 다음 Adobe Target으로 내보내기에 충분해야 합니다. 그러나 이 프로세스에서 설명되지 않는 사용 사례도 있습니다. 설명되지 않는 이러한 사례의 일부는 다음과 같습니다.

이러한 사용 사례에 대해 AEM은 링크 재작성기 공급자 인터페이스를 제공합니다.

링크 재작성기 공급자 인터페이스 link-rewriter-provider-interface

default에서 다루지 않는 더 복잡한 경우에는 AEM에서 링크 재작성기 공급자 인터페이스를 제공합니다. 이 인터페이스는 번들에서 서비스로 구현할 수 있는 ConsumerType 인터페이스입니다. AEM이 경험 조각에서 렌더링한 대로 HTML 오퍼의 내부 링크에 대해 수행하는 수정 사항을 무시합니다. 이 인터페이스를 사용하면 비즈니스 요구 사항에 맞게 내부 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

인터페이스를 사용하려면 먼저 링크 재작성기 공급자 인터페이스를 구현하는 새 서비스 구성 요소가 포함된 번들을 만들어야 합니다.

이 서비스는 다양한 링크에 액세스할 수 있도록 경험 조각을 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)

이 메서드는 를 입력할 때 매개 변수를 수신합니다.

예를 들어 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과(와) 같이 서비스에 대한 Resource Resolver에 액세스할 수 있는 권한이 있다고 가정해 보십시오.

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을(를) 반환하는 경우 이 작업을 수행할 수 있습니다. 여러 특정 경험 조각의 경우 특수 처리가 필요할 수 있으므로 이 경우 일부 경험 조각 변형에 대해서만 shouldRewrite() 메서드가 true를 반환하는 SpecificLinkRewriterProvider을(를) 제공할 수 있습니다. SpecificLinkRewriterProvider이(가) 이러한 경험 조각 변형을 처리하도록 선택되었는지 확인하려면 GenericLinkRewriterProvider.보다 높은 숫자인 getPriority() 메서드로 반환해야 합니다.