경험 조각 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 Rewriter은(는) 변환기로 사용됩니다. 다음에서 구성됩니다.

HTML 렌디션 생성 구성 configuring-html-rendition-generation

HTML 렌디션은 Sling 재작성기 파이프라인을 사용하여 생성됩니다. 파이프라인이 /libs/experience-fragments/config/rewriter/experiencefragments에 정의되어 있습니다. HTML 변환기는 다음 옵션을 지원합니다.

오버레이를 사용하여 재작성기를 구성하는 것이 좋습니다. 오버레이 참조

소셜 변형 social-variations

소셜 변형은 소셜 미디어(텍스트 및 이미지)에 게시할 수 있습니다. Adobe Experience Manager(AEM)에서 이러한 소셜 변형은 구성 요소(예: 텍스트 구성 요소, 이미지 구성 요소)를 포함할 수 있습니다.

소셜 게시물에 대한 이미지 및 텍스트는 원하는 수준의 깊이(빌딩 블록 또는 레이아웃 컨테이너 내)에서 이미지 리소스 유형 또는 텍스트 리소스 유형에서 가져올 수 있습니다.

또한 소셜 변형을 사용하면 빌딩 블록을 사용할 수 있으며 게시 환경에서 소셜 작업을 수행할 때 이를 고려합니다.

소셜 미디어 네트워크에 올바른 텍스트와 이미지를 게시하려면 사용자 지정된 구성 요소를 개발하는 경우 일부 규칙을 준수해야 합니다.

이를 위해 다음 속성을 사용해야 합니다.

이 규칙을 사용하지 않는 구성 요소는 고려되지 않습니다.

경험 조각용 템플릿 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() 메서드로 반환해야 합니다.