Picker per l’authoring di contenuti AEM e Commerce cif-pickers
L’authoring di contenuti e commercio AEM fornisce una serie di strumenti di authoring per aiutare gli autori e gli esperti di marketing AEM a lavorare in modo efficiente con i dati di prodotto e i cataloghi commerciali. Il selettore prodotti e il selettore categorie fanno parte del componente aggiuntivo CIF e sono 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 product-picker
Per utilizzare il selettore prodotti in un componente del progetto, uno sviluppatore deve aggiungere commerce/gui/components/common/cifproductfield
nella 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 passare al prodotto che un utente desidera selezionare tramite le diverse visualizzazioni. Per impostazione predefinita, il campo prodotto restituisce l’ID del prodotto, ma può essere configurato utilizzando selectionId
attributo.
Il campo del selettore prodotti supporta le seguenti proprietà facoltative:
- selectionId (id, uid, SKU, slug, combinedSlug, combinedSku): consente di scegliere l’attributo del prodotto che deve essere restituito dal selettore (impostazione predefinita = id). Utilizzando SKU viene restituito lo SKU del prodotto selezionato. L’utilizzo di combinedSku restituisce una stringa come base#variant con gli SKU del prodotto di base e della variante selezionata, oppure un singolo SKU se è selezionato un prodotto di base.
- filter (folderOrProduct, folderOrProductOrVariant) - filtra il contenuto di cui eseguire il rendering dal selettore durante l’esplorazione della struttura del prodotto. folderOrProduct - esegue il rendering di cartelle e prodotti. folderOrProductOrVariant - esegue il rendering di cartelle, prodotti e varianti di prodotti. Se viene eseguito il rendering di un prodotto o di una variante di prodotto, questo diventa selezionabile anche nel selettore. (impostazione predefinita = folderOrProduct)
- multiple (true, false): consente di selezionare uno o più prodotti (default = false)
- emptyText: per configurare il valore di testo vuoto del campo selettore
Inoltre, le proprietà dei campi della finestra di dialogo standard come name
, fieldLabel
, o fieldDescription
, sono supportati.
cifproductfield
il componente richiede cif.shell.picker
clientlib. Per aggiungere una libreria client a una finestra di dialogo, puoi utilizzare la proprietà extraClientlibs.id
è stato rimosso e sostituito con uid
. L’Adobe consiglia di utilizzare sku
o slug
come identificatore di prodotto. Adobe continua a supportare id
solo per i progetti che utilizzano i Componenti core CIF versione 1.x.Un esempio di funzionamento completo del cifproductfield
si trova nella sezione Componenti core CIF progetto. Vedi anche Personalizzazione delle finestre di dialogo della documentazione dei Componenti core AEM.
Selettore categorie category-picker
Il selettore categorie può essere utilizzato anche nella finestra di dialogo di un componente, in modo simile al selettore prodotti.
Il seguente snippet può essere utilizzato in una configurazione cq
<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 di categoria che deve essere restituito dal selettore (impostazione predefinita = id).
- multiple (true, false): abilita la selezione di una o più categorie (default = false)
Inoltre, le proprietà dei campi della finestra di dialogo standard come name
, fieldLabel
, o fieldDescription
, sono supportati.
cifproductfield
componente il cifcategoryfield
richiede anche il cif.shell.picker
clientlib. Per aggiungere una libreria client a una finestra di dialogo, puoi utilizzare extraClientlibs
proprietà. Consulta Personalizzazione delle finestre di dialogo della documentazione dei Componenti core AEM.id
è stato rimosso e sostituito con uid
. L’Adobe consiglia di utilizzare uid
o urlPath
come identificatore di categoria. Adobe continua a supportare id
E idAndUrlPath
solo per i progetti che utilizzano i Componenti core CIF versione 1.x.Un esempio di funzionamento completo del cifcategoryfield
si trova nella sezione Componenti core CIF progetto.