Selector de contenido y comercio de AEM

AEM Creación de contenido y comercio proporciona un conjunto de herramientas de creación para ayudar a AEM autores y especialistas en marketing a trabajar de forma eficiente con los datos y catálogos de productos comerciales. El Selector de productos y el Selector de categorías forman parte del complemento CIF y los componentes principales del CIF lo utilizan. Los proyectos pueden utilizar estos selectores en cualquier cuadro de diálogo de componentes para seleccionar productos o categorías.

Selector de productos

Para utilizar 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 la 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 navegar hasta el 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 utilizando la variable selectionId atributo.

El campo Selector de producto admite las siguientes propiedades opcionales:

  • selectionId (id, uid, sku, anotaciones, combinarSlug, mergeSku) - permite elegir el atributo de producto que el selector devolverá (valor predeterminado = id). Si se utiliza sku, se devuelve el SKU del producto seleccionado, mientras que se utiliza mergeSku y se devuelve una cadena como base#variant con el SKU del producto base y la variante seleccionada, o un sku único si se selecciona un producto base.
  • filter (folderOrProduct, folderOrProductOrVariant): filtra el contenido que el selector va a representar mientras navega por el árbol de productos. folderOrProduct: procesa carpetas y productos. folderOrProductOrVariant : procesa carpetas, productos y variantes de producto. Si se representa una variante de producto o producto, también se puede seleccionar en el selector. (predeterminado = folderOrProduct)
  • multiple (true, false) : permite la selección de uno o varios productos (default = false)
  • emptyText : para configurar el valor de texto vacío del campo de selección

Además, las propiedades estándar de los campos de diagnóstico como name, fieldLabelo fieldDescription también son compatibles.

PRECAUCIÓN

La variable cifproductfield requiere el cif.shell.picker clientlib. Para agregar una clientlib a un cuadro de diálogo, puede utilizar la propiedad extraClientlibs .

PRECAUCIÓN

A partir de la versión 2.0.0 de los componentes principales de CIF, la compatibilidad con id se ha eliminado y se ha reemplazado por uid. Se recomienda encarecidamente utilizar sku o slug como identificador de producto. Seguimos apoyando id solo para proyectos que utilizan componentes principales de CIF versión 1.x.

Un ejemplo completo de funcionamiento de la variable cifproductfield se encuentra en la variable Componentes principales de CIF proyecto. Consulte también Personalización de cuadros de diálogo de la documentación de componentes principales de AEM.

Selector de categoría

El selector de categorías se puede utilizar en un cuadro de diálogo de componentes de forma similar al selector de productos.

Se puede utilizar el siguiente fragmento de código en una configuración cq:dialog:

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

El campo Selector de categoría admite las siguientes propiedades opcionales:

  • selectionId(id, uid, anotaciones, urlPath, idAndUrlPath (obsoleto), uidAndUrlPath (obsoleto)) - permite elegir el atributo de categoría que el selector devolverá (valor predeterminado = id).
  • multiple (true, false) : permite la selección de una o varias categorías (default = false)

Además, las propiedades estándar de los campos de diagnóstico como name, fieldLabelo fieldDescription también son compatibles.

PRECAUCIÓN

Igual que el cifproductfield el componente cifcategoryfield también requiere el cif.shell.picker clientlib. Para agregar una clientlib a un cuadro de diálogo, puede usar la variable extraClientlibs propiedad. Consulte Personalización de cuadros de diálogo de la documentación de componentes principales de AEM.

PRECAUCIÓN

A partir de la versión 2.0.0 de los componentes principales de CIF, la compatibilidad con id se ha eliminado y se ha reemplazado por uid. Se recomienda encarecidamente utilizar uid o urlPath como identificador de categoría. Seguimos apoyando id & idAndUrlPath solo para proyectos que utilizan componentes principales de CIF versión 1.x.

Un ejemplo completo de funcionamiento de la variable cifcategoryfield se encuentra en la variable Componentes principales de CIF proyecto.

En esta página