AEM och redigeringsväljare för Commerce 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 i 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 användaren navigera till den produkt som användaren vill välja genom de olika vyerna. Som standard returnerar produktfältet produktens ID, men det kan konfigureras med attributet selectionId.

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). När du använder sku returneras sku för den valda produkten, när du använder combinedSku, och en sträng som base#variant returneras med skus för basprodukten och den valda varianten, eller en enda 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 också.

CAUTION
Komponenten 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 har stödet för id tagits bort och ersatts med uid. Adobe rekommenderar att du använder sku eller slug som produkt-ID. Adobe stöder endast id för projekt som använder CIF Core Components version 1.x.

Ett fullt fungerande exempel på cifproductfield finns i CIF Core Components -projektet. Se även Anpassa dialogrutor i dokumentationen för AEM Core Components.

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 (utgått), uidAndUrlPath (utgått)) - 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 också.

CAUTION
Samma som komponenten cifproductfield i komponenten cifcategoryfield kräver även cif.shell.picker clientlib. Om du vill lägga till ett klientlib i en dialogruta kan du använda egenskapen extraClientlibs. Mer information finns i Anpassa dialogrutor i dokumentationen AEM kärnkomponenter.
CAUTION
Från och med CIF Core Components version 2.0.0 har stödet för id tagits bort och ersatts med uid. Adobe rekommenderar att du använder uid eller urlPath som kategoriidentifierare. Adobe fortsätter att stödja id och idAndUrlPath endast för projekt som använder CIF Core Components version 1.x.

Ett fullt fungerande exempel på cifcategoryfield finns i CIF Core Components -projektet.

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