Selezione AEM contenuti e contenuti commerce

AEM Content & Commerce Authoring fornisce una serie di strumenti di authoring per aiutare AEM autori e gli addetti al marketing a lavorare in modo efficiente con i dati e i cataloghi dei prodotti commerce. Il selettore dei prodotti e il selettore delle categorie fanno parte del componente aggiuntivo CIF e vengono utilizzati dai componenti core CIF. I progetti possono utilizzare questi selettori in qualsiasi finestra di dialogo dei componenti per selezionare prodotti o categorie.

Selettore prodotti

Per utilizzare il selettore dei prodotti in un componente del progetto, uno sviluppatore deve aggiungere commerce/gui/components/common/cifproductfield a una finestra di dialogo di un componente. Ad esempio, utilizza quanto segue per 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"/>

Il campo prodotto consente di navigare al prodotto che un utente desidera selezionare tramite le diverse viste. Per impostazione predefinita, il campo prodotto restituisce l’ID del prodotto, ma può essere configurato utilizzando l’attributo selectionId .

Il campo del selettore prodotti supporta le seguenti proprietà facoltative:

  • selectionId (id, uid, sku, lumg, combinedSlug, combinedSku) - consente di scegliere l’attributo di prodotto che deve essere restituito dal selettore (default = id). Utilizzando lo SKU si restituisce lo SKU del prodotto selezionato, mentre si utilizza l'opzione combinatoSku e restituisce una stringa come base#variant con lo SKU del prodotto di base e la variante selezionata, oppure una singola SKU se è selezionato un prodotto di base.
  • filter (folderOrProduct, folderOrProductOrVariant) - filtra il contenuto di cui deve essere eseguito il rendering dal selettore durante la navigazione nella struttura del prodotto. folderOrProduct - esegue il rendering di cartelle e prodotti. folderOrProductOrVariant - esegue il rendering di cartelle, varianti di prodotti e prodotti. Se viene eseguito il rendering di una variante di prodotto o prodotto, questa diventa selezionabile anche nel selettore. (predefinito = folderOrProduct)
  • multiple (true, false) - abilita la selezione di uno o più prodotti (default = false)
  • emptyText - per configurare il valore di testo vuoto del campo picker

Inoltre, sono supportate anche le proprietà dei campi del registro grafico standard come name, fieldLabel o fieldDescription.

ATTENZIONE

Il componente cifproductfield richiede la clientlib cif.shell.picker. Per aggiungere una clientlib a una finestra di dialogo, puoi utilizzare la proprietà extraClientlibs .

ATTENZIONE

A partire dalla versione 2.0.0 dei componenti core CIF, il supporto per id è stato rimosso e sostituito con uid. È vivamente consigliato utilizzare sku o slug come identificatore del prodotto. Continuiamo a supportare id solo per i progetti che utilizzano la versione 1.x dei componenti core CIF.

Un esempio di funzionamento completo di cifproductfield è disponibile nel progetto CIF Core Components . Consulta anche Personalizzazione delle finestre di dialogo della documentazione dei componenti core AEM.

Selettore categoria

Il selettore categoria può essere utilizzato in una finestra di dialogo di un componente e in modo simile al selettore del prodotto.

Il seguente snippet può essere utilizzato in una configurazione cq:dialog:

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

Il campo del selettore delle categorie supporta le seguenti proprietà facoltative:

  • selectionId(id, uid, slug, urlPath, idAndUrlPath (obsoleto), uidAndUrlPath (obsoleto)) consente di scegliere l'attributo della categoria che deve essere restituito dal selettore (predefinito = id).
  • multiple (true, false) - abilita la selezione di una o più categorie (default = false)

Inoltre, sono supportate anche le proprietà dei campi del registro grafico standard come name, fieldLabel o fieldDescription.

ATTENZIONE

Come il componente cifproductfield, anche il componente cifcategoryfield richiede la clientlib cif.shell.picker. Per aggiungere una clientlib a una finestra di dialogo, puoi utilizzare la proprietà extraClientlibs . Consulta Personalizzazione delle finestre di dialogo della documentazione sui componenti core AEM .

ATTENZIONE

A partire dalla versione 2.0.0 dei componenti core CIF, il supporto per id è stato rimosso e sostituito con uid. È vivamente consigliabile utilizzare uid o urlPath come identificatore di categoria. Continuiamo a supportare id e idAndUrlPath solo per i progetti che utilizzano i componenti core CIF versione 1.x.

Un esempio di funzionamento completo di cifcategoryfield è disponibile nel progetto CIF Core Components .

In questa pagina