Seletores de criação de conteúdo e comércio AEM

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

Seletor de produtos

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 de produto permite navegar até o produto que um usuário deseja selecionar por meio das diferentes visualizações. Por padrão, o campo do produto 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, lesma, Combinar, CombinarSku) - permite escolher o atributo do produto a ser retornado pelo seletor (padrão = id). Usar o sku retorna o sku do produto selecionado, enquanto usa o CombinationSku e retorna uma string como base#variant com os SKUs do produto base e a variante selecionada, ou um único sku se um produto base for selecionado.
  • filter (folderOrProduct, folderOrVariant) - 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 uma variante de produto for renderizada, ela também poderá ser selecionada no seletor. (padrão = folderOrProduct)
  • vários (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, também há suporte para propriedades de campo de diagnóstico padrão como name, fieldLabel ou fieldDescription.

ATENÇÃO

O componente cifproductfield requer a clientlib cif.shell.picker. Para adicionar uma clientlib a uma caixa de diálogo, você pode usar a propriedade extraClientlibs.

ATENÇÃO

A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para id foi removido e substituído por uid. É altamente recomendável usar sku ou slug como identificador de produto. Continuamos a oferecer suporte id somente para projetos que usam os Componentes principais da CIF versão 1.x.

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

Seletor de categoria

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

O seguinte trecho pode ser usado em uma configuração cq:dialog:

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

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

  • selectionId(id, uid, lesma, urlPath, idAndUrlPath (obsoleto), uidAndUrlPath (obsoleto)) - permite escolher o atributo de categoria a ser retornado pelo seletor (padrão = id).
  • várias (true, false) - habilita a seleção de uma ou várias categorias (padrão = false)

Além disso, também há suporte para propriedades de campo de diagnóstico padrão como name, fieldLabel ou fieldDescription.

ATENÇÃO

Igual ao componente cifproductfield, o componente cifcategoryfield também requer a 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 AEM.

ATENÇÃO

A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para id foi removido e substituído por uid. É altamente recomendável usar uid ou urlPath como identificador de categoria. Continuamos a oferecer suporte somente para id e idAndUrlPath projetos que usam os Componentes principais da CIF versão 1.x.

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

Nesta página