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

Migrar arquivos de mídia para o AEM Assets DAM

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

Criado para:

  • Usuário

O Adobe Commerce e o Adobe Experience Manager (AEM) fornecem recursos integrados para simplificar a migração de arquivos de mídia do Commerce para o sistema de gerenciamento de ativos digitais (DAM) da AEM Assets. Você também pode migrar arquivos de mídia de outras fontes.

Pré-requisitos

Categoria
Requisito
Requisitos do sistema
  • Ambiente do AEM as a Cloud Service provisionado com o AEM Assets
  • Capacidade de armazenamento suficiente
  • Largura de banda de rede para transferências de arquivos grandes
Permissões e acesso necessários
  • Acesso de administrador ao AEM Assets as a Cloud Service
  • Acesso ao sistema de origem onde os arquivos de mídia são armazenados (Adobe Commerce ou sistema externo)
  • Permissões apropriadas para acessar serviços de armazenamento na nuvem
Conta de Armazenamento na Nuvem
  • Conta de armazenamento AWS S3 ou Azure Blob
  • Configuração privada de container/bucket
  • Credenciais de autenticação
Conteúdo do Source
Preparação de Metadados

Práticas recomendadas de migração

  1. Prepare ativos antes da migração, removendo conteúdos não utilizados e duplicados.

  2. Organize ativos logicamente por tamanho, formato ou caso de uso.

  3. Considere dividir grandes migrações em lotes menores.

  4. Agendar importações que consomem muitos recursos fora das horas de pico.

  5. Valide o mapeamento de metadados antes da importação completa.

Fluxo de trabalho de migração

Siga o fluxo de trabalho de migração para exportar arquivos de mídia do Adobe Commerce ou outro sistema externo e importá-los para o DAM do AEM Assets.

Etapa 1: exportar conteúdo da fonte de dados existente

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

Para os comerciantes do Adobe Commerce, o módulo de Armazenamento remoto pode facilitar as importações e exportações de arquivos de mídia. Esse módulo permite que as empresas armazenem e gerenciem arquivos de mídia usando serviços de armazenamento remoto, como o AWS S3. Para configurar o armazenamento remoto para sua instância do Commerce, consulte Configurar Armazenamento Remoto no Guia de Configuração do Commerce.

Se você tiver arquivos de mídia armazenados fora do Adobe Commerce, carregue-os diretamente para uma das fontes de dados compatíveis com o AEM as a Cloud Service.

Etapa 2: criar um arquivo CSV para mapeamento de metadados

Depois de exportar os arquivos de mídia, crie um arquivo CSV para mapear esses ativos com os metadados necessários para automação. O CSV deve incluir campos do produto, posição e mapeamento de funções, garantindo o alinhamento com o perfil de metadados do AEM Assets.

Para cada arquivo de mídia que você planeja migrar, forneça valores para os campos de metadados incluídos no perfil de metadados do AEM Assets para ativos do Commerce, conforme descrito na tabela a seguir.

Metadados
Descrição
Valor
assetPath
O caminho completo onde o ativo será armazenado no repositório do AEM Assets.

Use o caminho para criar subpastas para organizar ativos do Commerce, por exemplo content/dam/commerce/<brand>/<type>.
/content/dam/commerce/<sub-folder>/..<filename>
comércio:positions
A posição/ordem do ativo em galerias de produtos
Vários valores numéricos separados por barra vertical ("Number: multi")
comércio:isCommerce
Sinalizador que indica se o ativo é usado no comércio
Yes
comércio:skus
SKUs de produto associadas a este ativo
Vários valores de string separados por barra vertical (String: multi)
comércio:roles
As funções ou tipos de imagens para o ativo (por exemplo, thumbnail, main image, swatch)
Vários valores separados por ponto e vírgula (por exemplo, "miniatura; imagem; imagem_amostra; imagem_pequena")
Código CSV

Use este exemplo de código CSV para criar o arquivo em um editor de código ou aplicativo de planilha, como o Microsoft Excel.

code language-csv 
assetPath,commerce:positions{{Number: multi}},commerce:isCommerce{{String}},commerce:skus{{String: multi}},commerce:roles{{String: multi}}
/content/dam/commerce/sample1.jpg,1,Yes,sku1,thumbnail; image; swatch_image; small_image
/content/dam/commerce/sample2.jpg,1|1|1,Yes,sku1|sku2|sku3,thumbnail; image; swatch_image; small_image|image|image; small_change

Etapa 3: Importação em massa do Assets para o AEM Assets

Depois de criar o arquivo de mapeamento de metadados, use a Ferramenta de importação em massa do AEM Assets para importar os ativos.

Veja a seguir uma visão geral de alto nível sobre o uso da ferramenta.

  1. Faça logon no ambiente de criação do AEM Assets as a Cloud Service.

  2. Na exibição Ferramentas do Experience Manager, selecione Assets > Bulk Import.

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

  3. Nas Configurações de Importação em Massa, selecione Create para abrir o formulário de configuração.

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

  4. Defina e salve a configuração.

    Você precisará de:

    • Credenciais de autenticação para sua fonte de dados
    • A pasta de destino no AEM Assets onde os arquivos importados serão armazenados
    • Opcional. Informações sobre os tipos MIME, o tamanho do arquivo e outros parâmetros para personalizar a configuração de importação
    • O caminho para o arquivo CSV de mapeamento de metadados carregado na instância de armazenamento na nuvem.

    Para obter etapas detalhadas, consulte Configurar a ferramenta Importação em Massa no Guia do Usuário do AEM Assets as a Cloud Service.

  5. Depois de salvar a configuração, use as ferramentas de importação em massa para testar e executar a operação de importação.

Related Articles
Demonstração de vídeo da ferramenta de importação em massa
Dicas, práticas recomendadas e limitações
Carregar ou assimilar ativos usando APIs
recommendation-more-help
ca3e43e7-8fc7-412c-9d52-80a723c40cea