AEM för innehåll och e-handel cif-pickers

AEM Content & Commerce Authoring innehåller en uppsättning redigeringsverktyg som hjälper AEM att effektivt arbeta med produktdata och kataloger för e-handel. Produktväljaren och kategoriväljaren är en del av CIF och används av de CIF kärnkomponenterna. Projekt kan använda de här väljarna i alla komponentdialogrutor för att välja produkter eller kategorier.

Produktväljare product-picker

Om du vill använda produktväljaren i en projektkomponent måste utvecklaren lägga till commerce/gui/components/common/cifproductfield till en komponentdialogruta. Använd till exempel följande för cq:dialog:

<product jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifproductfield"
    fieldDescription="The product or product variant displayed by the teaser"
    fieldLabel="Select Product"
    filter="folderOrProductOrVariant"
    name="./selection"
    selectionId="sku"/>

I produktfältet kan du navigera till den produkt som en användare vill välja genom de olika vyerna. Som standard returnerar produktfältet produktens ID, men det kan konfigureras med selectionId -attribut.

Produktväljarfältet har stöd för följande valfria egenskaper:

  • selectionId (id, uid, SKU, instruktionsmarginal, combinedSlug, combinedSku) - gör att du kan välja vilket produktattribut som ska returneras av väljaren (standard = id). Om du använder SKU returneras SKU:n för den valda produkten. Om du använder combinedSku returneras en sträng som base#variant med SKU:erna för basprodukten och den valda varianten, eller en SKU om en basprodukt väljs.
  • filter (folderOrProduct, folderOrProductOrVariant) - filtrerar innehållet som ska återges av väljaren när du navigerar i produktträdet. folderOrProduct - återger mappar och produkter. folderOrProductOrVariant - återger mappar, produkter och produktvarianter. Om en produkt eller produktvariant återges blir den också valbar i väljaren. (default = folderOrProduct)
  • multiple (true, false) - aktivera valet av en eller flera produkter (standard = false)
  • emptyText - för att konfigurera det tomma textvärdet för väljarfältet

Standardegenskaper för dialogrutefält som name, fieldLabel, eller fieldDescription, stöds.

CAUTION
The cifproductfield kräver cif.shell.picker clientlib. Om du vill lägga till ett clientlib i en dialogruta kan du använda egenskapen extraClientlibs.
CAUTION
Från och med CIF Core Components version 2.0.0 stöds id togs bort och ersattes med uid. Adobe rekommenderar att du använder sku eller slug som en produkt-ID. Adobe fortsätter att stödja id endast för projekt som använder CIF Core Components version 1.x.

Ett fullt fungerande exempel på cifproductfield finns i CIF kärnkomponenter projekt. Se även Anpassa dialogrutor av dokumentationen AEM kärnkomponenter.

Kategoriväljaren category-picker

Kategoriväljaren kan användas i en komponentdialogruta på ett liknande sätt som produktväljaren.

Följande kodutdrag kan användas i en cq

<category jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifcategoryfield"
    fieldLabel="Category"
    name="./categoryId"
    selectionId="uid" />

Fältet för kategoriväljare har stöd för följande valfria egenskaper:

  • selectionId(id, uid, instruktionsmarginal, urlPath, idAndUrlPath (borttagen), uidAndUrlPath (borttagen)) - låter dig välja vilket kategoriattribut som ska returneras av väljaren (standard = id).
  • multiple (true, false) - aktivera markering av en eller flera kategorier (standard = false)

Standardegenskaper för dialogrutefält som name, fieldLabel, eller fieldDescription, stöds.

CAUTION
Samma som cifproductfield komponenten cifcategoryfield -komponenten kräver också cif.shell.picker clientlib. Om du vill lägga till ett clientlib i en dialogruta kan du använda extraClientlibs -egenskap. Se Anpassa dialogrutor av dokumentationen AEM kärnkomponenter.
CAUTION
Från och med CIF Core Components version 2.0.0 stöds id togs bort och ersattes med uid. Adobe rekommenderar att du använder uid eller urlPath som kategoriidentifierare. Adobe fortsätter att stödja id & idAndUrlPath endast för projekt som använder CIF Core Components version 1.x.

Ett fullt fungerande exempel på cifcategoryfield finns i CIF kärnkomponenter projekt.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab