DocumentaçãoCommerceIntegração do AEM Assets

Configurar o projeto do AEM Assets

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

Criado para:

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

Este tópico descreve como configurar seu projeto do AEM Assets para que o namespace do Commerce, o esquema de metadados e a guia Commerce estejam disponíveis no ambiente de criação do AEM. Para obter informações sobre esses recursos, consulte Metadados do Commerce no AEM Assets.

Você tem duas opções para configurar o projeto AEM Assets:

  • [Recomendado]{class="badge positive"} Integração de autoatendimento — Nas versões 2026.5.26309 e posteriores do AEM, habilite a integração no Cloud Manager definindo uma variável de ambiente e ativando o Dynamic Media com recursos OpenAPI. Não é necessária nenhuma implantação de código personalizado. Consulte Habilitar a integração do Commerce (autoatendimento).

  • Configuração manual — implante o pacote assets-commerce por meio de um pipeline da Cloud Manager. Use essas etapas manuais quando precisar implantar um código de pacote personalizado ou se estiver em uma versão do AEM anterior à 2026.5.26309. Consulte Instalar o pacote assets-commerce manualmente.

TIP
Verifique a versão atual do AEM no menu superior direito: Help > About AEM.

Habilitar a integração do Commerce (autoatendimento) enable-aem-commerce-self-service

[Com Suporte]{class="badge informative" title="Compatível"} AEM versão 2026.5.26309 e posterior.

Em versões compatíveis do AEM, você habilita a integração do Commerce com o Cloud Manager sem implantar código personalizado. O namespace do Commerce, o esquema de metadados e a guia Commerce são provisionados automaticamente quando você habilita a integração no serviço do Autor.

Pré-requisitos de autoatendimento

  • Acesso ao Programa e aos ambientes do AEM Cloud Manager com as funções de Gerente de Programa e de Implantação.

  • Um programa do AEM na versão 2026.5.26309 ou posterior.

  • A ID da Organização IMS da sua instância do Commerce.

    A instância do Commerce e o ambiente de criação do AEM Assets devem estar na mesma organização IMS.

Etapa 1: criar o programa e os ambientes

A criação de um programa no Cloud Manager é um único processo de assistente — o programa e seus ambientes são configurados em várias etapas e salvos juntos no final.

  1. No Cloud Manager, selecione Add Program.

  2. Escolha Set up for production, insira um nome de programa e selecione Continue.

  3. Na etapa Solutions & Add-ons, selecione as soluções e os complementos necessários ao seu projeto, incluindo Dynamic Media, e selecione Continue.

    Etapa de soluções e complementos da Cloud Manager com Dynamic Media selecionada {width="600" modal="regular"}

  4. Na etapa Add Environment, insira nomes para os ambientes Produção e Preparo e, em seguida, selecione uma região.

    Caixa de diálogo Adicionar ambiente do Cloud Manager com detalhes sobre Produção e Preparo {width="600" modal="regular"}

  5. Selecione Save para criar o programa com seus ambientes.

Etapa 2: ativar a variável de integração do Commerce

No Cloud Manager, abra o ambiente criado na Etapa 1 e, em seguida:

  1. Selecione a guia Configuration.

  2. Adicione uma variável de ambiente com os seguintes valores e selecione Add e Save:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo Valor
    Nome COMMERCE_INTEGRATION_ENABLED
    Valor true
    Serviço aplicado Autor
    Tipo Variável

    Configuração do ambiente Cloud Manager com a variável COMMERCEINTEGRATIONENABLED aplicada ao serviço de Autor {width="600" modal="regular"}

    O ambiente é atualizado para aplicar a configuração. Aguarde até que o status do ambiente retorne para Running.

Etapa 3: ativar o Dynamic Media com recursos OpenAPI

  1. Na guia do ambiente General, localize Dynamic Media.

  2. Próximo a Os recursos OpenAPI estão disponíveis, selecione Click to activate.

    Guia Ambiente Geral mostrando o link de ativação da OpenAPI do Dynamic Media {width="600" modal="regular"}

    A ativação é executada em segundo plano. Quando terminar, o ambiente estará pronto para a integração com o Commerce.

    note
    NOTE
    Se Click to activate não estiver disponível, abra um tíquete de suporte para habilitar o Dynamic Media com recursos OpenAPI.

Etapa 4: validar a configuração

Alterne para o ambiente do autor do AEM Assets e abra qualquer ativo. Edite suas propriedades e confirme se o esquema de metadados padrão inclui a guia Commerce e se os campos Product Data e Eligible for Commerce estão visíveis.

Instalar o pacote de assets-commerce manualmente

NOTE
Use este método manual para implantar o código de pacote personalizado ou se você estiver em versões do AEM anteriores a 2026.5.26309. Em versões com suporte, use Habilitar a integração do Commerce (autoatendimento).

Pré-requisitos

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

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 estas 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.

Etapas de instalação

  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.

Configurar um perfil de metadados (opcional)

No ambiente de criação do AEM Assets, defina valores padrão para os metadados de ativos do Commerce criando um perfil de metadados. Para usar esses padrões automaticamente, aplique o novo perfil às pastas do AEM Asset. 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 ativos aprovados do Commerce automaticamente à 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