Show Menu
ARGOMENTI×

Troubleshoot Adobe Experience Manager desktop app

L'app desktop Adobe Experience Manager (AEM) si connette a un archivio DAM (Digital Asset Management) remoto Experience Manager distribuzione del . L'app raccoglie informazioni sull'archivio e risultati di ricerca sul computer, scarica e carica file e cartelle, e include funzionalità per gestire i conflitti con 'interfaccia utente AEM Assets.
Continua a leggere per risolvere i problemi dell'app, conoscere le procedure ottimali e individuare i limiti.

Best practices

Seguite le procedure ottimali riportate di seguito per evitare problemi comuni e risolvere eventuali problemi.
  • Scoprite come funziona l'app desktop: Prima di iniziare a utilizzare l'applicazione, trascorrete alcuni minuti a sapere come funziona l'app. Informazioni sui collegamenti tra l'interfaccia Web Experience Manager e il desktop, la mappatura dell'archivio, il caching delle risorse, il salvataggio locale e il caricamento in background. Vedete come funziona .
  • Evitate i caratteri non supportati nei nomi delle cartelle: Non utilizzate spazi bianchi e caratteri non validi durante la creazione o il caricamento di cartelle. Consultate un elenco di caratteri in Creazione di cartelle in risorse Experience Manager. Alcuni casi di utilizzo di Adobe Experience Manager possono essere influenzati da caratteri non supportati nel nome della cartella.
  • Procedure ottimali per evitare conflitti : Per evitare potenziali conflitti durante la collaborazione su più risorse, consultate evitare conflitti di modifica.
  • Usate il caricamento delle cartelle per le cartelle gerarchiche di grandi dimensioni: Invece di usare l’interfaccia Web o altri metodi di Risorse, utilizzate ’app desktop Experience Manager per caricare cartelle di grandi dimensioni. L'app carica le risorse in background con registrazione e monitoraggio. Consultate Caricare in blocco le risorse .
  • Utilizzate la versione più recente: Utilizzate la versione più recente dell'app e verificate sempre la compatibilità prima di installare una nuova versione dell'app o prima di eseguire l'aggiornamento a una versione più recente di Adobe Experience Manager. See release notes .
  • Utilizzare la stessa lettera di unità: Utilizzare la stessa lettera di unità all'interno di un'organizzazione per eseguire la mappatura su Adobe Experience Manager DAM. Per visualizzare le risorse inserite da altri utenti, i percorsi devono essere identici. L'utilizzo della stessa lettera di unità assicura un percorso costante alle risorse DAM. Le risorse rimangono posizionate e non vengono rimosse anche se diversi utenti utilizzano lettere di unità.
  • Tenere presente la rete : Le prestazioni di rete sono fondamentali per le prestazioni dell'app desktop di Experience Manager. Se devi affrontare una risposta rallentata a trasferimenti di file o operazioni in blocco, disattiva le funzionalità o le app che potrebbero causare un sacco di traffico di rete.
  • Casi di utilizzo non supportati per l’app desktop: non utilizzate l'app per la migrazione delle risorse (necessita di pianificazione e altri strumenti); per operazioni DAM complesse (come lo spostamento di grandi cartelle, caricamenti di grandi dimensioni, la ricerca di file tramite ricerche avanzate di metadati); e come client di sincronizzazione (i principi di progettazione e i pattern di utilizzo sono diversi dai client in-sync come Microsoft OneDrive o la sincronizzazione desktop Adobe Creative Cloud).
  • Timeout : Al momento, l'app desktop non dispone di un valore di timeout configurabile che disconnette la connessione tra server di Experience Manager e l'app desktop dopo un intervallo di tempo fisso. Quando caricate risorse di grandi dimensioni, se la connessione riceve il timeout dopo un po', l'app tenta nuovamente di caricare la risorsa alcune volte aumentando il timeout di caricamento. Non è consigliato modificare le impostazioni di timeout predefinite.

Come risolvere i problemi

Per risolvere i problemi relativi all'app desktop, tenete presenti le informazioni seguenti. Inoltre, se desideri ottenere assistenza, ti consente di comunicare meglio i problemi Assistenza clienti di Adobe.

Posizione dei file di registro

Experience Manager l'app desktop memorizza i file di registro nelle seguenti posizioni, a seconda del sistema operativo:
In Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
In Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
Quando caricate molte risorse, se alcuni file non vengono caricati, consultate backend.log file per identificare i caricamenti non riusciti.
Quando lavorate con Assistenza clienti di Adobe su una richiesta di assistenza o un ticket di assistenza, potete chiedere di condividere i file di registro per aiutare il team di assistenza clienti a comprendere il problema. Archivia l'intera Logs cartella e condividila con l'Assistenza clienti.

Modifica del livello di dettagli nei file di registro

Per modificare il livello di dettagli nei file di registro:
  1. Verificare che l'applicazione non sia in esecuzione.
  2. Nel sistema Windows:
    1. Aprite una finestra di comando.
    2. Avviate l'app Adobe Experience Manager desktop eseguendo il comando:
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe
    
    
    Sul sistema Mac:
    1. Aprite una finestra terminale.
    2. Avviate l'app Adobe Experience Manager desktop eseguendo il comando:
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    
    
I livelli di registro validi sono DEBUG, INFO, WARN o ERROR. La verbosità dei registri è maggiore in DEBUG e più bassa in ERRORE.

Abilita modalità di debug

Per risolvere i problemi, puoi abilitare la modalità di debug e ottenere ulteriori informazioni nei registri.
I livelli di registro validi sono DEBUG, INFO, WARN o ERROR. La verbosità dei registri è maggiore in DEBUG e più bassa in ERRORE.
Per utilizzare l'app in modalità di debug su Mac:
  1. Aprite una finestra del terminale o un prompt dei comandi.
  2. Avviate l'app Experience Manager desktop eseguendo il comando seguente:
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app .
Per abilitare la modalità di debug in Windows:
  1. Aprite una finestra di comando.
  2. Avviate l'app Experience Manager desktop eseguendo il comando seguente:
AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe .

Cancella cache

Effettuate le seguenti operazioni:
  1. Avviare l'applicazione e collegare l'istanza AEM.
  2. Aprite le preferenze dell'applicazione facendo clic sulle ellissi nell'angolo superiore destro e selezionando Preferences.
  3. Individuare la voce che visualizza il Current Cache Size. Fate clic sull'icona del cestino accanto a questo elemento.
Per cancellare manualmente la cache, procedere con i passaggi descritti di seguito.
Si tratta di un'operazione potenzialmente distruttiva. Se vi sono modifiche locali al file che non vengono caricate in Adobe Experience Manager, tali modifiche andranno perse procedendo.
La cache viene cancellata eliminando la directory della cache dell'applicazione, che si trova nelle preferenze dell'applicazione.
  1. Avviate l'applicazione.
  2. Aprite le preferenze dell'applicazione selezionando le ellissi nell'angolo superiore destro e selezionando Preferences.
  3. Notate il Cache Directory valore.
    In questa directory esistono sottodirectory denominate in base agli Adobe Experience Manager endpoint codificati. I nomi sono una versione codificata dell’ Adobe Experience Manager URL di destinazione. Ad esempio, se l'applicazione esegue il targeting, localhost:4502 il nome della directory sarà localhost_4502 .
Per cancellare la cache, elimina la directory Adobe Experience Manager Endpoint codificato desiderata. In alternativa, eliminando l'intera directory specificata nelle preferenze, la cache per tutte le istanze utilizzate dall'applicazione verrà cancellata.
La cancellazione della cache dell'app Adobe Experience Manager desktop è un'attività preliminare di risoluzione dei problemi che può risolvere diversi problemi. Cancella la cache dalle preferenze dell'app. Consultate Impostare le preferenze . Il percorso predefinito della cartella della cache è:

Conoscere la versione dell'app Adobe Experience Manager desktop

Per visualizzare il numero di versione:
  1. Avviate l'applicazione.
  2. Fare clic sulle ellissi nell'angolo superiore destro, passare il mouse Helpe fare clic About.
    Il numero di versione è elencato in questa schermata.

Impossibile visualizzare le risorse inserite

Se non riuscite a visualizzare le risorse inserite nei file di supporto da voi o da altri professionisti del settore creativo (ad esempio, file INDD), controllate quanto segue:
  • Connessione al server. Una connettività di rete debole può arrestare i download delle risorse.
  • Dimensione file. Il download e la visualizzazione delle risorse grandi richiedono più tempo.
  • Coerenza con le lettere dell'unità. Se le risorse sono state inserite da un collaboratore durante la mappatura del DAM AEM a una lettera di unità diversa, le risorse inserite non vengono visualizzate.
  • Autorizzazioni. Per verificare se disponete delle autorizzazioni necessarie per recuperare le risorse inserite, contattate l’amministratore AEM.

Le modifiche apportate ai file nell'interfaccia utente dell'app desktop non si riflettono Adobe Experience Manager immediatamente

Adobe Experience Manager l'app desktop lascia all'utente la facoltà di decidere quando completare tutte le modifiche apportate a un file. A seconda delle dimensioni e della complessità di un file, il trasferimento della nuova versione di un file a Adobe Experience Manager. La progettazione dell'applicazione richiede di ridurre al minimo il numero di volte che un file viene trasferito avanti e indietro, invece di indovinare quando le modifiche del file sono complete e vengono caricate automaticamente. L'utente avvia il trasferimento del file Adobe Experience Manager scegliendo di caricare le modifiche apportate al file.

Problemi durante l'aggiornamento su macOS

A volte possono verificarsi problemi durante l'aggiornamento AEM'app desktop su macOS. Ciò è causato dalla cartella di sistema precedente per AEM app desktop che impedisce il corretto caricamento delle nuove versioni AEM app desktop. Per risolvere questo problema, è possibile rimuovere manualmente le cartelle e i file seguenti.
Prima di eseguire i seguenti passaggi, trascinate l’ Adobe Experience Manager Desktop applicazione dalla cartella delle applicazioni macOS al cestino. Aprite quindi il terminale, eseguite il comando seguente e fornite la password quando richiesto.
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

Impossibile caricare i file

Se si utilizza l'app desktop con AEM 6.5.1 o versione successiva, aggiornare il connettore S3 o Azure alla versione 1.10.4 o successiva. Risolve il problema di errore di caricamento dei file relativo a OAK-8599 . Consultate le istruzioni di installazione.

Experience Manager problemi di connessione all'app desktop

Se si verificano problemi generali di connettività, ecco alcuni modi per ottenere ulteriori informazioni sulle operazioni dell'app Experience Manager desktop.
Controllare il registro delle richieste
Experience Manager l'app desktop registra tutte le richieste inviate, insieme al codice di risposta di ogni richiesta, in un file di registro dedicato.
  1. Aprite request.log nella directory di registro dell’applicazione per visualizzare tali richieste.
  2. Ogni riga del registro rappresenta una richiesta o una risposta. Le richieste avranno un > carattere seguito dall'URL richiesto. Le risposte avranno un < carattere seguito dal codice di risposta e dall’URL richiesto. Richieste e risposte possono essere soddisfatte utilizzando il GUID di ogni riga.
Controllare le richieste caricate dal browser incorporato dell'applicazione
La maggior parte delle richieste dell'applicazione si trova nel registro delle richieste. Tuttavia, se non sono disponibili informazioni utili, può essere utile esaminare le richieste inviate dal browser incorporato dell'applicazione. Per istruzioni su come visualizzare tali richieste, consultate la sezione Autenticazione di accesso SAML non funzionante SAML.

Autenticazione di accesso SAML non funzionante

Se l'app Experience Manager desktop non si connette all' Adobe Experience Manager istanza di SSO abilitata (SAML), consulta questa sezione per la risoluzione dei problemi. I processi SSO sono diversi, a volte complessi e il design dell'applicazione fa del suo meglio per adattarsi a questi tipi di connessioni. Tuttavia, alcune impostazioni richiedono una risoluzione di problemi aggiuntiva.
A volte il processo SAML non effettua il reindirizzamento al percorso originariamente richiesto, oppure il reindirizzamento finale è a un host che è diverso da quello configurato nell'app Adobe Experience Manager desktop. Per verificare che non sia così:
  1. Aprite un browser Web.
  2. Immettete l’URL <AEM host>/content/dam.json nella barra degli indirizzi.
    Sostituire <AEM host> con l' Adobe Experience Manager istanza target, ad esempio http://localhost:4502/content/dam.json .
  3. Effettuate l'accesso all' Adobe Experience Manager istanza.
  4. Al termine dell'accesso, controllate l'indirizzo corrente del browser nella barra degli indirizzi. Deve corrispondere esattamente all’URL immesso inizialmente.
  5. Verificate inoltre che tutti gli elementi precedenti /content/dam.json corrispondano al valore di destinazione Adobe Experience Manager configurato nelle impostazioni dell'app Adobe Experience Manager desktop.
Il processo SAML di accesso funziona correttamente in base ai passaggi precedenti, ma gli utenti non sono ancora in grado di accedere
La finestra all'interno dell'app Adobe Experience Manager desktop che visualizza il processo di accesso è semplicemente un browser Web che visualizza l'interfaccia utente Web dell' Adobe Experience Manager istanza di destinazione:
  • La versione Mac utilizza WebView .
  • La versione Windows utilizza Chromio-based CefSharp .
Verificate che il processo SAML supporti tali browser.
Per risolvere ulteriormente i problemi, è possibile visualizzare gli URL esatti che il browser sta tentando di caricare. Per visualizzare queste informazioni:
  1. Seguite le istruzioni per avviare l'applicazione in modalità Abilita modalità di debug debug.
  2. Riproduci il tentativo di accesso.
  3. Passa alla directory di registro dell'applicazione
  4. Per Windows:
    1. Aprite "aemcompanionlog.txt".
    2. Cerca i messaggi che iniziano con "Indirizzo browser di accesso cambiato in". Queste voci contengono anche l’URL caricato dall’applicazione.
    Per Mac:
    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log , dove n viene sostituito da qualsiasi numero presente nel nome file più recente.
    2. Cerca i messaggi che iniziano con "frame caricato". Queste voci contengono anche l’URL caricato dall’applicazione.
Osservare la sequenza URL caricata può facilitare la risoluzione dei problemi alla fine di SAML per determinare cosa è sbagliato.

Problema di configurazione SSL

Le librerie che AEM'app desktop utilizza per la comunicazione HTTP utilizzano l'applicazione SSL rigorosa. A volte, una connessione può avere esito positivo utilizzando un browser ma non può essere utilizzata AEM'app desktop. Per configurare SSL in modo appropriato, installate il certificato intermedio mancante in Apache. Vedere Come installare un certificato CA intermedio in Apache .
Le librerie che AEM Desktop utilizza per la comunicazione HTTP utilizzano l’applicazione SSL rigorosa. In alcuni casi, le connessioni SSL riuscite tramite un browser non funzionano con l'app Adobe Experience Manager desktop. Ciò è positivo perché incoraggia la corretta configurazione di SSL e aumenta la sicurezza, ma può risultare frustrante quando l'applicazione non è in grado di connettersi.
In questo caso, si consiglia di utilizzare uno strumento per analizzare il certificato SSL di un server e identificare i problemi che possono essere corretti. Esistono siti Web che ispezionano il certificato di un server quando ne fornisce l'URL.
Come misura temporanea, è possibile disabilitare l'applicazione SSL rigorosa nell'app Adobe Experience Manager desktop. Non si tratta di una soluzione a lungo termine consigliata, in quanto riduce la protezione nascondendo la causa principale di SSL configurato in modo errato. Per disabilitare l'applicazione rigorosa:
  1. Utilizzate l'editor di vostra scelta per modificare il file di configurazione JavaScript dell'applicazione, che si trova (per impostazione predefinita) nelle seguenti posizioni (a seconda del sistema operativo):
    In Mac: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json
    In Windows: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json
  2. Individuare la sezione seguente nel file:
    ...
    "assetRepository": {
        "options": {
    ...
    
    
  3. Modificate la sezione aggiungendo "strictSSL": false quanto segue:
    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
    
  4. Salvate il file e riavviate l'app Adobe Experience Manager desktop.

L'app non risponde

Raramente l'applicazione potrebbe non rispondere, visualizzare solo uno schermo bianco, o visualizzare un errore nella parte inferiore dell'interfaccia senza alcuna opzione sull'interfaccia. Effettuate le seguenti operazioni nell'ordine:
  • Fare clic con il pulsante destro del mouse sull'interfaccia dell'applicazione e scegliere Refresh .
  • Uscite dall’applicazione e apritela di nuovo.
In entrambi i metodi, l'app inizia dalla cartella DAM principale.

Serve ulteriore aiuto per l'app Experience Manager desktop

Crea biglietto Jira con le seguenti informazioni:
  • Utilizzate DAM - Companion App come Component.
  • Procedura dettagliata per riprodurre il problema in Description.
  • Registri di livello DEBUG acquisiti durante la riproduzione del problema.
  • Versione di destinazione AEM.
  • Versione del sistema operativo.
  • Adobe Experience Manager versione dell'app desktop. Per conoscere la versione dell'app, consultate Individuazione della versione dell'app desktop.