體驗片段 experience-fragments

基本資訊 the-basics

體驗片段是一或多個元件的群組,包括可在頁面中參考的內容和配置。

體驗片段主要和/或變體使用:

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

因為沒有/libs/cq/experience-fragments/components/xfpage/xfpage.html,所以它還原為

  • sling:resourceSuperTypewcm/foundation/components/page

純HTML轉譯 the-plain-html-rendition

使用URL中的.plain.選擇器,您可以存取純HTML轉譯。

這可從瀏覽器取得,但其主要目的是讓其他應用程式(例如協力廠商網頁應用程式、自訂行動實作)僅使用URL直接存取體驗片段的內容。

純HTML轉譯會將通訊協定、主機和內容路徑新增至以下路徑:

  • 型別: srchrefaction

  • 或結尾為: -src-href

例如:

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

NOTE
連結一律會參考發佈執行個體。 這些連結由第三方使用,因此連結一律會從Publish例項呼叫,而非從Author例項呼叫。
如需進一步資訊,請參閱外部化URL

xf-14

純轉譯選擇器使用轉換程式,而不是其他指令碼;Sling重寫程式會作為轉換程式。 此設定於

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

設定HTML轉譯產生 configuring-html-rendition-generation

HTML轉譯是使用Sling重寫程式管道產生的。 管道定義於/libs/experience-fragments/config/rewriter/experiencefragments。 HTML轉換器支援下列選項:

  • allowedCssClasses

    • 符合應留在最終轉譯中的CSS類別的RegEx運算式。
    • 如果客戶想要移除某些特定的CSS類別,這將很有用
  • allowedTags

    • 最終轉譯中允許的HTML標籤清單。
    • 預設允許下列標籤(不需要設定): html、head、title、body、img、p、span、ul、li、a、b、i、em、strong、h1、h2、h3、h4、h5、h6、br、noscript、div、link和script

建議使用覆蓋來設定重寫程式。 檢視重疊

社交變數 social-variations

社交變體可張貼在社群媒體(文字和影像)上。 在Adobe Experience Manager (AEM)中,這些社交變體可包含元件;例如文字元件、影像元件。

社交貼文的影像和文字可從任何深度層級的影像資源型別或文字資源型別取得(在建置區塊或版面容器中)。

社交變數也允許建置區塊,並在進行社交動作(在發佈環境中)時加以考慮。

若要將正確的文字和影像發佈到社群媒體網路,如果您正在開發自己的自訂元件,則需要遵守一些慣例。

為此,必須使用以下屬性:

  • 用於擷取影像

    • fileReference
    • fileName
  • 用於擷取文字

    • text

未使用此慣例的元件則不予考慮。

體驗片段的範本 templates-for-experience-fragments

CAUTION
體驗片段僅支援​ 可編輯的範本
體驗片段只能用於以可編輯範本為基礎的頁面。

為體驗片段開發新範本時,您可以遵循可編輯範本的標準做法。

若要建立​ 建立體驗片段 ​精靈偵測到的體驗片段範本,您必須遵循下列其中一個規則集:

  1. 兩者:

    1. 範本的資源型別(初始節點)必須繼承自:

      cq/experience-fragments/components/xfpage

    2. 範本的名稱必須以下列專案開頭:

      experience-fragments
      這可讓使用者在/content/experience-fragments中建立體驗片段,因為此資料夾的cq:allowedTemplates屬性包含名稱以experience-fragment開頭的所有範本。 客戶可以更新此屬性以包含他們自己的命名配置或範本位置。

  2. 可以在體驗片段主控台中設定允許的範本

體驗片段的元件 components-for-experience-fragments

開發元件以搭配/在體驗片段中使用,請遵循標準實務。

唯一額外的設定是確保範本上允許元件,這是透過內容原則實現的。

在AEM中,您可以建立體驗片段。 體驗片段:

  • 由一組元件和配置圖組成,
  • 可以獨立於AEM頁面存在。

這類群組的使用案例之一,是將內容內嵌於協力廠商接觸點,例如Adobe Target。

使用匯出至Target功能,您可以:

  • 建立體驗片段,
  • 新增元件,
  • 然後以HTML格式或JSON格式將其匯出為Adobe Target選件。

可在AEM🔗的作者執行個體上啟用此功能。 它需要有效的Adobe Target設定,以及Link Externalizer設定。

Link Externalizer可用來判斷建立Target選件的HTML版本時需要正確的URL,然後傳送至Adobe Target。 這是必要的,因為Adobe Target要求可以公開存取TargetHTML選件內的所有連結;這表示連結參照的任何資源以及體驗片段本身必須在使用之前發佈。

根據預設,當您建構TargetHTML選件時,會傳送要求給AEM中的自訂Sling選取器。 此選取器稱為.nocloudconfigs.html。 顧名思義,這會建立體驗片段的純HTML轉譯,但不包含雲端設定(這會是多餘的資訊)。

產生HTML頁面後,Sling重寫程式管道會對輸出進行修改:

  1. htmlheadbody元素已取代為div元素。 已移除metanoscripttitle元素(它們是原始head元素的子元素,當此元素被div元素取代時不會考慮)。

    這麼做是為了確保HTMLTarget選件可包含在Target活動中。

  2. AEM會修改HTML中出現的任何內部連結,使其指向已發佈的資源。

    若要決定要修改的連結,AEM會對HTML元素的屬性遵循此模式:

    1. src屬性
    2. href屬性
    3. *-src屬性(如data-src、custom-src等)
    4. *-href屬性(如data-hrefcustom-hrefimg-href等)
    note note
    NOTE
    HTML中的內部連結通常為相對連結,但自訂元件在HTML中提供完整URL時可能會發生這種情況。 依預設,AEM會忽略這些完整的URL且不會進行任何修改。

    這些屬性中的連結會透過AEM Link Externalizer publishLink()執行,以重新建立URL,就像是在已發佈的執行個體上一樣,因此是公開可用的。

使用現成可用的實作時,上述流程應足以從體驗片段產生Target選件,然後將其匯出至Adobe Target。 不過,此程式並未說明部分使用案例;其中包括:

  • Sling對應僅在發佈執行個體上可用
  • Dispatcher重新導向

對於這些使用案例,AEM會提供連結重寫器提供者介面。

NOTE
此介面已在AEM 6.5 SP1 (6.5.1.0)中匯入。

對於較複雜的情況,預設未涵蓋,AEM會提供連結重寫程式提供者介面。 這是ConsumerType介面,您可以在套件組合中實作,作為服務。 它會繞過AEM對HTML選件的內部連結執行的修改,如從體驗片段轉譯。 此介面可讓您自訂重寫內部HTML連結的程式,以符合您的業務需求。

實作此介面作為服務的使用案例範例包括:

  • Sling對應已在發佈執行個體上啟用,但在製作執行個體上未啟用
  • Dispatcher或類似技術可用來在內部重新導向URL
  • 資源已備妥sling:alias mechanisms
NOTE
此介面只會處理來自已產生Target選件的內部HTML連結。

連結重寫程式提供者介面( ExperienceFragmentLinkRewriterProvider)如下:

public interface ExperienceFragmentLinkRewriterProvider {

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

    boolean shouldRewrite(ExperienceFragmentVariation experienceFragment);

    int getPriority();

}

若要使用介面,您必須先建立包含實作連結重寫程式提供者介面之新服務元件的組合。

此服務用於插入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)

  • [rewriteLink](#rewritelink)

    • rewriteLinkExample2
  • [getPriority](#priorities-getpriority)

shouldRewrite shouldrewrite

您需要向系統指出當對特定體驗片段變數發出匯出至Target的呼叫時,它是否需要重寫連結。 若要這麼做,請實作方法:

shouldRewrite(ExperienceFragmentVariation experienceFragment);

例如:

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

此方法會以引數形式接收匯出至目標系統目前正在重寫的體驗片段變數。

在上述範例中,我們想要重新寫入:

  • src中存在的連結

  • href屬性

  • 針對特定體驗片段:
    /content/experience-fragment/master

任何透過匯出至Target系統的其他體驗片段會被忽略,且不受此服務中實作的變更影響。

針對受重寫程式影響的體驗片段變數,它會繼續讓服務處理連結重寫。 每當在內部HTML中遇到連結時,就會叫用下列方法:

rewriteLink(String link, String tag, String attribute)

作為輸入,方法會接收引數:

  • link
    正在處理的連結的String表示法。 這通常是指向作者執行個體上資源的相對URL。

  • tag
    正在處理的HTML元素的名稱。

  • 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

NOTE
如需有關如何透過服務使用者取得資源解析程式的詳細資訊,請參閱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;
}
NOTE
如果上述方法傳回null,則Export to Target系統會將連結維持原狀,即資源的相對連結。

優先順序 — getPriority priorities-getpriority

需要多個服務來迎合不同體驗片段型別的情況也很常見,甚至需要有一個通用服務來處理所有體驗片段的外部化和對應。 在這些情況下,可能會發生使用哪個服務的衝突,因此AEM提供為不同服務定義​ 優先順序 ​的可能性。 使用下列方法指定優先順序:

  • getPriority()

此方法允許使用數個服務,其中shouldRewrite()方法會為相同的體驗片段傳回true。 從其getPriority()方法傳回最高數字的服務是處理體驗片段變數的服務。

例如,您可以有GenericLinkRewriterProvider處理所有體驗片段的基本對應,以及當shouldRewrite()方法傳回所有體驗片段變數的true時。 針對數個特定體驗片段,您可能需要特殊處理,因此在此情況下,您可以提供SpecificLinkRewriterProvider,而shouldRewrite()方法只會針對某些體驗片段變數傳回true。 為了確保選擇SpecificLinkRewriterProvider來處理這些體驗片段變數,它必須在其getPriority()方法中傳回大於GenericLinkRewriterProvider.的數字

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2