DocumentaçãoCommerceIntegração do AEM Assets

Configurar o projeto do AEM Assets para suportar metadados do Commerce

Última atualização: 28 de maio de 2026

Criado para:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Ao usar o AEM Assets como um sistema de gerenciamento de ativos digitais (DAM) para Commerce, a instalação do pacote assets-commerce permite gerenciar imagens e vídeos para produtos Commerce do ambiente de criação do AEM.

Conclua as seguintes etapas para configurar o projeto do AEM Assets com o código do pacote e os metadados necessários para gerenciar ativos do Commerce no ambiente de criação do AEM:

  1. Saiba mais sobre o conteúdo do pacote assets-commerce

  2. Conclua as etapas de instalação para configurar o projeto do AEM Assets para ser compatível com os metadados do Commerce

Conteúdo do pacote de comércio de ativos do AEM Commerce

A Adobe fornece um código de pacote do AEM Commerce assets-commerce para adicionar recursos de Namespace e Esquema de Metadados do Commerce à configuração de ambiente do Experience Manager Assets as a Cloud Service.

Esse código de pacote adiciona os seguintes recursos ao ambiente de criação do AEM Assets:

  • Um namespace personalizado, Commerce para identificar propriedades relacionadas ao Commerce.

    • Um tipo de metadados personalizado commerce:isCommerce com o rótulo Eligible for Commerce para marcar ativos da Commerce associados a um projeto do Adobe Commerce.

    • Um tipo de metadados personalizado commerce:skus e um componente correspondente da interface do usuário para adicionar uma propriedade Product Data. Os dados do produto incluem as propriedades de metadados para associar um ativo do Commerce às SKUs do produto.

      Controle de IU de Dados de Produto Personalizado {width="600" modal="regular"}

    • Um tipo de metadados personalizado commerce:roles e commerce:positions atributos para mostrar como o ativo é visualizado no Commerce.

    • Metadados de vários campos (Alt texts) de texto alternativo para que os editores possam inserir texto alternativo digitado pelo código de exibição da loja do Commerce. Isso não altera a forma como as imagens do produto são atribuídas ou o escopo é definido no catálogo. Consulte Texto alternativo nos metadados do AEM Assets.

  • Um formulário de esquema de metadados com uma guia Commerce que inclui os campos Eligible for Commerce e Product Data para marcar ativos do Commerce. O formulário também fornece opções para mostrar ou ocultar os campos roles e position da interface do AEM Assets.

    Guia Commerce para o formulário de esquema de metadados do AEM Assets {width="600" modal="regular"}

  • Um ativo de Commerce marcado e aprovado equipment_6.jpg de amostra para oferecer suporte à sincronização de ativos inicial. Somente ativos aprovados do Commerce podem ser sincronizados do AEM Assets para o Adobe Commerce.

NOTE
Consulte a página readme no GitHub para obter mais informações sobre o código do pacote do AEM Commerce.

Texto alternativo em metadados do AEM Assets

O multicampo Alt texts​está disponível no editor de metadados de ativos da AEM Assets, na guia Commerce, ao editar uma imagem qualificada.

IMPORTANT
O comportamento de exibição por loja se aplica somente ao texto alternativo. A integração do AEM Assets não sincroniza imagens de produtos diferentes por exibição da loja do Adobe Commerce. As imagens de produto do AEM continuam a ser sincronizadas com o Commerce com o mesmo comportamento de atribuição de galeria de antes desta versão.

O multicampo contém uma linha por exibição de loja do Commerce. Cada linha tem duas entradas:

  • Store View Code — O identificador de exibição de armazenamento (por exemplo default ou en_US).

  • Alt Text — Texto alternativo para a exibição de armazenamento, limitado a 255 caracteres.

Selecione Add para adicionar mais linhas para exibições de armazenamento adicionais. Para remover uma linha, selecione o ícone Delete nessa linha para removê-la.

Múltiplos campos de textos alternativos com entradas de Código de Exibição de Loja e Texto Alternativo {width="600" modal="regular"}

Ao salvar, a validação do lado do cliente bloqueia o envio se qualquer linha tiver um Store View Code​vazio ou se duas linhas usarem o mesmo código de exibição de armazenamento (não diferencia maiúsculas de minúsculas).

Entradas de texto alternativo são mantidas nos metadados de ativos JCR como duas propriedades String[] alinhadas por índice:

  • commerce:altTextStoreViews: Armazenar código de exibição para cada linha.
  • commerce:altTextValues: texto alternativo correspondente no mesmo índice de cada entrada em commerce:altTextStoreViews.

Quando esses ativos são sincronizados com o Adobe Commerce, o texto alternativo de exibição por loja é gravado na galeria de mídia do produto para os códigos de exibição da loja correspondentes. O mapeamento de imagem subjacente não foi alterado.

Pré-requisitos

Você precisa dos seguintes recursos e permissões para implantar o código do pacote assets-commerce no ambiente do AEM Assets as a Cloud Service AEM:

Visuais do produto

[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."} O Dynamic Media com recursos OpenAPI é um autoatendimento para Exibições de produtos viabilizado pelo AEM Assets.

  1. Navegue até o Cloud Manager.

  2. Selecione o ambiente desejado.

  3. Habilitar o Dynamic Media com recursos OpenAPI.

    Se o botão Dynamic Media com recursos OpenAPI não estiver ativo, abra um tíquete de suporte.

AEM Assets

[Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."} no AEM as a Cloud Service, envie um tíquete de suporte do Adobe com as seguintes informações:

  • Título: habilitar a OpenAPI do Dynamic Media para integrar totalmente o Adobe Commerce ao AEM Assets

    • Conteúdo do tíquete de suporte:

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

Depois de enviar o tíquete de suporte, o Adobe habilita o Dynamic Media com recursos OpenAPI no ambiente do Cloud Services e compartilha os detalhes, como a ID de cliente IMS, para você prosseguir com a integração.

Etapa 1: instalar o pacote assets-commerce

  1. Navegue até o AEM Cloud Manager, selecione um programa e crie ambientes de produção e de preparo que você deseja integrar ao Adobe Commerce.

  2. Clonar o repositório Git gerenciado pela Adobe para o programa selecionado.

    Credenciais do repositório do Cloud Manager e comando clone {width="600" modal="regular"}

    Em Pipelines do Cloud Manager, selecione Access Repo Info para abrir Repository Info. Copie o valor URL ou Git command line, gere uma senha de acesso, se necessário, e clone localmente com seu cliente Git.

  3. No GitHub, baixe o código do pacote do repositório do AEM Assets Commerce.

  4. Em seu ambiente de desenvolvimento local do AEM, copie manualmente o código baixado no repositório gerenciado existente do Adobe.

  5. Em todos os arquivos filter.xml e pom.xml do seu projeto, substitua todas as ocorrências de <my-app> pelo nome do seu aplicativo.

    note
    NOTE
    Como alternativa, você pode instalar o código personalizado na configuração do projeto do AEM Assets como um pacote Maven.

  6. Confirme as alterações e envie a ramificação de desenvolvimento local para o repositório Git do Cloud Manager.

  7. Configure um pipeline de implantação ou verifique se o pipeline pode implantar alterações no ambiente selecionado.

    Pipelines do Cloud Manager {width="600" modal="regular"}

    Quando o pipeline existir, abra o menu de ações (…) para Run, Edit, View/Edit variables ou outras ações — consulte a documentação do pipeline de Cloud Manager vinculada acima.

  8. No AEM Cloud Manager, atualize o ambiente do AEM usando o pipeline para implantar seu código.

  9. Ir para qualquer ativo e editar suas propriedades para validar as alterações:

    • O esquema de metadados padrão inclui a guia Commerce.

    • As SKUs do produto e os campos Eligible for Commerce estão visíveis.

A guia Commerce não está visível nas propriedades

Se a guia Commerce não aparecer nas propriedades, você deverá concluir manualmente as seguintes etapas no editor de esquema de metadados:

  1. Navegue até o editor de esquema de metadados.

  2. Selecione Editar para modificar o formulário de esquema de metadados padrão.

  3. Crie uma guia Commerce e selecione-a.

  4. Arraste e solte o componente Produto na guia Commerce e mapeie-o para a propriedade commerce:skus.

  5. Marque a caixa de seleção para mostrar funções e mostrar ordem.

  6. Arraste e solte um componente caixa de seleção na guia Commerce e mapeie-o para a propriedade commerce:isCommerce. Defina Sim e Não como as opções.

Caso encontre outros problemas, crie um tíquete de suporte ou entre em contato com o representante de vendas da Integração da AEM Assets para obter ajuda.

Etapa 2: Opcional. Configurar um perfil de metadados

No ambiente de criação do AEM Assets, defina valores padrão para os metadados de ativos do Commerce criando um perfil de metadados. Em seguida, aplique o novo perfil às pastas do AEM Asset para usar automaticamente esses padrões. Essa configuração simplifica o processamento de ativos, reduzindo as etapas manuais.

Ao configurar o perfil de metadados, é necessário configurar apenas os seguintes componentes:

  • Adicione uma guia Commerce. Essa guia ativa as definições de configuração específicas do Commerce adicionadas pelo modelo.

  • Adicione o campo Eligible for Commerce à guia Commerce.

O componente da interface de dados do produto é adicionado automaticamente com base no modelo.

Definir o perfil de metadados

  1. Faça logon no ambiente de criação do Adobe Experience Manager.

  2. No espaço de trabalho do Adobe Experience Manager, acesse o espaço de trabalho Administração de conteúdo do autor para o AEM Assets clicando no ícone Adobe Experience Manager.

    criação no AEM Assets {width="600" modal="regular"}

  3. Abra as Ferramentas do administrador selecionando o ícone de martelo.

    Administrador do AEM Author Admin para gerenciar perfis de metadados {width="600" modal="regular"}

  4. Abra a página de configuração do perfil clicando em Metadata Profiles.

  5. Create um perfil de metadados para a integração com o Commerce.

    Administrador do AEM Author Admin adicionou perfis de metadados {width="600" modal="regular"}

  6. Adicione uma guia para metadados do Commerce.

    1. À esquerda, clique em Settings.

    2. Clique em + na seção da guia e especifique o Tab Name, Commerce.

  7. Adicione o campo Eligible for Commerce ao formulário.

    Administrador do AEM Author adiciona campos de metadados ao perfil {width="600" modal="regular"}

    • Clique em Build form.

    • Arraste o campo Single Line text para o formulário.

    • Adicione o texto Eligible for Commerce para o rótulo clicando em Field Label.

    • Na guia Configurações, adicione o texto do rótulo a Rótulo do Campo.

    • Defina o texto do espaço reservado como yes.

    • No campo Map to Property, copie e cole o seguinte valor

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. Opcional. Para sincronizar automaticamente ativos aprovados do Commerce à medida que forem carregados no ambiente AEM Assets, defina o valor padrão do campo Review Status​na guia Basic como approved.

  9. Salve a atualização.

Aplicar o perfil de metadados à pasta de origem dos ativos do Commerce

  1. Na página Metadata Profiles, selecione o perfil de integração do Commerce.

  2. No menu de ações, selecione Apply Metadata Profiles to Folders.

  3. Selecione a pasta que contém os ativos do Commerce.

    Crie uma pasta do Commerce se ela não existir.

  4. Selecione Apply.

Próximas etapas

recommendation-more-help
commerce-help-aem-assets-integration