[AEM Assets]{class="badge positive" title="Si applica ad AEM Assets)."}

Risoluzione dei problemi di Dynamic Media troubleshooting-dynamic-media-scene-mode

In questo argomento vengono fornite indicazioni per la risoluzione dei problemi relativi a Dynamic Media, in cui vengono descritti i problemi comuni, le relative cause probabili e gli approcci generali per la loro risoluzione. Dynamic Media è una funzionalità utilizzata per creare, gestire e distribuire risorse rich media, come immagini, video ed esperienze interattive, su larga scala, adattando i contenuti a dispositivi, dimensioni dello schermo e condizioni di visualizzazione diversi. Poiché si estende all’elaborazione, alla distribuzione e al rendering delle risorse in molti ambienti, la risoluzione dei problemi in genere richiede di isolare se si verifica un problema durante l’inserimento, l’attivazione o la distribuzione delle risorse.

Categorie di problemi comuni di Dynamic Media

La maggior parte dei problemi di Dynamic Media si suddivide in un numero limitato di categorie riconoscibili. L’identificazione della categoria consente di restringere l’indagine e di velocizzare la risoluzione:

  • Errori di caricamento ed elaborazione delle risorse — risorse che non vengono importate, che non generano rappresentazioni o che rimangono bloccate in uno stato di elaborazione.
  • Problemi di attivazione e pubblicazione — risorse elaborate correttamente ma non disponibili a livello di consegna.
  • Problemi di consegna e rendering: immagini o video che non vengono caricati, visualizzati in modo errato o forniti con dimensioni o qualità errate.
  • Problemi relativi al visualizzatore e all’incorporamento: visualizzatori interattivi, lettori video o esperienze incorporate che non si inizializzano o non si comportano come previsto.
  • Problemi di configurazione e connettività: impostazioni di servizio, credenziali o condizioni di rete non corrette che interrompono la comunicazione tra l’ambiente di authoring e il servizio di consegna.

Approccio generale per la risoluzione dei problemi

Un approccio strutturato risolve la maggior parte dei problemi di Dynamic Media in modo più affidabile rispetto a tentativi ed errori. Segui i passaggi seguenti in ordine:

  1. Conferma l’elaborazione corretta della risorsa. Verifica che la risorsa di origine sia stata caricata completamente e che siano state generate le rappresentazioni previste, poiché gli errori di consegna e rendering spesso vengono attribuiti a un’elaborazione incompleta.
  2. Verifica stato attivazione. Assicurati che la risorsa sia pubblicata o attivata nel servizio di consegna, poiché le risorse che appaiono corrette nell’authoring potrebbero non essere ancora disponibili per gli utenti finali se l’attivazione non è stata completata.
  3. Controllare gli URL di consegna e i parametri di rendering. Verifica che gli URL di consegna siano corretti e che qualsiasi dimensione, formato o parametro di qualità corrisponda all’output previsto.
  4. Isolare l’ambiente. Determina se il problema si verifica nell’authoring, nel servizio di consegna o nel browser client, in quanto questo indica dove viene introdotto l’errore.
  5. Verifica la configurazione e la connettività. Convalida le impostazioni del servizio, le credenziali e la connettività di rete tra l’ambiente di authoring e il servizio di consegna Dynamic Media.

Dove si verificano in genere problemi

Comprendere i tipici punti di errore consente di eseguire il targeting dell’indagine:

  • Durante l’acquisizione, i formati di file non supportati, i file di origine danneggiati o i caricamenti interrotti in genere impediscono la corretta elaborazione.
  • Durante l’attivazione, la pubblicazione incompleta o ritardata causa la mancanza di risorse dal livello di consegna anche quando esistono nell’ambiente di authoring.
  • Durante la consegna, il caching, gli URL errati o parametri non configurati correttamente comportano un caricamento lento delle risorse, errato o non corretto.

Confermando ogni fase della sequenza (elaborazione, attivazione e consegna) puoi isolare in modo efficiente la causa principale di un problema Dynamic Media e applicare la risoluzione appropriata.

Nuova configurazione di Dynamic Media new-dm-config

Una nuova configurazione di Dynamic Media (DM) collega Adobe Experience Manager Assets a Dynamic Media in modo che immagini, video e altri rich media possano essere elaborati, ottimizzati e distribuiti su larga scala. Dynamic Media consente la generazione dinamica di rappresentazioni, la distribuzione reattiva delle immagini, i visualizzatori interattivi e lo streaming video da una singola risorsa principale, riducendo la necessità di archiviare e gestire più varianti pre-renderizzate.

Finalità e ambito della risoluzione dei problemi

L’impostazione di una nuova configurazione di Dynamic Media stabilisce il collegamento tra l’ambiente AEM Assets e il servizio Dynamic Media, in modo che le risorse caricate in AEM vengano sincronizzate, elaborate e rese disponibili per una distribuzione ottimizzata. È necessaria una configurazione completata correttamente prima che le funzioni delle funzioni di Dynamic Media, come Smart Imaging, rappresentazioni dinamiche e incorporamenti di visualizzatori, funzionino come previsto.

I problemi di configurazione in genere si verificano quando le risorse non vengono sincronizzate, le rappresentazioni non vengono generate o gli URL di consegna non vengono risolti. Poiché questi problemi derivano in genere da impostazioni di configurazione incomplete o non applicate correttamente, la verifica della configurazione è il primo passaggio consigliato per la diagnosi.

Per istruzioni dettagliate sulla diagnosi e la risoluzione di questi problemi, consulta Risoluzione dei problemi relativi a una nuova configurazione di Dynamic Media.

Generale (tutte le Assets) general-all-assets

Le seguenti best practice si applicano a tutti i tipi di risorse. L’applicazione di queste linee guida migliora in modo coerente l’organizzazione, la reperibilità e la manutenzione a lungo termine, indipendentemente dal tipo specifico di risorsa con cui stai lavorando.

Denominazione e organizzazione

La denominazione e la struttura coerenti costituiscono la base delle risorse gestibili. Le procedure principali includono:

  • Utilizzare nomi chiari e descrittivi. Denomina ogni risorsa in base allo scopo o al contenuto, anziché utilizzando etichette generiche. In questo modo le risorse rimangono identificabili a colpo d’occhio e ricercabili in un secondo momento, anche durante la crescita di un progetto.
  • Adottare una convenzione di denominazione coerente. L’applicazione dello stesso involucro, degli stessi separatori e dei prefissi a tutte le risorse riduce la confusione e rende più affidabili l’elaborazione e l’ordinamento automatizzati.
  • Raggruppa le risorse correlate. L’organizzazione delle risorse in cartelle o categorie logiche consente la navigazione di raccolte di grandi dimensioni e ai membri del gruppo di individuare rapidamente ciò di cui hanno bisogno.

Riutilizzo ed efficienza

Il riutilizzo delle risorse esistenti è più efficiente che ricrearle e consente di mantenere la coerenza visiva e funzionale. Gli approcci consigliati includono:

  • Controllare le risorse esistenti prima di crearne di nuove. In questo modo si evita la duplicazione, si risparmia tempo e si evita l’accumulo di file ridondanti.
  • Favorire le risorse condivise o riutilizzabili in cui lo stesso elemento viene visualizzato in più posizioni. La centralizzazione di un’unica origine fa sì che gli aggiornamenti si propaghino ovunque venga utilizzata la risorsa, anziché richiedere modifiche in molte posizioni.

Manutenzione e qualità

Le risorse ben gestite rimangono utilizzabili nel tempo e riducono il debito tecnico. I passaggi pratici includono:

  • Rimuovere periodicamente le risorse inutilizzate. La cancellazione delle risorse non più referenziate rende la raccolta più snella e facile da gestire.
  • Mantieni le risorse ottimizzate. L’utilizzo di risorse formattate e di dimensioni appropriate migliora le prestazioni e riduce i sovraccarichi superflui.
  • Dettagli importanti documento. La registrazione dello scopo, dell’origine o di eventuali note sull’utilizzo di una risorsa consente ai membri del team attuali e futuri di capire come e dove deve essere utilizzata ciascuna risorsa.

Seguendo queste pratiche generali, viene stabilita una linea di base affidabile che viene riportata a ogni tipo di risorsa specifico, facilitando la creazione, l’aggiornamento e la manutenzione di singole risorse.

Proprietà dello stato di sincronizzazione delle risorse asset-synchronization-status-properties

Quattro proprietà di risorsa confermano la corretta sincronizzazione di una risorsa da Adobe Experience Manager (AEM) a Dynamic Media: dam:scene7ID, dam:scene7FileStatus, dam:scene7File e dam:lastSyncStatus. Esamina queste proprietà direttamente in CRXDE Lite, l’ambiente di sviluppo basato su browser utilizzato per esaminare la struttura dei nodi dell’archivio dei contenuti AEM (JCR). Ogni proprietà fornisce un segnale specifico sullo stato del collegamento della risorsa a Dynamic Media.

Verificare la sincronizzazione in CRXDE Lite

Per confermare la corretta sincronizzazione della risorsa da Adobe Experience Manager a Dynamic Media, in CRXDE Lite vengono esaminate le seguenti proprietà della risorsa:

Proprietà
Esempio
Descrizione
<object_node>/jcr:content/metadata/dam:scene7ID
a|364266
Indicatore generale del collegamento del nodo a Dynamic Media. La presenza di questo valore conferma che AEM ha stabilito un’associazione tra il nodo della risorsa e la sua controparte Dynamic Media (Scene7).
<object_node>/jcr:content/metadata/dam:scene7FileStatus
PublishComplete o testo di errore
Stato del caricamento della risorsa in Dynamic Media. Il valore PublishComplete indica che il caricamento è stato completato correttamente. Il testo di errore in questo campo segnala che il caricamento non è stato completato.
<object_node>/jcr:content/metadata/dam:scene7File
myCompany/myAssetID
Deve essere compilata per generare gli URL della risorsa remota in Dynamic Media. Poiché gli URL di consegna sono costruiti da questo valore, una proprietà dam:scene7File vuota indica che non è possibile generare alcun URL Dynamic Media per la risorsa.
<object_node>/jcr:content/dam:lastSyncStatus
operazione riuscita o non riuscita:<error text>
Stato di sincronizzazione di set (set 360 gradi, set di immagini e così via), predefiniti immagine, predefiniti visualizzatore, aggiornamenti mappa immagine per una risorsa o immagini modificate. Il valore success conferma che l’ultima operazione di sincronizzazione è stata completata, mentre failed:<error text> identifica l’errore specifico che ha impedito la sincronizzazione.

Perché queste proprietà contano

Ogni proprietà funge da punto di controllo distinto nella pipeline di consegna delle risorse; la revisione congiunta di tutte e quattro fornisce quindi un quadro completo dello stato di sincronizzazione di una risorsa. Le proprietà dam:scene7ID e dam:scene7File confermano che il collegamento e il riferimento al file esistono, dam:scene7FileStatus conferma il caricamento stesso e dam:lastSyncStatus conferma che gli artefatti dipendenti, come i set 360 gradi, i set di immagini, i predefiniti immagine, i predefiniti visualizzatore e gli aggiornamenti mappa immagine, sono sincronizzati correttamente. Quando una risorsa non viene consegnata come previsto in Dynamic Media, l’ispezione di queste proprietà in CRXDE Lite è il modo diretto per isolare quale fase del processo (collegamento, caricamento o impostazione della sincronizzazione) non è stata completata.

Registrazione sincronizzazione synchronization-logging

Errori e problemi di sincronizzazione registrati nel file error.log, che si trova nella directory del server Experience Manager /crx-quickstart/logs/. Questo registro è il punto di riferimento principale per la diagnosi dei problemi relativi alla sincronizzazione delle risorse.

Il livello di registrazione predefinito fornisce dettagli sufficienti per determinare la causa principale della maggior parte dei problemi di sincronizzazione. Per un’analisi più approfondita dei problemi più difficili da riprodurre, gli amministratori possono aumentare la gravità della registrazione a DEBUG sul pacchetto com.adobe.cq.dam.ips. La registrazione a livello DEBUG genera eventi diagnostici più granulari, acquisendo ulteriore contesto intorno al processo di sincronizzazione che non è scritto al livello predefinito.

Per aumentare la registrazione sincronizzazione per DEBUG:

  1. Apri la console Sling in https://localhost:4502/system/console/slinglog.
  2. Individuare o aggiungere una configurazione del logger per il pacchetto com.adobe.cq.dam.ips.
  3. Imposta il livello di registro su DEBUG.
  4. Riprodurre il problema di sincronizzazione, quindi esaminare i dettagli aggiuntivi scritti in error.log in /crx-quickstart/logs/.

Aumentando in questo modo il livello di registro si raccolgono ulteriori informazioni sul flusso di lavoro di sincronizzazione, facilitando l’isolamento della causa sottostante quando la registrazione predefinita non fornisce dettagli sufficienti.

Controllo della versione version-control

Quando si sostituisce una risorsa Dynamic Media esistente che condivide lo stesso nome e la stessa posizione, Adobe Experience Manager offre due opzioni di gestione distinte: mantieni entrambe le risorse o sostituisci la risorsa esistente. Il controllo della versione determina quale di questi comportamenti si applica al caricamento.

  • Mantenimento di entrambe le risorse: Il file appena caricato viene archiviato con un nome univoco in modo che l’URL della risorsa pubblicata rimanga distinto. Ad esempio, image.jpg è la risorsa originale e image1.jpg è la risorsa appena caricata. Poiché ogni file conserva il proprio nome, entrambe le risorse rimangono indirizzabili e consegnabili in modo indipendente, impedendo al nuovo caricamento di sovrascrivere l’originale.

  • Creazione di una versione: La creazione di una versione non è supportata in Dynamic Media. Di conseguenza, il nuovo caricamento non viene aggiunto a una cronologia delle versioni. Al contrario, la nuova risorsa sostituisce la risorsa esistente nella consegna, il che significa che il file pubblicato in precedenza viene sostituito e che il contenuto aggiornato viene distribuito al suo posto. Poiché non viene conservata alcuna versione precedente per la consegna, la sostituzione è effettivamente permanente per la risorsa consegnata.

Immagini e set images-and-sets

Per risolvere i problemi più comuni relativi alle immagini e ai set, attenersi alle indicazioni riportate di seguito. Gli errori relativi a immagini e impostazioni in genere derivano da formati non supportati, caricamenti incompleti, nomi non corretti, conflitti nella cache o mancata corrispondenza nella configurazione. Identificare prima la categoria del problema è il percorso più affidabile per una correzione rapida, perché la maggior parte degli errori relativi a immagini e set rientrano in un numero limitato di pattern ricorrenti.

Problemi comuni relativi a immagini e set

I problemi più frequenti con immagini e set includono:

  • Immagini non visualizzate. Un’immagine interrotta, vuota o mancante indica spesso un percorso di file non valido, un formato di file non supportato o un caricamento non riuscito.
  • Immagini non corrette o obsolete: quando dopo un aggiornamento viene visualizzata una versione precedente, la causa viene in genere rappresentata dal contenuto memorizzato nella cache che non è stato aggiornato.
  • Impossibile caricare completamente i set. Un set parziale o incompleto è in genere dovuto a elementi membri mancanti, a un riferimento interrotto o a una sincronizzazione interrotta.
  • Problemi di formattazione o risoluzione — le immagini distorte, estese o di bassa qualità in genere puntano a impostazioni di dimensioni, proporzioni o risoluzione non corrispondenti ai requisiti.
  • Errori di autorizzazione o di accesso — un’immagine o un set non caricato può essere limitato da autorizzazioni di accesso o da un collegamento scaduto.

Risoluzione dei problemi passo passo

Segui i passaggi seguenti in ordine, perché ogni passaggio esclude una causa comune prima di passare a una soluzione più complessa:

  1. Verificare il formato e la dimensione del file. Conferma che l’immagine utilizzi un formato supportato e rientri nei limiti di dimensione accettati. In questo modo il sistema può eseguire il rendering del file senza errori di conversione.
  2. Conferma il caricamento completato. Ricarica le immagini che sembrano mancanti o danneggiate, perché i caricamenti interrotti sono la causa principale delle immagini interrotte.
  3. Cancellare la cache e aggiornare. Se si cancella la cache del browser o dell’applicazione, viene forzato il caricamento della versione più recente e vengono risolti i casi in cui viene visualizzata un’immagine obsoleta.
  4. Controllare il percorso e i riferimenti del file. Assicurati che ogni immagine e imposta i punti di riferimento su una posizione valida, perché un percorso interrotto impedisce il caricamento dell’immagine.
  5. Rivedere le autorizzazioni e le impostazioni di accesso. Verifica che l’immagine o il set sia accessibile e che tutti i collegamenti condivisi non siano scaduti.
  6. Verifica in un ambiente alternativo. Carica l’immagine o il set in un browser, un dispositivo o una sessione diversi per determinare se il problema è locale anziché sistemico.

Prevenzione degli errori di immagine e impostazione

Per ridurre i problemi ricorrenti, applica le seguenti pratiche preventive:

  • Utilizza formati di file e convenzioni di denominazione coerenti e supportati in tutte le immagini e i set.
  • Conferma che ogni caricamento termina completamente prima di procedere, impedendo in tal modo la presenza di file parziali o danneggiati.
  • Mantieni i riferimenti immagine e imposta i membri sincronizzati in modo che nessun elemento membro sia mancante o orfano.
  • Aggiorna il contenuto nella cache dopo aver apportato aggiornamenti per garantire che la versione corrente sia sempre distribuita.
Problema
Come eseguire il debug
Soluzione
Impossibile accedere al pulsante Copia URL/Incorpora nella vista dei dettagli della risorsa
  1. Vai a CRX/DE:

    • Verifica se il predefinito nel JCR /etc/dam/presets/viewer/<preset> has lastReplicationAction è definito. Questa posizione si applica se hai effettuato l’aggiornamento da Experience Manager 6.x a 6.4 e hai rinunciato alla migrazione. In caso contrario, il percorso è /conf/global/settings/dam/dm/presets/viewer.
    • Verifica che la risorsa nel JCR contenga dam:scene7FileStatus in Metadati che sia visualizzato come PublishComplete.

Aggiorna pagina/passa a un'altra pagina e torna indietro (la barra laterale JSP deve essere ricompilata)

Se non funziona:

  • Pubblica risorsa.
  • Ricarica la risorsa e pubblicala.
L’hotspot carosello si sposta dopo il passaggio tra le diapositive
Verificare che tutte le diapositive abbiano le stesse dimensioni.
Per il carosello utilizzare solo immagini della stessa dimensione.
L’immagine non viene visualizzata in anteprima con il visualizzatore Dynamic Media
Verifica che la risorsa contenga dam:scene7File nelle proprietà dei metadati (CRXDE Lite)
Verifica che l'elaborazione di tutte le risorse sia stata completata.
La risorsa caricata non viene visualizzata nel selettore risorse
Verifica che la risorsa abbia la proprietà jcr:content > dam:assetState = processed (CRXDE Lite)
Verifica che l'elaborazione di tutte le risorse sia stata completata.
Il banner nella vista a schede mostra Nuovo quando la risorsa non ha iniziato l'elaborazione
Controlla risorsa jcr:content > dam:assetState = se unprocessed, non è stata selezionata dal flusso di lavoro.
Attendi che la risorsa venga selezionata dal flusso di lavoro.
Le immagini o i set non visualizzano l’URL del visualizzatore o il codice da incorporare
Controlla se il predefinito visualizzatore è stato pubblicato.
Vai a Strumenti > Assets > Predefiniti visualizzatore e pubblica il predefinito visualizzatore.

Se il problema persiste dopo aver completato questi passaggi di risoluzione dei problemi, inoltra il problema al supporto con i dettagli dell’immagine o del set interessato, i passaggi già tentati ed eventuali messaggi di errore osservati. Fornendo queste informazioni è possibile identificare la causa principale in modo più efficiente.

Video video

I problemi di riproduzione video sono tra i problemi tecnici più comuni e la maggior parte viene risolta con alcuni passaggi standard per la risoluzione dei problemi. Se il video non viene caricato, appare bloccato, viene riprodotto senza audio o viene visualizzata una schermata nera, utilizzare le indicazioni riportate di seguito per identificare e risolvere il problema.

Cause comuni dei problemi video

La maggior parte dei problemi video deriva da un piccolo insieme di cause prevedibili. Comprendere la causa consente di applicare la correzione corretta:

  • Connessione di rete insufficiente o instabile. Lo streaming video richiede una larghezza di banda coerente. Una connessione debole o fluttuante causa il buffering, lo stallo o il downgrade automatico della qualità.
  • Browser o applicazione obsoleti — I vecchi software potrebbero non supportare i formati video o gli standard di riproduzione correnti, causando errori o schermate vuote.
  • Cache o cookie danneggiati. I dati temporanei archiviati possono entrare in conflitto con il nuovo contenuto video e impedirne il caricamento corretto.
  • Estensioni del browser o blocchi di annunci — Alcune estensioni interferiscono con i lettori video bloccando gli script necessari per la riproduzione.
  • Driver grafici obsoleti o conflitti di accelerazione hardware: si tratta di frequenti origini di schermate nere, riproduzione irregolare o arresti anomali.
  • Incompatibilità audio o codec — Codec mancanti o non supportati possono causare la riproduzione del video senza audio o il mancato rendering.

Risoluzione dettagliata dei problemi video

Segui questi passaggi nell’ordine. Ogni passaggio affronta prima la causa più probabile, quindi il problema spesso viene risolto prima di raggiungere i passaggi successivi:

  1. Verifica la tua connessione Internet. Verificare che altri siti Web e servizi vengano caricati correttamente. Una connessione lenta o in caduta è la causa principale degli errori di buffering e riproduzione. Se possibile, passare a una connessione cablata o avvicinarsi al router wireless.
  2. Aggiorna la pagina e riavvia la riproduzione. Il ricaricamento elimina un errore di caricamento temporaneo e ristabilisce la connessione all’origine video.
  3. Aggiorna il browser o l’applicazione. L’esecuzione della versione più recente garantisce la compatibilità con i formati video e le funzioni di riproduzione correnti.
  4. Cancellare la cache e i cookie. La rimozione dei dati temporanei archiviati elimina i conflitti che impediscono il caricamento del video. Riavvia in seguito il browser.
  5. Disabilita estensioni e blocchi di annunci. Disattivarli temporaneamente per determinare se uno di essi sta bloccando il lettore video. Se il video funziona, riattiva le estensioni una alla volta per identificare la sorgente.
  6. Abbassa la qualità video. Se il video viene riprodotto ma si arresta ripetutamente, la selezione di una risoluzione inferiore riduce la larghezza di banda richiesta e produce una riproduzione più fluida.
  7. Aggiornare i driver di grafica o attivare/disattivare l’accelerazione hardware. I driver obsoleti causano glitch visivi e schermi neri. Se i problemi persistono, la disattivazione dell’accelerazione hardware nelle impostazioni del browser risolve spesso i problemi di rendering.
  8. Prova con un altro browser o dispositivo. Se il video viene riprodotto altrove, il problema è specifico del browser o del dispositivo originale e non della sorgente video stessa.

Quando richiedere ulteriore supporto

Se i problemi video continuano dopo aver completato ogni passaggio precedente, il problema potrebbe avere origine dalla sorgente video o da una configurazione di sistema più approfondita. In questo caso, annota i seguenti dettagli prima di contattare il supporto, perché velocizzano la diagnosi:

  • Messaggio di errore esatto o descrizione di ciò che appare sullo schermo
  • Il nome e la versione del browser o dell’applicazione
  • Sistema operativo e tipo di dispositivo
  • Se il problema si verifica con tutti i video o solo con quelli specifici
Problema
Come eseguire il debug
Soluzione
Impossibile visualizzare il video in anteprima
  • Verifica che alla cartella sia assegnato un profilo video (se il formato di file non è supportato). Se non è supportato, viene visualizzata solo un’immagine.
  • Il profilo video deve contenere più di un predefinito di codifica per generare un set AVS (le codifiche singole vengono trattate come contenuto video per i file MP4; per i file non supportati, trattate come non elaborate).
  • Verificare che l'elaborazione del video sia stata completata confermando dam:scene7FileAvs di dam:scene7File nei metadati.
  1. Assegna un profilo video alla cartella.
  2. Modifica il profilo video in modo da includere più predefiniti di codifica.
  3. Attendi che il video finisca l’elaborazione.
  4. Prima di ricaricare il video, accertati che il flusso di lavoro Codifica video elementi multimediali dinamici non sia in esecuzione.
  5. Ricarica il video.
Video non codificato
  • Verifica se Dynamic Media Cloud Service è configurato.
  • Verifica se un profilo video è associato alla cartella di caricamento.
  1. Verifica che la configurazione di Dynamic Media in Cloud Services sia impostata correttamente.
  2. Verifica che la cartella disponga di un profilo video. Inoltre, controlla il profilo video.
L'elaborazione video richiede troppo tempo

Per determinare se la codifica video è ancora in corso o se è entrata in uno stato di errore:

  • Controlla lo stato del video https://localhost:4502/crx/de/index.jsp#/content/dam/folder/videomp4/jcr%3Acontent > dam:assetState
Rappresentazione video mancante

Quando il video viene caricato, ma non sono presenti rappresentazioni codificate:

  • Verifica che alla cartella sia assegnato un profilo video.
  • Verificare che l'elaborazione del video sia stata completata confermando dam:scene7FileAvs nei metadati.
  1. Assegna un profilo video alla cartella.
  2. Attendere il completamento dell'elaborazione del video.

Queste informazioni consentono al supporto di riprodurre il problema e identificare se la causa è locale al dispositivo o influisce sul servizio video stesso.

Visualizzatori viewers

I visualizzatori possono rilevare problemi di riproduzione, caricamento, visualizzazione e compatibilità che impediscono il corretto rendering del contenuto. Le indicazioni per la risoluzione dei problemi riportate di seguito descrivono i problemi più comuni relativi ai visualizzatori e forniscono un percorso dettagliato per risolverli.

Problemi comuni dei visualizzatori

I problemi dei visualizzatori in genere rientrano in alcune categorie riconoscibili:

  • Impossibile caricare il contenuto. Il visualizzatore si apre ma visualizza una schermata vuota, un messaggio di rotazione o un messaggio di errore al posto del contenuto previsto.
  • Errori di riproduzione o rendering: il contenuto viene caricato parzialmente, bloccato o visualizzato in modo errato.
  • Problemi di compatibilità — il visualizzatore non funziona come previsto in un determinato browser, dispositivo o sistema operativo.
  • Problemi di prestazioni — caricamento lento, ritardo o mancata risposta durante l’uso.

La maggior parte dei problemi del visualizzatore deriva da un piccolo insieme di cause sottostanti, tra cui software obsoleto, conflitti nella cache del browser, script bloccati, connessioni di rete instabili o formati di file non supportati. Identificare la categoria applicabile è il primo passo verso una risoluzione rapida.

Passaggi per la risoluzione dei problemi

Segui questi passaggi in ordine, in quanto i passaggi precedenti risolvono i problemi più frequenti:

  1. Aggiorna e ricarica il visualizzatore. Un problema di caricamento temporaneo viene spesso cancellato ricaricando la pagina o riaprendo il visualizzatore.
  2. Cancellare la cache del browser e i cookie. I dati non aggiornati memorizzati nella cache sono una causa comune di schermate vuote e contenuti obsoleti; la cancellazione costringe quindi il visualizzatore a ricaricare le risorse.
  3. Aggiorna il browser o l’applicazione. L’esecuzione della versione più recente garantisce la compatibilità con i requisiti di rendering del visualizzatore.
  4. Prova con un altro browser o dispositivo. Questo isola se il problema è specifico di un ambiente o influisce sul contenuto stesso.
  5. Controllare la connessione di rete. Una connessione instabile o limitata impedisce al visualizzatore di recuperare il contenuto, pertanto la conferma di una connessione stabile risolve molti errori di caricamento.
  6. Disattiva estensioni o blocchi in conflitto. I bloccanti degli annunci, i bloccanti degli script e le estensioni della privacy possono interferire con le funzionalità dei visualizzatori; la loro temporanea disattivazione aiuta a confermare se siano la causa.

Se il problema persiste dopo aver completato questi passaggi, è possibile che il problema si verifichi nell’origine di contenuto o nella configurazione del visualizzatore, anziché nell’ambiente locale, ed è necessario un ulteriore supporto diagnostico.

Problema: i predefiniti del visualizzatore non sono pubblicati viewers-not-published

Sintomo: i predefiniti visualizzatore non sono stati pubblicati (attivati), impedendo così il corretto rendering dei visualizzatori Dynamic Media per le risorse consegnate. Per risolvere questo problema è necessario confermare lo stato di attivazione e pubblicare eventuali predefiniti non attivati.

Eseguire il debug: verificare lo stato di attivazione del predefinito visualizzatore

Per identificare il motivo per cui i predefiniti visualizzatore non sono pubblicati, effettua le seguenti operazioni:

  1. Passare alla pagina di diagnostica di Gestione esempi: https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html.

  2. Osserva i valori calcolati riportati dalla pagina di diagnostica. Quando il sistema funziona correttamente, la pagina di diagnostica riporta quanto segue: _DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets. In questo caso, lo stato DMSAMPLE fa riferimento alle risorse di esempio di Dynamic Media e lo stato OOTB fa riferimento alle risorse visualizzatore predefinite. Un conteggio di 0 risorse non sincronizzate e 0 risorse non attivate conferma che tutto è sincronizzato e attivato come previsto.

    note
    NOTE
    La sincronizzazione delle risorse del visualizzatore può richiedere circa 10 minuti dopo la configurazione delle impostazioni cloud di Dynamic Media. Se i conteggi non sono ancora zero, attendere il completamento della finestra di sincronizzazione prima di continuare la risoluzione dei problemi.
  3. Se le risorse non attivate rimangono, significa che uno o più predefiniti visualizzatore non sono mai stati pubblicati. Selezionare uno dei pulsanti Elenca tutti i pulsanti di Assets non attivati per visualizzare i dettagli delle risorse che richiedono ancora l’attivazione.

Soluzione: pubblicare i predefiniti visualizzatore

Poiché le risorse non attivate derivano da predefiniti che non sono stati pubblicati, la correzione consiste nel pubblicarli esplicitamente:

  1. Passare all’elenco dei predefiniti visualizzatore negli strumenti di amministrazione: https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html.
  2. Seleziona tutti i predefiniti visualizzatore, quindi seleziona Pubblica. La pubblicazione attiva i predefiniti in modo che le relative risorse associate vengano sincronizzate e rese disponibili per la distribuzione, cancellando così lo stato non attivato.
  3. Torna al manager di esempio e verifica che il conteggio delle risorse non attivate sia ora zero. Un conteggio pari a zero verifica che i predefiniti visualizzatore siano stati pubblicati correttamente e che il problema sia stato risolto.

Problema: la grafica del predefinito del visualizzatore restituisce 404 dall’anteprima nei dettagli della risorsa o copia URL/codice di incorporamento viewer-preset-404

Eseguire il debug: verifica dello stato di sincronizzazione e richiesta diretta del disegno

In CRXDE Lite (la console per sviluppatori per l’archivio Adobe Experience Manager), esegui i seguenti passaggi:

  1. Passa alla cartella <sync-folder>/_CSS/_OOTB all’interno della cartella di sincronizzazione di Dynamic Media (ad esempio, /content/dam/_CSS/_OOTB).

  2. Trovare il nodo metadati della risorsa problematica (ad esempio, <sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/).

  3. Verificare la presenza di dam:scene7* proprietà. Se la risorsa è stata sincronizzata e pubblicata correttamente, la proprietà dam:scene7FileStatus è impostata su PublishComplete, a conferma che la risorsa è stata sincronizzata e pubblicata correttamente. Se queste proprietà dam:scene7* sono assenti, la risorsa non ha mai completato il flusso di lavoro di sincronizzazione e pubblicazione, che è la causa sottostante della 404.

  4. Tentativo di richiedere il disegno direttamente da Dynamic Media concatenando i valori delle proprietà e delle stringhe letterali seguenti. Una richiesta diretta corretta conferma che il disegno esiste sul server Dynamic Media; una 404 conferma che non è mai stato pubblicato:

    • dam:scene7Domain
    • "is/content"
    • dam:scene7Folder
    • <asset-name>
      Esempio: https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png

Soluzione: riavvio del processo di copia e sincronizzazione

Se la richiesta diretta non riesce o mancano le proprietà dam:scene7*, il disegno delle risorse di esempio o del predefinito visualizzatore non è stato sincronizzato o pubblicato. Di conseguenza, riavviare l’intero processo di copia/sincronizzazione:

  1. Passa a CRXDE Lite.
  2. Elimina <sync-folder>/_CSS/_OOTB. In questo modo viene rimossa la cartella dei disegni non aggiornata e non sincronizzata, in modo che possa essere rigenerata correttamente.
  3. Passare a Gestione pacchetti di CRX (strumento di installazione del pacchetto dell’archivio): https://localhost:4502/crx/packmgr/.
  4. Cercare il pacchetto visualizzatore nell’elenco; inizia con cq-dam-scene7-viewers-content.
  5. Selezionare Reinstalla. La reinstallazione di questo pacchetto ripristina il contenuto predefinito del visualizzatore.
  6. In Cloud Services, passa alla pagina Configurazione di Dynamic Media, quindi apri la finestra di dialogo di configurazione per la configurazione di Dynamic Media - S7.
  7. Non apportare modifiche, quindi selezionare Salva.
    Questa azione di salvataggio riattiva la logica di configurazione, perché il nuovo salvataggio della configurazione Dynamic Media - S7 forza Experience Manager a ricreare e sincronizzare nuovamente le risorse di esempio, i CSS del predefinito visualizzatore e il disegno, risolvendo l’errore 404.

Problema: errore #2046 all’apertura della scheda Larghezza di banda e spazio di archiviazione error-2046-bandwidth-storage

Causa: certificato di firma scaduto in un RSL nella cache

Errore #2046 nella scheda Larghezza di banda e spazio di archiviazione in Dynamic Media Classic

L’errore #2046 viene visualizzato quando gli utenti aprono la scheda Larghezza di banda e spazio di archiviazione nell’applicazione desktop Dynamic Media Classic (Scene7), uno strumento di gestione delle risorse di Adobe utilizzato per ospitare, gestire e distribuire rich media. L’errore è causato da un certificato di firma digitale scaduto contenuto in una RSL (Runtime Shared Library) memorizzata nella cache utilizzata dal framework Adobe AIR (Adobe Integrated Runtime).

L’errore viene attivato durante la riconvalida del certificato locale: quando l’applicazione carica l’elenco di certificati attendibili nella cache, tenta di verificare il certificato di firma e, poiché tale certificato è scaduto, la convalida non riesce e viene generato il #2046 di errore. Poiché il problema risiede nella libreria memorizzata localmente anziché nell’applicazione stessa, la correzione consiste nel rimuovere i file memorizzati in cache obsoleti in modo da poter recuperare un RSL corrente con firma valida.

Soluzione: cancellare la cache locale di Adobe AIR

Cancellare la cache locale per forzare Adobe AIR a scaricare la RSL (Runtime Shared Library) aggiornata. Se si eliminano i file memorizzati nella cache non aggiornati, il certificato scaduto viene rimosso e al successivo avvio Adobe AIR scarica un RSL appena firmato che supera la riconvalida del certificato locale, risolvendo l’errore.

macOS

  1. Accedi a:
    ~/Library/Caches/Adobe/Flash Player/AssetCache/<folder>/
  2. Eliminare tutti i file .swz e .heu.

Windows

  1. Accedi a:
    %APPDATA%\Adobe\Flash Player\AssetCache\<folder>\
  2. Elimina tutti i file nella cartella.

Riavviare l’applicazione dopo aver cancellato la cache. Al riavvio, aprire di nuovo la scheda Larghezza di banda e spazio di archiviazione per confermare che l’errore non #2046 più visualizzato, il che indica che l’elenco di indirizzi attendibili aggiornato è stato scaricato e convalidato correttamente.

Problema: l’anteprima dell’immagine non viene caricata nella creazione dei predefiniti del visualizzatore image-preview-not-loading

Soluzione

Impossibile caricare l’anteprima immagine nei predefiniti visualizzatore durante la creazione di contenuto di esempio non aggiornato e gli artefatti del predefinito visualizzatore memorizzato nella cache impediscono il rendering dell’anteprima. Cancella questi artefatti e ricrea la configurazione di Dynamic Media per ripristinare l’anteprima.

  1. In Experience Manager, seleziona il logo Experience Manager per accedere alla console di navigazione globale, quindi passa a Strumenti > Generale > CRXDE Lite.

  2. Nella barra a sinistra, passa alla cartella del contenuto di esempio nel percorso seguente:

    /content/dam/_DMSAMPLE

  3. Eliminare la cartella _DMSAMPLE. Questo rimuove il contenuto di esempio obsoleto che può bloccare il corretto rendering dell’anteprima.

  4. Nella barra a sinistra, accedi alla cartella dei predefiniti nella posizione seguente:

    /conf/global/settings/dam/dm/presets/viewer

  5. Eliminare la cartella viewer. La rimozione di questa cartella cancella le impostazioni del predefinito visualizzatore memorizzato nella cache in modo che vengano rigenerate correttamente.

  6. Nell’angolo superiore sinistro della pagina CRXDE Lite, selezionare Salva tutto per eseguire il commit delle eliminazioni nell’archivio.

  7. Nell’angolo in alto a sinistra della pagina CRXDE Lite, seleziona l’icona Torna alla Home.

  8. Ricreare una configurazione Dynamic Media in Cloud Services. Questo passaggio rigenera il contenuto di esempio e i predefiniti visualizzatore rimossi, ripristinando la Anteprima immagine nella creazione dei predefiniti visualizzatore.

recommendation-more-help
experience-manager-cloud-service-help-main-toc