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

Configurar o projeto do AEM Assets para suportar metadados do Commerce

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:
  • CMS

Criado para:

  • Usuário

Para gerenciar arquivos de ativos do Commerce no AEM Assets, conclua as seguintes etapas para configurar o projeto do AEM Assets com o código de padronização e os metadados necessários para gerenciar ativos do Commerce no ambiente de criação do AEM.

  • Etapa 1: instale um modelo de projeto do AEM com o código padrão para adicionar os recursos de esquema de namespace e metadados do Commerce à configuração de ambiente do Experience Manager Assets as a Cloud Service.
  • Etapa 2: configure o perfil de metadados para aplicar aos arquivos de ativos do Commerce

Adicionar o código padrão ao projeto do AEM

A Adobe fornece uma matriz do AEM Commerce, assets-commerce, para adicionar recursos de namespace e esquema de metadados do Commerce à configuração do ambiente Experience Manager Assets as a Cloud Service. Implante este código no seu ambiente como um pacote Maven. Em seguida, configure os metadados do Commerce no ambiente de criação do AEM Assets para concluir a configuração.

O modelo 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 modelo do AEM Commerce.

Pré-requisitos

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

Instalar o pacote commerce-assets

  1. No AEM Cloud Manager, crie ambientes de produção e de preparo para seu projeto do AEM Assets, se necessário.

  2. Configurar um pipeline de implantação, se necessário.

  3. No GitHub, baixe o código da matriz do AEM Commerce.

  4. A partir do seu ambiente de desenvolvimento local do AEM, instale o código personalizado na sua configuração de ambiente do AEM Assets como um pacote Maven ou copiando manualmente o código na configuração de projeto existente.

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

  6. No AEM Cloud Manager, implante seu código para atualizar o ambiente do AEM.

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 configurações 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óxima etapa

[Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."} Instalar pacotes do Adobe Commerce

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