DocumentaçãoCommerceGuia de integração do AEM Assets

Configurar o projeto do AEM Assets para suportar metadados do Commerce

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:
  • CMS

Criado para:

  • Usuário

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 ​

  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 namespace Commerce e recursos de esquema de metadados à 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.

  • 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 para obter mais informações sobre o código do pacote do AEM Commerce.

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:

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. Configure um pipeline de implantação ou verifique se o pipeline pode implantar alterações no ambiente selecionado.

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

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

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

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

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

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

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

  3. 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, será necessário criar manualmente uma no editor de esquema de metadados.

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

  2. Clique em 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. Clique em Apply.

Próximas etapas

recommendation-more-help
ca3e43e7-8fc7-412c-9d52-80a723c40cea