Seleccionadores de creación de contenido y Commerce de AEM cif-pickers
La creación de contenido y Commerce de AEM proporciona un conjunto de herramientas de creación para ayudar a los autores y especialistas en marketing de AEM a trabajar de forma eficaz con los datos y catálogos de productos de comercio. El selector de productos y el selector de categorías forman parte del complemento de CIF y los utilizan los componentes principales de CIF. Los proyectos pueden utilizar estos selectores en cualquier cuadro de diálogo de componente para seleccionar productos o categorías.
Selector de productos product-picker
Para usar el selector de productos en un componente de proyecto, un desarrollador debe agregar commerce/gui/components/common/cifproductfield a un cuadro de diálogo de componentes. Por ejemplo, use lo siguiente para 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"/>
El campo de producto permite la navegación al producto que un usuario desea seleccionar mediante las diferentes vistas. De forma predeterminada, el campo de producto devuelve el ID del producto, pero se puede configurar con el atributo selectionId.
El campo selector de productos admite las siguientes propiedades opcionales:
- selectionId (id, uid, sku, slug, mergedSlug, mergedSku): permite elegir el atributo de producto que devolverá el selector (predeterminado = id). El uso de SKU devuelve el SKU del producto seleccionado, mientras que el uso de Sku combinado y devuelve una cadena como base#variant con los SKU del producto base y la variante seleccionada, o un único SKU si se selecciona un producto base.
- filter (folderOrProduct, folderOrProductOrVariant): filtra el contenido que el selector procesará al navegar por el árbol de productos. folderOrProduct: procesa carpetas y productos. folderOrProductOrVariant: procesa carpetas, productos y variantes de productos. Si se procesa un producto o una variante de producto, también se puede seleccionar en el selector. (predeterminado = folderOrProduct)
- multiple (true, false): habilita la selección de uno o varios productos (default = false)
- emptyText: para configurar el valor de texto vacío del campo selector
Además, también se admiten propiedades de campo de diálogo estándar como name, fieldLabel o fieldDescription.
cifproductfield requiere clientlib cif.shell.picker. Para agregar clientlib a un cuadro de diálogo, puede utilizar la propiedad extraClientlibs.id y se reemplazó con uid. Adobe recomienda usar sku o slug como identificador de producto. Adobe sigue admitiendo id solamente en proyectos que usan la versión 1.x de los componentes principales de CIF.Se puede encontrar un ejemplo de trabajo completo de cifproductfield en el proyecto de componentes principales de CIF. Consulte también Personalización de cuadros de diálogo en la documentación de los componentes principales de AEM.
Selector de categoría category-picker
El selector de categorías se puede utilizar en un cuadro de diálogo de componentes de forma similar al selector de productos.
El siguiente fragmento se puede utilizar en una configuración cq
<category jcr:primaryType="nt:unstructured"
sling:resourceType="commerce/gui/components/common/cifcategoryfield"
fieldLabel="Category"
name="./categoryId"
selectionId="uid" />
El campo selector de categorías admite las siguientes propiedades opcionales:
- selectionId(id, uid, slug, urlPath, idAndUrlPath (obsoleto), uidAndUrlPath (obsoleto)): permite elegir el atributo de categoría que el selector devolverá (predeterminado = id).
- multiple (true, false): habilita la selección de una o varias categorías (default = false)
Además, también se admiten propiedades de campo de diálogo estándar como name, fieldLabel o fieldDescription.
cifproductfield, el componente cifcategoryfield también requiere la clientlib cif.shell.picker. Para agregar clientlib a un cuadro de diálogo, puede utilizar la propiedad extraClientlibs. Consulte Personalización de cuadros de diálogo en la documentación de los componentes principales de AEM.id y se reemplazó con uid. Adobe recomienda usar uid o urlPath como identificador de categoría. Adobe sigue admitiendo id y idAndUrlPath solamente en proyectos que utilizan la versión 1.x de los componentes principales de CIF.Se puede encontrar un ejemplo de trabajo completo de cifcategoryfield en el proyecto de componentes principales de CIF.