DocumentaçãoKCS da Experience Cloud

AEM: falhas de visualização e edição do ativo DAM após a atualização do DITA em DEV/STAGE/PROD

Última atualização: 17 de julho de 2026

Este artigo aborda problemas com a funcionalidade de visualização e edição de ativos do DAM em ambientes do Adobe Experience Manager.

Descrição description

Ambiente


Adobe Experience Manager (AEM) (todas as versões)

Problema/Sintomas


Na interface do administrador do AEM Assets, a visualização de algumas imagens (por exemplo: clicar no ativo) pode mostrar brevemente o ativo, e a visualização fica em branco. O problema geralmente está limitado a ativos específicos, enquanto outros ativos no mesmo ambiente podem continuar a ser visualizados normalmente.

Os rastreamentos de rede do navegador para ativos afetados mostram uma solicitação do visualizador do Dynamic Media com falha semelhante a:

GET /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse

A solicitação retorna:

HTTP 404
No preview server defined for root ID referenced in net path

Os logs relacionados do AEM podem conter:

Unable to forward request for root [ content] , no preview servlet defined for [ content]

Resolução resolution

Siga estas etapas para resolver o problema:

  1. Inspecionar os metadados do Dynamic Media do ativo afetado Abra o nó de metadados do ativo e verifique as seguintes propriedades em:

    code language-none 
    /content/dam/<asset-path>/jcr:content/metadata

    Verifique esses campos especificamente:

    • dam:scene7FileStatus
    • dam:scene7File
    • dam:scene7ID
    • dam:scene7Domain
    • dam:scene7CloudConfigPath
    • dam:scene7APIServer
    • dam:scene7Type

    Um ativo íntegro normalmente deve ter:

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File preenchido
    • dam:scene7ID preenchido

  2. Comparar com um ativo em funcionamento Se possível, compare o ativo com falha com outra imagem no mesmo ambiente que visualiza corretamente. Na maioria dos casos, uma ou mais propriedades dam:scene7* necessárias estarão ausentes no ativo que apresenta falha, ou dam:scene7FileStatus será definido como um valor não íntegro, como:

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. Recarregar ou reprocessar o ativo afetado Recarregar ou reprocessar o ativo força o AEM/Dynamic Media a regenerar os metadados de vinculação ausentes do Scene7. No caso validado, o recarregamento alterou o ativo de:

    • dam:scene7FileStatus = NeedsReupload
    • dam:scene7File ausente
    • dam:scene7ID ausente

    para um estado íntegro com:

    • dam:scene7FileStatus = PublishComplete
    • Preenchido dam:scene7File
    • Preenchido dam:scene7ID

  4. Se o ativo tiver sido introduzido por cópia de conteúdo, instalação de pacote ou migração, reprocesse os ativos afetados no ambiente de destino O Assets copiado de outro ambiente pode reter metadados do Dynamic Media obsoletos ou incompletos ou ignorar a assimilação normal do Dynamic Media no ambiente de destino. Recarregar ou reprocessar no ambiente de destino regenera os metadados dam:scene7* locais corretos.

  5. Validar recuperação de visualização Após recarregar ou reprocessar:

    • Confirme se a visualização do ativo funciona em Detalhes do ativo.
    • Confirmar se o ativo não emite mais uma solicitação de visualização com falha para:
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • Confirme se o ativo agora resolve usando um identificador Scene7 válido em dam:scene7File.

  6. Para impacto em massa, identifique ativos semelhantes por status. Se vários ativos forem afetados, consulte ativos com valores dam:scene7FileStatus não íntegros e reprocesse esse esse subconjunto, em vez da árvore do DAM inteira.

Causa

O problema é causado pelo ativo afetado que está em um estado de sincronização incompleto ou obsoleto do Dynamic Media. Nesta condição, o ativo existe no AEM, mas faltam os metadados de vinculação válidos do Scene7 necessários para a resolução de visualização dos Detalhes do ativo, como dam:scene7File, dam:scene7ID ou um dam:scene7FileStatus íntegro.

Como resultado, os Detalhes do ativo tentam carregar a visualização do Dynamic Media usando um caminho de repositório em /content/dam/..., em vez de um identificador de ativo do Scene7 válido, e a solicitação de visualização falha, fazendo com que a área de visualização fique em branco.

Esse estado geralmente é introduzido quando:

  • A sincronização/upload do Dynamic Media não foi concluída corretamente.
  • O ativo foi copiado ou migrado de outro ambiente.
  • Os metadados dam:scene7* obsoletos foram transferidos de outro ambiente.
  • O ativo não foi totalmente reprocessado no ambiente de destino após a migração ou a cópia do conteúdo.
recommendation-more-help
experience-cloud-kcs-help-kbarticles