Resolução de erros de upload de ativos e metadados causados por caracteres não compatíveis nos nomes de arquivo do AEM
O AEM Assets impõe validação estrita em nomes de ativos e pastas, de modo que uploads, atualizações de metadados, ações de publicação e respostas de API falham quando um nome de arquivo contém um caractere incompatível, como *, /, :, #, %, & ou {}. A interface do usuário do AEM bloqueia esses caracteres totalmente, enquanto as importações em massa e a assimilação de API limpam ou codificam silenciosamente e os sistemas downstream, como o Dynamic Media ou a API do Assets, retornam caminhos corrompidos. A causa é que o AEM, o repositório JCR subjacente e os sistemas conectados não podem armazenar ou processar com segurança esses caracteres. Renomear os ativos afetados para usar somente os caracteres permitidos e assimilá-los novamente restaura uploads, edições de metadados, publicação e caminhos de API limpos.
Descrição description
Ambientes:
- Adobe Experience Manager as a Cloud Service
- Adobe Experience Manager Managed Services
- Adobe Experience Manager 6.5 (no local)
- AEM Assets, o importador em massa e a API do Assets
- Dynamic Media (Scene7) e Asset Share Commons
Problema/sintomas:
- O carregamento da interface do usuário do AEM falha com a mensagem Caracteres "*/:
[`]` |#%{}?& não são permitidos no nome de arquivo ". - Gerenciar Publicação retorna Os recursos selecionados não são válidos quando um nome de arquivo contém #.
- Os metadados não podem ser atualizados em ativos cujos nomes de arquivo contenham & ou outros caracteres inválidos.
- Falha nas relações de ativos com Não foi possível atualizar a relação devido a caracteres especiais nos nomes de ativos.
- O importador em massa ou a importação S3 renomeia ativos com caracteres de escape, como um apóstrofo para
%27ou % para%25. - A API do Assets retorna caminhos corrompidos em que um caractere não compatível é decodificado em ?, como um sobrescrito, tornando-se ?.
Causa raiz:
O AEM, o repositório JCR subjacente e os sistemas downstream, como o Dynamic Media e a API do Assets, não podem armazenar ou processar com segurança nomes de ativos que contêm determinados caracteres. A interface do usuário do AEM impõe validação do lado do cliente, enquanto a importação em massa e a assimilação de API aplicam a limpeza JCR e regras de codificação de URL. Caracteres não suportados causam falhas de assimilação, falhas de atualização de metadados, problemas de publicação e respostas quebradas da API.
Como confirmar
- Compare o nome do arquivo com a lista de caracteres proibidos da sua variante do AEM. A mensagem de erro da interface do usuário mostra os caracteres inválidos:
* / : [ \ ] | # % { } ? & ;=para AEM as a Cloud Service e o mesmo conjunto para AEM 6.5. - Determine como o ativo foi assimilado: upload manual da interface, importação do S3, importador em massa, Gerenciador de pacotes ou API. Os uploads manuais falham imediatamente em caracteres inválidos, o S3 e as importações em massa limpam silenciosamente e o Gerenciador de pacotes ignora a validação.
Resolução resolution
Siga estas etapas para resolver o problema:
- Renomeie o ativo para remover caracteres não suportados. Na interface do usuário do AEM, selecione o ativo, abra Propriedades e renomeie-o, ou faça upload novamente do ativo com um nome de arquivo limpo que use apenas caracteres permitidos. Tente novamente a ação que falhou, seja a atualização de metadados, publicação ou relação.
- Para problemas em massa que afetam centenas ou milhares de ativos, aplique uma renomeação sistemática. Defina uma convenção de nomenclatura limpa (substituir & por “e”, remover # e substituir espaços por hifens) e, em seguida, assimile novamente os arquivos corrigidos no AEM ou execute um script de automação no sistema de origem ou no DAM de upstream para limpar os nomes antes de fazer o upload. Pesquise os ativos inválidos anteriormente e confirme os nomes atualizados.
- Validar integrações downstream. Confirmar se os nomes higienizados resolvem problemas com miniaturas e downloads do Asset Share Commons, caminhos de API do Assets que não são mais exibidos? e fluxos de trabalho de upload e pesquisa do Dynamic Media. Teste a pesquisa, as chamadas de API e os fluxos de publicação.
- Confirme a correção. Recarregue o ativo com o nome de arquivo limpo e verifique se ele é carregado sem um aviso de validação, se os metadados foram salvos, se a opção Gerenciar publicação é executada sem o erro Os recursos selecionados não são válidos e se a API do Assets retorna um caminho sem ? caracteres.
Se o problema persistir
Entre em contato com o Suporte da Adobe se os uploads, edições de metadados ou publicações ainda falharem após a limpeza dos nomes de arquivo, se as respostas da API mostrarem formatação de caminho incorreta para nomes de arquivo que contenham apenas caracteres permitidos ou se o importador em massa se comportar de forma inconsistente entre os ambientes. Forneça os nomes de arquivo exatos, o método de upload, os URLs do ambiente, as mensagens de erro e as capturas de tela.