Seletores de criação de conteúdo e Commerce para AEM cif-pickers

A criação de conteúdo e Commerce do AEM fornece um conjunto de ferramentas de criação para ajudar os autores e profissionais de marketing do AEM a trabalhar com eficiência com dados de produtos e catálogos comerciais. O Seletor de produto e o Seletor de categoria fazem parte do complemento CIF e são usados pelos Componentes principais do CIF. Os projetos podem usar esses seletores em qualquer caixa de diálogo de componente para selecionar produtos ou categorias.

Seletor de produtos product-picker

Para usar o seletor de produtos em um componente de projeto, um desenvolvedor deve adicionar commerce/gui/components/common/cifproductfield a uma caixa de diálogo de componente. Por exemplo, use o seguinte para o 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"/>

O campo produto permite navegar até o produto que um usuário deseja selecionar por meio das diferentes exibições. Por padrão, o campo product retorna a ID do produto, mas pode ser configurado usando o atributo selectionId.

O campo seletor de produto oferece suporte às seguintes propriedades opcionais:

  • selectionId (id, uid, SKU, slug, combineSlug, combineSku) - permite que você escolha o atributo de produto a ser retornado pelo seletor (padrão = id). Usar SKU retorna o SKU do produto selecionado. O uso de combineSku retorna uma string como base#variant com os SKUs do produto base e a variante selecionada, ou um único SKU se um produto base estiver selecionado.
  • filtro (folderOrProduct, folderOrProductOrVariant): filtra o conteúdo a ser renderizado pelo seletor ao navegar na árvore do produto. folderOrProduct - renderiza pastas e produtos. folderOrProductOrVariant - renderiza pastas, produtos e variantes de produtos. Se um produto ou variante de produto for renderizado, também se tornará selecionável no seletor. (padrão = folderOrProduct)
  • múltiplo (true, false) - habilita a seleção de um ou vários produtos (padrão = false)
  • emptyText - para configurar o valor de texto vazio do campo do seletor

Além disso, há suporte para propriedades de campo de caixa de diálogo padrão, como name, fieldLabel ou fieldDescription.

CAUTION
O componente cifproductfield requer o clientlib cif.shell.picker. Para adicionar uma clientlib a uma caixa de diálogo, é possível usar a propriedade extraClientlibs.
CAUTION
A partir da versão 2.0.0 dos Componentes Principais do CIF, o suporte para id foi removido e substituído por uid. A Adobe recomenda usar sku ou slug como um identificador de produto. O Adobe continua a oferecer suporte a id somente para projetos que usam a versão 1.x dos Componentes principais do CIF.

Um exemplo completo de funcionamento do cifproductfield pode ser encontrado no projeto Componentes principais do CIF. Consulte também Personalizar caixas de diálogo da documentação dos Componentes principais do AEM.

Seletor de Categoria category-picker

O seletor de categorias pode ser usado em uma caixa de diálogo de componente, bem como de maneira semelhante ao seletor de produtos.

O trecho a seguir pode ser usado em uma configuração cq

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

O campo do seletor de categoria é compatível com as seguintes propriedades opcionais:

  • selectionId(id, uid, slug, urlPath, idAndUrlPath (desaprovado), uidAndUrlPath (desaprovado)) - permite que você escolha o atributo de categoria a ser retornado pelo seletor (padrão = id).
  • multiple (true, false) - habilita a seleção de uma ou várias categorias (padrão = false)

Além disso, há suporte para propriedades de campo de caixa de diálogo padrão, como name, fieldLabel ou fieldDescription.

CAUTION
Igual ao componente cifproductfield, o componente cifcategoryfield também requer o clientlib cif.shell.picker. Para adicionar uma clientlib a uma caixa de diálogo, você pode usar a propriedade extraClientlibs. Consulte Personalizando caixas de diálogo da documentação dos Componentes principais do AEM.
CAUTION
A partir da versão 2.0.0 dos Componentes Principais do CIF, o suporte para id foi removido e substituído por uid. A Adobe recomenda usar uid ou urlPath como identificador de categoria. O Adobe continua a oferecer suporte a id e idAndUrlPath somente para projetos que usam os Componentes principais CIF versão 1.x.

Um exemplo completo de funcionamento do cifcategoryfield pode ser encontrado no projeto Componentes principais do CIF.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab