Documentação AEM as a Cloud Service Guia do usuário

Adicionar ativos digitais a Adobe Experience Manager como Cloud Service Assets add-assets-to-experience-manager

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

undefined
undefined

Adobe Experience Manager Assets aceita vários tipos de ativos digitais de várias fontes. Ele armazena os binários e as representações criadas, pode fazer o processamento de ativos usando vários fluxos de trabalho e serviços do Adobe Sensei, e permite a distribuição por vários canais em muitas superfícies.

O Adobe Experience Manager enriquece o conteúdo binário dos arquivos digitais carregados com metadados avançados, marcas inteligentes, representações e outros serviços de Gerenciamento de Ativos Digitais (DAM). Você pode carregar vários tipos de arquivos, como imagens, documentos e arquivos de imagem raw, de sua pasta local ou de uma unidade de rede para Experience Manager Assets.

Além do upload de navegador mais usado, existem outros métodos de adicionar ativos ao repositório Experience Manager. Esses outros métodos incluem clientes desktop, como o Adobe Asset Link ou o aplicativo de desktop Experience Manager, scripts de carregamento e assimilação que os clientes criariam e integrações de assimilação automatizadas adicionadas como extensões Experience Manager.

Embora seja possível carregar e gerenciar qualquer arquivo binário no Experience Manager, os formatos de arquivo mais usados são compatíveis com serviços adicionais, como extração de metadados ou geração de pré-visualização/representação. Consulte formatos de arquivo compatíveis para obter detalhes.

Você também pode optar por concluir o processamento adicional nos ativos carregados. Vários perfis de processamento de ativos podem ser configurados na pasta, na qual os ativos são carregados, para adicionar metadados, representações ou serviços de processamento de imagens específicos. Consulte processar ativos quando carregado.

Assets forneça os seguintes métodos de carregamento. A Adobe recomenda que você entenda seu caso de uso e a aplicabilidade de uma opção de upload antes de usá-la.

Método de upload

Quando usar?

Persona principal

Interface do usuário do Console do Assets

Upload ocasional, facilidade de pressionar e arrastar, upload localizador. Não use o para fazer upload de muitos ativos.

Todos os usuários

Carregar API

Para decisões dinâmicas durante o upload.

Desenvolvedor

Aplicativo de desktop do Experience Manager

Assimilação de ativos em baixo volume, mas não para migração.

Administrador, profissional de marketing

Adobe Asset Link

Útil quando profissionais de criação e marketing trabalham em ativos nos aplicativos de desktop Creative Cloud compatíveis.

Creative, Profissional de marketing

Assimilação de ativos em massa

Recomendado para migrações em grande escala e assimilações ocasionais em massa. Somente para armazenamentos de dados compatíveis.

Administrador, Desenvolvedor

Upload de ativos upload-assets

Para fazer upload de um arquivo (ou de vários arquivos), você pode selecioná-los na área de trabalho e arrastar a interface do usuário (navegador da Web) para a pasta de destino. Como alternativa, você pode iniciar o upload a partir da interface.

IMPORTANT

O Assets que você carrega em Experience Manager com um nome de arquivo maior que 100 caracteres terá um nome abreviado quando for usado no Dynamic Media.

Os primeiros 100 caracteres no nome do arquivo são usados como estão; todos os caracteres restantes são substituídos por uma sequência alfanumérica. Esse método de renomeação garante um nome exclusivo quando o ativo é usado no Dynamic Media. Também se destina a acomodar o tamanho máximo permitido para o nome do arquivo do ativo no Dynamic Media.

Na interface do usuário do Assets, navegue até o local em que deseja adicionar ativos digitais.
Para fazer upload dos ativos, siga um destes procedimentos:
- Na barra de ferramentas, clique em Criar > Arquivos. Você pode renomear o arquivo na caixa de diálogo apresentada, se necessário.
- Em um navegador compatível com o HTML5, arraste os ativos diretamente para a interface do usuário do Assets. A caixa de diálogo para renomear arquivo não é exibida.
Para selecionar vários arquivos, selecione a chave Ctrl ou Command e selecione os ativos na caixa de diálogo do seletor de arquivos. Ao usar uma iPad, você pode selecionar apenas um arquivo por vez.
Para cancelar um carregamento em andamento, clique em fechar (X) ao lado da barra de progresso. Quando você cancela a operação de carregamento, o Assets exclui a parte parcialmente carregada do ativo.
Se você cancelar uma operação de carregamento antes que os arquivos sejam carregados, o Assets interromperá o carregamento do arquivo atual e atualizará o conteúdo. No entanto, os arquivos que já foram carregados não são excluídos.
A caixa de diálogo de progresso do carregamento em Assets exibe a contagem de arquivos carregados com êxito e os arquivos que falharam no carregamento.
Além disso, a interface de usuário do Assets exibe o ativo mais recente que você carregou para a pasta que você criou primeiro.

NOTE

Para carregar hierarquias de pastas aninhadas, consulte carregar ativos em massa.

Manuseio de uploads para ativos existentes handling-upload-existing-file

É possível carregar um ativo com o mesmo caminho (mesmo nome e mesmo local) de um ativo existente. No entanto, uma caixa de diálogo de aviso é exibida com as seguintes opções:

Substituir ativo existente: se você substituir um ativo existente, os metadados do ativo e qualquer modificação anterior (por exemplo, anotações e recorte) feita no ativo existente serão excluídos.

note note
NOTE
A opção para substituir ativos não estará disponível se o ativo estiver bloqueado ou com check-out.

Criar outra versão: uma nova versão do ativo existente é criada no repositório. Você pode exibir as duas versões na Linha do Tempo e pode reverter para a versão existente anterior, se necessário.
Manter ambos: se você optar por manter ambos os ativos, o novo ativo será renomeado.

Para reter o ativo duplicado em Assets, clique em Manter. Para excluir o ativo duplicado carregado, clique em Excluir.

Manuseio de nome de arquivo e caracteres proibidos filename-handling

Experience Manager Assets impede que você carregue ativos com os caracteres proibidos em seus nomes de arquivo. Se você tentar carregar um ativo com nomes de arquivo contendo um ou mais caracteres não permitidos, o Assets exibirá uma mensagem de aviso e interromperá o carregamento até que você remova esses caracteres ou o carregue com um nome permitido.

Para atender às convenções de nomenclatura de arquivo específicas da sua organização, a caixa de diálogo Carregar Assets permite que você especifique nomes longos para os arquivos carregados. Os seguintes caracteres (lista separada por espaços de) não são suportados:

Caracteres inválidos para o nome do ativo: * / : [ \\ ] | # % { } ? &
Caracteres inválidos para o nome da pasta de ativos: * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

Fazer upload de ativos em massa bulk-upload

A assimilação de ativos em massa pode lidar com muitos ativos com eficiência. No entanto, uma assimilação em grande escala não é apenas um despejo de arquivo amplo ou uma migração casual. Para que uma assimilação em grande escala seja um projeto importante que atenda aos objetivos de sua empresa e seja eficiente, planeje a migração e prepare a organização de ativos. Todas as assimilações são diferentes, portanto, em vez de generalizar, considere a composição do repositório aprimorado e as necessidades de negócios. Veja a seguir algumas sugestões abrangentes para planejar e executar uma assimilação em massa:

Preparar ativos: remova os ativos que não são necessários no DAM. Considere remover ativos não utilizados, obsoletos ou duplicados. Essa manutenção reduz os dados transferidos e os ativos assimilados, resultando em assimilações mais rápidas.
Organizar ativos: considere organizar o conteúdo em alguma ordem lógica, por exemplo, por tamanho de arquivo, formato de arquivo, caso de uso ou prioridade. Em geral, arquivos grandes e complexos exigem mais processamento. Você também pode considerar a assimilação de arquivos grandes separadamente usando a opção de filtragem de tamanho de arquivo (descrita abaixo).
Assimilações escalonadas: considere dividir a assimilação em vários projetos de assimilação em massa. O q permite visualizar o conteúdo mais cedo e atualizar a assimilação conforme necessário. Por exemplo, você pode assimilar ativos com processamento intensivo durante horários que não sejam de pico ou gradualmente em vários blocos. No entanto, você pode assimilar ativos menores e mais simples que não exigem muito processamento de uma só vez.

Para fazer upload de um número maior de arquivos, use uma das abordagens a seguir. Além disso, consulte os casos de uso e métodos

APIs de carregamento de ativos: use um script ou ferramenta de carregamento personalizado que use APIs para adicionar outras manipulações de ativos (por exemplo, traduzir metadados ou renomear arquivos), se necessário.
Experience Manager aplicativo de desktop: útil para profissionais criativos e profissionais de marketing que carregam ativos de seu sistema de arquivos local. Use-o para fazer upload de pastas aninhadas disponíveis localmente.
Ferramenta de assimilação em massa: use para assimilação de grandes quantidades de ativos ocasionalmente ou inicialmente ao implantar Experience Manager.

Ferramenta Importação de ativos em massa asset-bulk-ingestor

A ferramenta é fornecida somente para o grupo de administradores para ser usada na assimilação em larga escala de ativos dos armazenamentos de dados do Azure ou S3. Veja um vídeo que aborda a configuração e a assimilação.

https://video.tv.adobe.com/v/341393/?quality=12&learn=on&captions=por_br

A imagem a seguir ilustra os vários estágios ao assimilar ativos no Experience Manager de um armazenamento de dados:

Ferramenta de assimilação em massa

Pré-requisitos

Uma conta ou um bucket de armazenamento externo do Azure ou da AWS é necessário para usar esse recurso.

NOTE

Crie o recipiente ou bucket da conta de armazenamento como particular e aceite conexões somente de solicitações autorizadas. No entanto, não há suporte para restrições adicionais em conexões de rede de entrada.

NOTE

As contas de armazenamento externo podem ter regras de nome de arquivo/pasta diferentes da ferramenta Importação em massa. Consulte Manipulando nomes de arquivo durante a importação em massa para obter mais detalhes sobre nomes não permitidos/evitados.

Configurar a ferramenta Importação em massa configure-bulk-ingestor-tool

Para configurar a ferramenta Importação em massa, siga estas etapas:

Navegue até Ferramentas > Assets > Importação em massa. Selecione a opção Criar.
Especifique um título para a configuração de importação em massa no campo Título.
Selecione o tipo de fonte de dados na lista suspensa Importar Source.
Forneça os valores para criar uma conexão com a fonte de dados. Por exemplo, se você selecionar Armazenamento Azure Blob como fonte de dados, especifique os valores para a conta de armazenamento do Azure, contêiner Azure Blob e chave de acesso do Azure.
Selecione o modo de autenticação necessário na lista suspensa. A Chave de Acesso do Azure fornece acesso total à conta de armazenamento do Azure, enquanto o Token SAS do Azure permite que o administrador limite os recursos do token usando permissões e políticas de expiração.
Forneça o nome da pasta raiz que contém ativos na fonte de dados no campo Pasta de origem.
(Opcional) 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.
(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.
(Opcional) Especifique a lista separada por vírgulas de tipos MIME a serem excluídos da assimilação no campo Excluir tipos MIME. Por exemplo, image/jpeg, image/.*, video/mp4. Consulte todos os formatos de arquivo com suporte.
Especifique a lista separada por vírgulas de tipos MIME a serem incluídos na assimilação no campo Incluir tipos MIME. Consulte todos os formatos de arquivo com suporte.
Selecione a opção Excluir arquivo de origem após a importação para excluir os arquivos originais do repositório de dados de origem após os arquivos serem importados para Experience Manager.
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 para importar um ativo, se ele já existir. Consulte o significado de substituir e criar opções de versão.
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.
(Opcional) Especifique o arquivo de metadados a ser importado, fornecido em formato CSV no campo Arquivo de metadados. Especifique o arquivo CSV no local do blob de origem e consulte o caminho ao configurar a ferramenta Importação em massa. O formato de arquivo CSV referenciado neste campo é igual ao formato de arquivo CSV quando você Importa e exporta metadados de ativos em massa. Se você selecionar a opção Excluir arquivo de origem após a importação, filtre arquivos CSV usando os campos Excluir ou Incluir Tipo MIME ou Filtrar por Caminho/Arquivo. Você pode usar uma expressão regular para filtrar arquivos CSV nesses campos.
Clique em Salvar para salvar a configuração.

Gerenciar a configuração da ferramenta Importação em massa manage-bulk-import-configuration

Depois de criar a configuração da ferramenta Importação em massa, você pode executar tarefas para avaliar a configuração antes de assimilar ativos em massa na instância do Experience Manager. Para exibir as opções disponíveis para gerenciar a configuração da ferramenta Importação em Massa, selecione a configuração disponível em Ferramentas > Assets > Importação em Massa.

Editar a configuração edit-configuration

Para editar os detalhes da configuração, selecione a configuração e clique em Editar. Não é possível editar o título da configuração e da fonte de dados de importação ao executar a operação de edição.

Excluir a configuração delete-configuration

Selecione a configuração e clique em Excluir para excluir a configuração de importação em massa.

Validar conexão com a fonte de dados validate-connection

Para validar a conexão com a fonte de dados, selecione a configuração e clique em verificar. Se a conexão for bem-sucedida, o Experience Manager exibirá a seguinte mensagem:

Mensagem de êxito de importação em massa

Chamar uma execução de teste para o trabalho de Importação em Massa invoke-test-run-bulk-import

Selecione a configuração e clique em Dry Run para invocar uma execução de teste para o trabalho de Importação em Massa. O Experience Manager exibe os seguintes detalhes sobre o trabalho de Importação em massa:

Resultado do teste

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

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.

Nomes não permitidos na importação em massa

Os seguintes caracteres não são permitidos em nomes de arquivos e pastas:

Caracteres de Controle e Uso Privado (0x00 a 0x1F, \u0081, \uE000)
Nomes de arquivos ou pastas terminando com um ponto (.)

Os arquivos ou pastas com nomes que correspondem a essas condições são ignorados durante o processo de importação e marcados como com falha.

Manipulando o nome do ativo na importação em massa

Para nomes de arquivos de ativos, o nome e o caminho do JCR são limpos usando a API: JcrUtil.escapeIllegalJcrChars.

Caracteres Unicode não são alterados

Substitua os caracteres especiais pelo Código de escape da URL, por exemplo, new%asset.png é atualizado para new%25asset.png:

code language-none
`URL escape code " %22 % %25 ' %27 * %2A / %2F : %3A [ %5B \n %0A \r %0D \t %09 ] %5D \| %7C`

Manipulando o nome da pasta na importação em massa

Para nomes de arquivo de pasta, o nome e o caminho do JCR são limpos usando a API: DamUtil.getSanitizedFolderName.

Caracteres em maiúsculas são convertidos em minúsculas
Caracteres Unicode não são alterados

Substitua os caracteres especiais por traço ('-'), por exemplo, new folder é atualizado para new-folder:

code language-none
`" # % & * + . : ; ? [ ] ^ { } \| / It is used for split folder in cloud storage and is pre-handled, no conversion here. \ Not allowed in Azure, allowed in AWS. \t space It is the space character.`

Agendar uma importação única ou recorrente em massa schedule-bulk-import

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

Criar uma configuração de importação em massa.
Selecione a configuração e selecione Agendar na barra de ferramentas.
Defina uma assimilação única ou agende uma programação por hora, dia ou semana. Clique em Enviar.

Exibir a pasta de destino do Assets view-assets-target-folder

Para exibir o local de destino do Assets em que os ativos são importados após a execução do trabalho de Importação em Massa, selecione a configuração e clique em Exibir Assets.

Executar a ferramenta Importação em massa run-bulk-import-tool

Depois de configurar a ferramenta Importação em massa e, opcionalmente, gerenciar a configuração da ferramenta Importação em massa, você poderá executar o trabalho de configuração para iniciar a assimilação em massa de ativos.

Para iniciar o processo de Importação em massa, navegue até Ferramentas > Assets > Importação em massa, selecione a Configuração de Importação em Massa e clique em Executar. Clique em Executar novamente para confirmar.

Experience Manager atualiza o status do trabalho para Processando e para Com êxito após a conclusão bem-sucedida do trabalho. Para exibir os ativos importados no Experience Manager, clique em Exibir Assets.

Quando o trabalho estiver em andamento, você também poderá selecionar a configuração e clicar em Parar para interromper o processo de assimilação em massa. Clique em Executar novamente para retomar o processo. Você também pode clicar em Dry Run para saber os detalhes dos ativos que ainda têm importação pendente.

Gerenciar trabalhos após a execução manage-jobs-after-execution

Experience Manager permite que você veja o histórico dos trabalhos de importação em massa. O histórico de Jobs compreende o status do job, seu criador, seus logs, juntamente com outros detalhes, como a data e hora de início, data e hora de criação e data e hora de término.

Para acessar o histórico de trabalhos de uma configuração, selecione a configuração e clique em Histórico de Trabalhos. Selecione um trabalho e clique em Abrir.

Agendar trabalho de entrada em massa

Experience Manager exibe o histórico de tarefas. Na página Histórico do trabalho de Importação em massa, você também pode clicar em Excluir para excluir esse trabalho da configuração de Importação em massa.

Fazer upload de ativos usando clientes de desktop upload-assets-desktop-clients

Além da interface de usuário do navegador da Web, o Experience Manager oferece suporte a outros clientes na área de trabalho. Eles também fornecem experiência de upload sem a necessidade de acessar o navegador da Web.

Adobe Asset Link fornece acesso aos ativos do Experience Manager em aplicativos de desktop da Adobe Photoshop, Adobe Illustrator e Adobe InDesign. Você pode carregar o documento aberto no momento no Experience Manager diretamente da interface do usuário do Adobe Asset Link nesses aplicativos de desktop.
O Experience Manager aplicativo de desktop simplifica o trabalho com ativos no desktop, independentemente do tipo de arquivo ou aplicativo nativo que os manipula. É útil fazer upload de arquivos em hierarquias de pastas aninhadas a partir do sistema de arquivos local, pois o upload do navegador só suporta o upload de listas de arquivos simples.

Processar ativos quando carregados process-when-uploaded

Para fazer processamento adicional nos ativos carregados, aplique perfis de processamento nas pastas de upload. Os perfis estão disponíveis na página Propriedades de uma pasta em Assets. Um ativo digital sem uma extensão ou com uma extensão incorreta não é processado conforme desejado. Por exemplo, ao fazer upload desses ativos, nada acontece ou um perfil de processamento incorreto pode se aplicar ao ativo. Os usuários ainda podem armazenar os arquivos binários no DAM.

Propriedades de uma pasta de ativos com opções para adicionar um perfil de processamento

As seguintes guias estão disponíveis:

Os perfis de metadados permitem aplicar propriedades de metadados padrão a ativos carregados nessa pasta.
Processar perfis permite gerar mais representações do que o possível por padrão.

Além disso, se Dynamic Media estiver habilitado na implantação, as seguintes guias estarão disponíveis:

Dynamic Media Os perfis de imagem permitem aplicar cortes específicos (Corte inteligente e corte de pixels) e configuração de nitidez aos ativos carregados.
Dynamic Media Perfis de vídeo permitem que você aplique perfis de codificação de vídeo específicos (resolução, formato, parâmetros).

NOTE

O corte Dynamic Media e outras operações nos ativos não são destrutivas, ou seja, as operações não alteram o original carregado. Em vez disso, fornece parâmetros para cortar ou transformar ao entregar os ativos.

Para pastas que têm um perfil de processamento atribuído, o nome do perfil aparece na miniatura na exibição de cartão. Na exibição de lista, o nome do perfil aparece na coluna Processando Perfil.

Fazer upload ou assimilar ativos usando APIs upload-using-apis

Os detalhes técnicos das APIs e do protocolo de carregamento, bem como os links para o SDK de código aberto e clientes de exemplo, são fornecidos na seção carregamento de ativos da referência do desenvolvedor.

Dicas, práticas recomendadas e limitações tips-limitations

O upload binário direto é um novo método para fazer upload de ativos. Por padrão, ela tem suporte nos recursos e clientes do produto, como a interface de usuário do Experience Manager, o Adobe Asset Link e o aplicativo de desktop do Experience Manager. Qualquer código personalizado personalizado personalizado ou estendido pelas equipes técnicas dos clientes deve usar as novas APIs de upload e os protocolos.
A Adobe recomenda adicionar até 1000 ativos em cada pasta no Experience Manager Assets. Se você tentar fazer isso, poderá receber uma mensagem de alerta dizendo: "Este diretório contém mais de 1000 itens. Os uploads e as novas criações de pasta podem ser adiadas." Embora ainda seja possível adicionar mais ativos a uma pasta, você pode enfrentar problemas de desempenho, como a navegação mais lenta para essas pastas.
Ao selecionar Substituir na caixa de diálogo Conflito de Nome, a ID do ativo é gerada novamente para o novo ativo. Essa ID é diferente da ID do ativo anterior. Se o Assets Insights estiver habilitado para rastrear impressões ou cliques com Adobe Analytics, a ID de ativo regenerada invalida os dados capturados para o ativo em Analytics.
Alguns métodos de carregamento não impedem que você carregue ativos com caracteres proibidos nos nomes de arquivo. Os caracteres são substituídos pelo símbolo -.
Fazer upload de ativos usando o navegador só oferece suporte a listas de arquivos simples e não a hierarquias de pastas aninhadas. Para carregar todos os ativos dentro de uma pasta aninhada, considere usar o aplicativo de desktop.
O método de importação em massa importa toda a estrutura de pastas como ela existe na fonte de dados. No entanto, somente as pastas não vazias são criadas em Experience Manager.

Consulte também

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab