Resolução de falhas de Dynamic Media Smart Crop causadas pelo dispatcher e pelo cache do CDN
O Dynamic Media Smart Crop não carrega corretamente ou exibe representações de corte atualizadas no AEM Assets e no AEM Sites quando o armazenamento em cache do dispatcher ou o armazenamento em cache do Dynamic Media CDN serve recursos obsoletos ou bloqueados. Os sintomas comuns incluem editores de corte inteligente quebrados, alças de corte ausentes e representações de corte obsoletas. Resolva o problema validando o cache do dispatcher e as regras de filtro, limpando os recursos em cache, invalidando o conteúdo CDN afetado e verificando o comportamento do Recorte inteligente.
Descrição description
Ambiente
- Adobe Experience Manager Dynamic Media
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Adobe Experience Manager Managed Services (AMS)
- AEM 6.5 com Dynamic Media Smart Crop
Problema/Sintomas
- O Editor de corte inteligente exibe uma imagem quebrada em vez da interface de edição.
- O Corte inteligente é carregado somente após a adição de um parâmetro de ignorar cache, como
?nocache=123. - As representações atualizadas do Recorte inteligente não aparecem nas páginas do AEM Sites até que um parâmetro de desvio de cache seja adicionado.
- As alças de corte, os controles de redimensionamento ou as imagens de visualização não são exibidos corretamente.
Causa
O Dispatcher armazena em cache ou bloqueia os recursos do editor de Recorte Inteligente em /libs/dam/gui/content/s7dam/smartcrop/*, impedindo que o editor seja carregado corretamente. O armazenamento em cache do CDN do Dynamic Media também serve representações de Recorte inteligente desatualizadas após atualizações de ativos, até que o cache do CDN seja atualizado.
Resolução resolution
Execute as seguintes etapas para resolver o problema:
- Determine se o problema é causado pelo armazenamento em cache do Dispatcher ou do Dynamic Media CDN testando o Editor de recorte inteligente com um parâmetro de consulta de desvio de cache.
- Configure o Dispatcher para excluir do cache os recursos do editor de Recorte inteligente. Adicione uma regra de negação de cache para:
/libs/dam/gui/content/s7dam/smartcrop/*. Verifique se o Dispatcher não serve mais esses recursos do cache. - Revise as regras de filtro do Dispatcher e verifique se os caminhos do editor de Recorte inteligente são explicitamente permitidos. Confirme se os URLs do Recorte inteligente retornam o conteúdo esperado em vez das respostas HTTP 403 ou 404.
- Limpe o cache do Dispatcher para remover o editor de corte inteligente HTML, JavaScript e recursos relacionados obsoletos. Recarregue o Editor de recorte inteligente e verifique se ele funciona sem parâmetros de desvio de cache.
- Valide a funcionalidade Recorte inteligente abrindo um ativo e confirmando se os manipuladores de recorte, controles de redimensionamento, imagens de visualização e componentes do editor estão carregados corretamente.
- Se as representações de Recorte inteligente atualizadas ainda não aparecerem após a publicação, investigue o armazenamento em cache do CDN do Dynamic Media. Publique novamente o ativo e verifique se as representações atualizadas aparecem sem parâmetros de consulta.
- Invalide os ativos afetados do Dynamic Media por meio do fluxo de trabalho de invalidação da CDN (ou da API, quando aplicável), recarregue as páginas afetadas e verifique se as representações atualizadas do Recorte inteligente são exibidas.
- Se os perfis de Recorte inteligente parecerem inconsistentes entre os ativos, abra as propriedades da pasta afetada e salve a configuração para atualizar os metadados da pasta. Verifique se o Perfil de imagem correto é herdado pela pasta e por todos os ativos.