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.
Para usar o seletor de produtos em um componente de projeto, um desenvolvedor deve adicionar commerce/gui/components/common/cifproductfield
para 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 a variável selectionId
atributo.
O campo seletor de produto oferece suporte às seguintes propriedades opcionais:
Além disso, as propriedades padrão de campos de diagnóstico, como name
, fieldLabel
ou fieldDescription
também são compatíveis.
O cifproductfield
O componente exige que cif.shell.picker
clientlib. Para adicionar uma clientlib a uma caixa de diálogo, você pode usar a propriedade extraClientlibs.
A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para o id
foi removido e substituído por uid
. Recomendamos usar sku
ou slug
como identificador de produto. Continuamos a apoiar id
somente para projetos que usam os Componentes principais da CIF versão 1.x.
Um exemplo completo de trabalho da cifproductfield
podem ser encontradas no Componentes principais da CIF projeto. Consulte também Personalização de caixas de diálogo da documentação dos Componentes principais do AEM.
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:
Além disso, as propriedades padrão de campos de diagnóstico, como name
, fieldLabel
ou fieldDescription
também são compatíveis.
Igual a cifproductfield
componente cifcategoryfield
também exige que o cif.shell.picker
clientlib. Para adicionar uma clientlib a uma caixa de diálogo, você pode usar o extraClientlibs
propriedade. Consulte Personalização de caixas de diálogo da documentação dos Componentes principais do AEM.
A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para o id
foi removido e substituído por uid
. Recomendamos usar uid
ou urlPath
como identificador de categoria. Continuamos a apoiar id
& idAndUrlPath
somente para projetos que usam os Componentes principais da CIF versão 1.x.
Um exemplo completo de trabalho da cifcategoryfield
podem ser encontradas no Componentes principais da CIF projeto.