DocumentaçãoGuia do Assets Essentials

Importar ativos em massa usando o Assets Essentials bulk-import-essentials

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Líder

A importação em massa do AEM Assets Essentials permite que admins importem um grande número de ativos de uma fonte de dados para o AEM Assets. Não é mais necessário fazer upload de ativos ou pastas individuais para o AEM Assets.

NOTE
O importador em massa do Assets Essentials usa o mesmo back-end do importador em massa do Assets as a Cloud Service. No entanto, o Assets Essentials oferece mais fontes de dados para importar e uma experiência de usuário mais simplificada.

É possível importar ativos das seguintes fontes de dados:

  • AWS
  • Google Cloud
  • Dropbox
  • OneDrive
  • Azure

Pré-requisitos prerequisites

Fonte de Dados
Pré-requisitos
Azure
  • Conta de armazenamento do Azure
  • Container do Blob Azure
  • Chave de Acesso do Azure ou Token SAS com base no modo de autenticação
AWS
  • Região do AWS
  • Classificação AWS
  • Chave de acesso do AWS
  • Segredo de acesso do AWS
Google Cloud
  • Compartimento de GCP
  • Email da conta de serviço GCP
  • Chave privada da conta de serviço GCP
Dropbox
  • ID do cliente do Dropbox
  • Segredo do cliente do Dropbox
OneDrive
  • ID de locatário do OneDrive
  • ID de cliente do OneDrive
  • Segredo de cliente do OneDrive

Além desses pré-requisitos da fonte de dados, você deve saber o nome da pasta de origem disponível na fonte de dados que contém todos os ativos que precisam ser importados para o AEM Assets.

Configurar o aplicativo para desenvolvedores do Dropbox dropbox-developer-application

Antes de importar ativos da sua conta do Dropbox para o AEM Assets, crie e configure o aplicativo para desenvolvedores do Dropbox.

Execute as seguintes etapas:

  1. Faça logon na sua conta do Dropbox e clique em Criar aplicativos.
    Se você estiver usando uma conta Enterprise do Dropbox, precisará ter acesso à função Administrador de conteúdo.

  2. Na seção Escolher uma API, selecione o único botão de opção disponível.

  3. Na seção Escolha o tipo de acesso necessário, selecione uma das seguintes opções:

    • Selecione Pasta do aplicativo se precisar acessar uma única pasta criada no seu aplicativo na conta do Dropbox.

    • Selecione Dropbox completo se precisar de acesso a todos os arquivos e pastas da sua conta do Dropbox.

  4. Especifique um nome para o aplicativo e clique em Criar aplicativo.

  5. Na guia Configurações do aplicativo, adicione https://experience.adobe.com à seção URIs de redirecionamento.

  6. Copie os valores para os campos Chave do aplicativo e Segredo do aplicativo. Os valores são necessários ao configurar a ferramenta de importação em massa no AEM Assets.

  7. Na guia Permissões, adicione as seguintes permissões na seção Escopos individuais.

    • account_info.read

    • files.metadata.read

    • files.content.read

    • files.content.write

  8. Clique em Enviar para salvar as alterações.

Configurar o aplicativo para desenvolvedores do OneDrive onedrive-developer-application

Antes de importar ativos da sua conta do OneDrive para o AEM Assets, crie e configure o aplicativo para desenvolvedores do OneDrive.

Criar um aplicativo

  1. Faça logon na sua conta do OneDrive e clique em Novo registro.

  2. Especifique um nome para o aplicativo e selecione Apenas contas que estão neste diretório organizacional (somente Adobe – locatário único) em Tipos de conta compatíveis.

  3. Execute as etapas a seguir para adicionar URIs de redirecionamento:

    1. No menu suspenso Selecionar uma plataforma, selecione Web.

    2. Adicione https://experience.adobe.com à seção URIs de redirecionamento:

  4. Clique em Registrar. O aplicativo foi criado com sucesso.

  5. Copie os valores para os campos ID do aplicativo (cliente) e ID do diretório (locatário). Os valores são necessários ao configurar a ferramenta de importação em massa no AEM Assets.

  6. Clique em Adicionar um certificado ou segredo correspondente à opção Credenciais do cliente.

  7. Clique em Novo segredo do cliente, forneça a descrição secreta do cliente, a expiração e clique em Adicionar.

  8. Depois de criar o segredo de cliente, copie o campo Valor (não copie o campo ID do segredo). Isso é necessário ao configurar a importação em massa no AEM Assets.

Adicionar permissões de API

Execute as seguintes etapas para adicionar permissões de API no aplicativo:

  1. Clique em Permissões de API no painel esquerdo e selecione Adicionar uma permissão.
  2. Clique em Gráfico da Microsoft > Permissões delegadas. A seção Selecionar permissão exibe as permissões disponíveis.
  3. Selecione a permissão offline_access em OpenId permissions e a permissão Files.ReadWrite.All em Files.
  4. Clique em Adicionar permissões para salvar as atualizações.

Criação de uma configuração de importação em massa create-bulk-import-configuration

Execute as seguintes etapas para criar uma configuração de importação em massa no Experience Manager Assets:

  1. Clique em Importação em massa no painel esquerdo e clique em Criar importação.

  2. Selecione a fonte de dados. As opções disponíveis incluem Azure, AWS, Google Cloud, Dropbox e OneDrive.

  3. Especifique um nome para a configuração de importação em massa no campo Nome.

  4. Especifique as credenciais específicas da fonte de dados, conforme mencionado em Pré-requisitos.

  5. Forneça o nome da pasta raiz que contém ativos na fonte de dados no campo Pasta de origem.

    note note
    NOTE
    Se estiver usando o Dropbox como fonte de dados, especifique o caminho da pasta de origem com base nas seguintes regras:
    • Se você selecionar Dropbox completo ao criar o aplicativo do Dropbox e a pasta que contiver os ativos existir em https://www.dropbox.com/home/bulkimport-assets, especifique bulkimport-assets no campo Pasta de origem.
    • Se você selecionar Pasta do aplicativo ao criar o aplicativo do Dropbox e a pasta que contiver os ativos existir em https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets, especifique bulkimport-assets no campo Pasta de origem, onde BulkImportAppFolderScope refere-se ao nome do aplicativo. Neste caso, o Apps é adicionado automaticamente após home.

  6. (Opcional) Selecione a opção Excluir arquivo de origem após a importação para excluir os arquivos originais do armazenamento de dados de origem após os arquivos serem importados para o Experience Manager Assets.

  7. Selecione o Modo de importação. Selecione Ignorar, Substituir ou Criar versão. O modo Ignorar é o padrão e nesse modo, o assimilador ignora a importação de um ativo, caso já exista.
    Importação de detalhes da origem

  8. (Opcional) Especifique o arquivo de metadados a ser importado, fornecido em formato CSV no campo Arquivo de metadados. O arquivo de origem de metadados deve estar na pasta de origem. Clique em Próximo para navegar até Localização e filtros.

  9. Defina um local no DAM onde os ativos devem ser importados usando o campo Pasta de destino do Assets. Por exemplo, /content/dam/imported_assets.

  10. (Opcional) Na seção Escolher filtros, forneça o tamanho mínimo de arquivo dos ativos em MB para incluí-los no processo de assimilação no campo Filtrar por tamanho mínimo.

  11. (Opcional) Forneça o tamanho máximo de arquivo dos ativos em MB para incluí-los no processo de assimilação no campo Filtrar por tamanho máximo.

  12. (Opcional) Selecione os tipos MIME a serem incluídos no processo de assimilação usando o campo Incluir tipo MIME. É possível selecionar vários tipos MIME nesse campo. Se não definir um valor, todos os tipos MIME serão incluídos no processo de assimilação.

  13. (Opcional) Selecione os tipos MIME a serem excluídos no processo de assimilação usando o campo Excluir tipo MIME. É possível selecionar vários tipos MIME nesse campo. Se não definir um valor, todos os tipos MIME serão incluídos no processo de assimilação.

    Filtros de importação em massa

  14. Clique em Avançar. Selecione uma das seguintes opções de acordo com sua preferência:

    • Salvar importação para salvar a configuração a fim de executá-la posteriormente.
    • Salvar e executar importação para salvar a configuração e executar a importação em massa.
    • Salvar e agendar a importação para salvar a configuração e agendar a importação em massa para um momento posterior. Você pode escolher a frequência da importação em massa e definir a data e a hora da importação. A importação em massa será executada na data e hora definidas na frequência escolhida.

    Executar importação em massa

  15. Clique em Salvar para executar a opção selecionada.

Tratamento de nomes de arquivo durante a importação em massa filename-handling-bulkimport-assets-view

Ao importar ativos ou pastas em massa, o Experience Manager Assets importa toda a estrutura existente na fonte de importação. O Experience Manager segue as regras incorporadas para caracteres especiais em nomes de ativos e pastas, portanto, esses nomes de arquivo precisam de limpeza. Tanto o nome da pasta quanto o nome do ativo definidos pelo usuário permanece inalterado e é armazenado em jcr:title.

Durante a importação em massa, o Experience Manager procura pelas pastas existentes para evitar a reimportação de ativos e pastas e também verifica as regras de limpeza aplicadas na pasta principal onde a importação ocorre. Se as regras de limpeza forem aplicadas na pasta principal, as mesmas regras serão aplicadas à fonte de importação. Para novas importações, as seguintes regras de limpeza são aplicadas para gerenciar os nomes de arquivo de ativos e pastas.

Para obter mais informações sobre nomes não permitidos, tratamento de nomes de ativos e de nomes de pastas durante a importação em massa, consulte Tratamento de nomes de arquivo durante a importação em massa.

Exibir configurações de importação em massa já existentes view-import-configuration

Para exibir as importações em massa, selecione a opção Importações em massa no painel esquerdo. A página de importações em massa é exibida com a lista de Importações executadas.

Também é possível exibir as Importações salvas e Importações agendadas na lista suspensa de opções.

Salvamento de configurações de importação em massa

Edição de configurações de importação em massa edit-import-configuration

Para editar os detalhes da configuração, clique no Ícone mais correspondente ao nome da configuração e clique em Editar. Não é possível editar o título da configuração e a fonte de dados de importação. Você pode editar as configurações nas guias Importações executadas, programadas ou salvas.

Edição de configurações de importação em massa

Agendar importações únicas ou recorrentes schedule-imports

Para agendar uma importação em massa única ou recorrente, execute as seguintes etapas:

  1. Clique no Ícone mais correspondente ao nome da configuração disponível na guia Importações executadas ou Importações salvas e clique em Agendar. Também é possível reagendar uma importação navegando até a guia Importações programadas e clicando em Programar.

  2. Defina uma assimilação única ou agende uma programação por hora, dia ou semana. Clique em Enviar.

    Agendamento de configurações de importação em massa

Execução de uma verificação de integridade de importação import-health-check

Para validar a conexão com a fonte de dados, clique no Ícone mais correspondente ao nome da configuração e clique em Verificar. Se a conexão for bem-sucedida, o Experience Manager Assets exibirá a seguinte mensagem:

Verificação de integridade da importação em massa

Faça uma execução de prática antes de executar uma importação dry-run-bulk-import

Clique no Ícone mais correspondente ao nome da configuração e clique em Execução de prática para solicitar uma execução de teste para a tarefa de importação em massa. O Experience Manager Assets exibe os seguintes detalhes sobre a tarefa de importação em massa:

Verificação de integridade da importação em massa

Execução de uma importação em massa run-bulk-import

Se a importação foi salva ao criar a configuração, é possível navegar até a guia Importações salvas, clicar no Ícone mais correspondente à configuração e clicar em Executar.

Da mesma forma, caso precise executar uma importação já executada, navegue até a guia Importações executadas, clique no Ícone mais correspondente ao nome da configuração e clique em Executar.

Interrupção ou agendamento de uma importação em andamento schedule-stop-ongoing-report

É possível agendar ou interromper uma importação em massa em andamento usando a caixa de diálogo Status da importação em massa que é exibida na página inicial da Importação em massa durante a importação.

Importação em andamento

Também é possível visualizar os ativos que foram importados na pasta de destino clicando em Exibir ativos.

Exclusão de uma configuração de importação em massa delete-bulk-import-configuration

Clique no Ícone mais correspondente ao nome da configuração existente nas guias Importações executadas, Importações agendadas ou Importações salvas e clique em Excluir para excluir a configuração de importação em massa.

Para exibir o local de destino no Assets onde os ativos são importados após a execução das tarefas de importação em massa, clique no Ícone de mais correspondente ao nome da configuração e clique em Exibir ativos.

Vídeo: importar ativos em massa usando o Assets Essentials

https://video.tv.adobe.com/v/3428012

recommendation-more-help
7f481dbd-d5d0-4232-820e-84b31133bcac