DocumentazioneAEMGuida dell’app desktop

Risoluzione dei problemi relativi all'app desktop Adobe Experience Manager troubleshoot-v2

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente
  • Amministratore

L'app desktop Adobe Experience Manager si connette all'archivio DAM (Digital Asset Management) di una distribuzione Experience Manager. L’app recupera sul computer le informazioni dell’archivio e i risultati della ricerca, scarica e carica file e cartelle e include funzionalità per gestire i conflitti con l’interfaccia utente di Assets.

Continua a leggere per risolvere i problemi dell’app, scoprire le best practice e le limitazioni.

Best practice best-practices-to-prevent-troubles

Per evitare alcuni problemi comuni e la relativa risoluzione, attieniti alle seguenti best practice.

  • Comprendere come funziona l'app desktop: prima di iniziare a utilizzare l'applicazione, prova a conoscere il funzionamento dell'app. Informazioni sui collegamenti tra l'interfaccia Web di Experience Manager e il desktop, sulla mappatura dell'archivio, sulla memorizzazione nella cache delle risorse, sul salvataggio locale e sul caricamento in background. Vedi come funziona.

  • Evitare caratteri non supportati nei nomi delle cartelle: non utilizzare spazi vuoti e caratteri non validi durante la creazione o il caricamento di cartelle. Visualizza un elenco di caratteri in Crea cartelle in Adobe Experience Manager Assets. I caratteri non supportati nel nome della cartella possono influire su alcuni casi d'uso di Experience Manager.

  • Best practice per evitare conflitti: per evitare potenziali conflitti durante la collaborazione su più risorse, vai a evitare conflitti di modifica.

  • Utilizza il caricamento delle cartelle per le cartelle gerarchiche di grandi dimensioni: anziché utilizzare l'interfaccia Web di Assets o altri metodi, utilizza l'app desktop Experience Manager per caricare cartelle di grandi dimensioni. L’app carica le risorse in background con la registrazione e il monitoraggio. Consulta risorse per caricamento in blocco.

  • Usa la versione più recente: usa la versione più recente dell'app. Verificare sempre la compatibilità prima di installare una nuova versione dell'app o prima di eseguire l'aggiornamento a una versione Experience Manager più recente. Consulta le note sulla versione.

  • Usa la stessa lettera di unità: utilizza la stessa lettera di unità in un'organizzazione per eseguire il mapping al DAM Experience Manager. Per visualizzare le risorse posizionate da altri utenti, i percorsi devono essere gli stessi. L’utilizzo della stessa lettera di unità garantisce un percorso costante per le risorse DAM. Le risorse rimangono posizionate e non vengono rimosse anche se utenti diversi utilizzano lettere di unità diverse.

  • Attenzione alla rete: le prestazioni della rete sono fondamentali per le prestazioni dell'app desktop Experience Manager. Se la risposta ai trasferimenti di file o alle operazioni in blocco risulta più lenta, disattivare le funzionalità o le app che potrebbero causare un notevole traffico di rete.

  • Casi d'uso non supportati per l'app desktop: evita di utilizzare l'app per la migrazione delle risorse, in quanto richiede strumenti di pianificazione e aggiuntivi. Non è inoltre adatto per operazioni DAM complesse, come lo spostamento di cartelle di grandi dimensioni, caricamenti di grandi dimensioni o ricerche avanzate di metadati. Inoltre, non utilizzarlo come client di sincronizzazione, in quanto i principi di progettazione e i modelli di utilizzo sono diversi da client di sincronizzazione come Microsoft OneDrive o Adobe Creative Cloud Desktop Sync.

  • Timeout: l'app desktop non dispone attualmente di un valore di timeout configurabile che disconnette la connessione tra il server Experience Manager e l'app desktop dopo un intervallo di tempo fisso. Quando si caricano risorse di grandi dimensioni, se dopo un po’ la connessione si interrompe, l’app ritenta di caricare la risorsa un paio di volte, aumentando il timeout di caricamento. Non esiste un metodo consigliato per modificare le impostazioni di timeout predefinite.

Come risolvere i problemi troubleshooting-prep

Per risolvere i problemi relativi all’app desktop, tieni presente le seguenti informazioni. Inoltre, ti prepara a segnalare meglio i problemi all’Assistenza clienti Adobe se scegli di richiedere assistenza.

Percorso dei file di registro check-log-files-v2

L'app desktop Experience Manager memorizza i file di registro nei percorsi seguenti, a seconda del sistema operativo:

In Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs

In Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

Quando si caricano molte risorse, se alcuni file non vengono caricati, vedere il file backend.log per identificare i caricamenti non riusciti.

NOTE
Quando lavori con l’Assistenza clienti Adobe per una richiesta di supporto o un ticket, ti può essere chiesto di condividere i file di registro per aiutare il team di Assistenza clienti a comprendere il problema. Archivia l'intera cartella Logs e condividila con il contatto dell'Assistenza clienti.

Cambia il livello di dettagli nei file di registro level-of-details-in-log

Per modificare il livello dei dettagli nei file di registro:

  1. Verificare che l'applicazione non sia in esecuzione.

  2. Sul sistema Windows:

    1. Aprire una finestra di comando.

    2. Avvia l'app desktop Adobe Experience Manager eseguendo il comando:

    code language-shell 
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe

    Sul sistema Mac:

    1. Apri una finestra del terminale.

    2. Avvia l'app desktop Adobe Experience Manager eseguendo il comando:

    code language-shell 
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

I livelli di registro validi sono DEBUG, INFO, WARN o ERROR. Il livello di dettaglio dei registri è il più alto in DEBUG e il più basso in ERROR.

Abilita modalità di debug enable-debug-mode

Per la risoluzione dei problemi, puoi abilitare la modalità di debug e ottenere ulteriori informazioni nei registri.

NOTE
I livelli di registro validi sono DEBUG, INFO, WARN o ERROR. Il livello di dettaglio dei registri è il più alto in DEBUG e il più basso in ERROR.

Per utilizzare l’app in modalità di debug su Mac:

  1. Aprire una finestra del terminale o un prompt dei comandi.

  2. Avvia l'app desktop Experience Manager eseguendo il comando seguente:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app.

Per attivare la modalità di debug in Windows:

  1. Aprire una finestra di comando.

  2. Avvia l'app desktop Experience Manager eseguendo il comando seguente:

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe.

Conoscere la versione dell'app desktop Adobe Experience Manager know-app-version-v2

Per visualizzare il numero di versione:

  1. Avvia l’applicazione.

  2. Fai clic sull'ellissi nell'angolo superiore destro, passa il puntatore su Help e fai clic su About.

    Il numero di versione è elencato in questa schermata.

Cancella cache clear-cache-v2

Effettua le seguenti operazioni:

  1. Avviare l'applicazione e connettersi a un'istanza di Experience Manager.

  2. Aprire le preferenze dell'applicazione facendo clic sui puntini di sospensione nell'angolo superiore destro e selezionando Preferences.

  3. Individuare la voce che visualizza Current Cache Size. Fai clic sull’icona del cestino accanto a questo elemento.

Per cancellare la cache manualmente, effettuare le seguenti operazioni:

CAUTION
Questi passaggi sono potenzialmente distruttivi. Se sono presenti modifiche al file locale non caricate in Adobe Experience Manager, tali modifiche andranno perse.

La cache viene cancellata eliminando la directory cache dell'applicazione, che si trova nelle preferenze dell'applicazione.

  1. Avvia l’applicazione.

  2. Aprire le preferenze dell'applicazione selezionando i puntini di sospensione nell'angolo superiore destro e selezionando Preferences.

  3. Nota il valore Cache Directory.

    In questa directory sono presenti sottodirectory denominate in base agli endpoint Adobe Experience Manager codificati. I nomi sono una versione codificata dell'URL Adobe Experience Manager di destinazione. Ad esempio, se l'applicazione è destinata a localhost:4502, il nome della directory è localhost_4502.

Per cancellare la cache, eliminare la directory dell'endpoint Adobe Experience Manager codificato desiderata. In alternativa, l'eliminazione dell'intera directory specificata nelle preferenze comporta la cancellazione della cache per tutte le istanze utilizzate dall'applicazione.

La cancellazione della cache dell'app desktop Adobe Experience Manager è un'attività preliminare di risoluzione dei problemi che può risolvere diversi problemi. Cancella la cache dalle preferenze dell’app. Vedi imposta preferenze. La posizione predefinita della cartella della cache è:

Impossibile visualizzare le risorse inserite placed-assets-missing

Se non riesci a visualizzare le risorse inserite da te o da altri professionisti creativi nei file di supporto (ad esempio, file INDD), verifica quanto segue:

  • Connessione al server. Una connettività di rete inadeguata può bloccare i download delle risorse.

  • Dimensione file. Il download e la visualizzazione delle risorse di grandi dimensioni richiedono più tempo.

  • Coerenza lettera unità. Se le risorse inserite durante la mappatura del DAM Experience Manager su una lettera di unità diversa sono state posizionate da te o da un altro collaboratore, le risorse inserite non vengono visualizzate.

  • Autorizzazioni. Per verificare se si dispone delle autorizzazioni per recuperare le risorse inserite, contattare l'amministratore Experience Manager.

Le modifiche apportate ai file nell'interfaccia utente dell'app desktop non vengono immediatamente applicate in Adobe Experience Manager changes-on-da-not-visible-on-aem

L'app desktop Adobe Experience Manager consente all'utente di decidere quando tutte le modifiche apportate a un file sono state completate. A seconda delle dimensioni e della complessità di un file, il trasferimento della nuova versione di un file in Adobe Experience Manager richiede molto tempo. L’applicazione è progettata per ridurre al minimo il numero di trasferimenti di file, anziché caricare automaticamente i file in base al completamento ipotizzato delle modifiche. È consigliabile che l'utente avvii nuovamente il trasferimento del file in Adobe Experience Manager scegliendo di caricare le modifiche di un file.

Problemi durante l’aggiornamento su macOS issues-when-upgrading-on-macos

Talvolta possono verificarsi problemi durante l'aggiornamento dell'app desktop Experience Manager su macOS. Problemi causati dalle cartelle di sistema legacy per l'app desktop Experience Manager. Le cartelle impediscono il caricamento corretto delle nuove versioni dell'app desktop Experience Manager. Per risolvere questo problema, è possibile rimuovere manualmente le cartelle e i file seguenti.

Prima di eseguire i passaggi seguenti, trascinare l'applicazione Adobe Experience Manager Desktop dalla cartella macOS Applications nel cestino. Quindi aprire il terminale, eseguire il comando seguente e fornire 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 upload-fails

Se utilizzi l'app desktop con Experience Manager 6.5.1 o versione successiva, aggiorna il connettore S3 o Azure alla versione 1.10.4 o successiva. Risolve il problema di errore di caricamento del file relativo a OAK-8599. Consulta le istruzioni di installazione.

Experience Manager problemi di connessione all'app desktop connection-issues

Se si verificano problemi generali di connettività, ecco alcuni modi per ottenere ulteriori informazioni sulle operazioni dell'app desktop Experience Manager.

Controllare il registro richieste

L'app desktop Experience Manager registra tutte le richieste inviate, insieme al codice di risposta di ogni richiesta, in un file di registro dedicato.

  1. Apri request.log nella directory del registro dell'applicazione per visualizzare queste richieste.

  2. Ogni riga del registro rappresenta una richiesta o una risposta. Le richieste hanno un carattere > seguito dall'URL richiesto. Le risposte hanno un carattere < seguito dal codice di risposta e dall'URL richiesto. Le richieste e le risposte possono essere associate utilizzando il GUID di ogni riga.

Controlla le richieste caricate dal browser incorporato dell'applicazione

La maggior parte delle richieste dell’applicazione si trova nel registro delle richieste. Tuttavia, se non ci sono informazioni utili, può essere utile esaminare le richieste inviate dal browser incorporato dell’applicazione.
Per istruzioni su come visualizzare queste richieste, consulta la sezione SAML.

L’autenticazione dell’accesso SAML non funziona da-connection-issue-with-saml-aem

L'app desktop Experience Manager potrebbe non connettersi alla distribuzione Adobe Experience Manager abilitata per SSO (SAML). La progettazione dell’applicazione tenta di adattarsi alle varianti e alle complessità delle connessioni e dei processi SSO. Tuttavia, una configurazione potrebbe richiedere una risoluzione dei problemi aggiuntiva.

A volte il processo SAML non reindirizza al percorso richiesto originariamente. In alternativa, il reindirizzamento finale è a un host diverso da quello configurato nell'app desktop Adobe Experience Manager. Per verificare che il problema non si verifichi, effettuare le seguenti operazioni:

  1. Aprire un browser Web. Accedi all'URL https://[aem_server]:[port]/content/dam.json.

  2. Accedere alla distribuzione Adobe Experience Manager.

  3. Al termine dell’accesso, controlla l’indirizzo corrente del browser nella barra degli indirizzi. Deve corrispondere esattamente all’URL immesso inizialmente.

  4. Verificare inoltre che tutto ciò che precede /content/dam.json corrisponda al valore Adobe Experience Manager di destinazione configurato nelle impostazioni dell'app desktop Adobe Experience Manager.

Il processo SAML di accesso funziona correttamente in base ai passaggi precedenti, ma gli utenti non sono ancora in grado di accedere

La finestra nell'app desktop Adobe Experience Manager che visualizza il processo di accesso è semplicemente un browser Web che visualizza l'interfaccia utente Web dell'istanza di Adobe Experience Manager di destinazione:

  • La versione di Mac utilizza un WebView.

  • La versione di Windows utilizza CefSharp basato su Chromium.

Assicurati che il processo SAML supporti tali browser.

Per risolvere ulteriori problemi, è possibile visualizzare gli URL esatti che il browser sta tentando di caricare. Per visualizzare queste informazioni:

  1. Seguire le istruzioni per avviare l'applicazione in modalità debug.

  2. Riproduci il tentativo di accesso.

  3. Passare alla directory del registro dell'applicazione.

  4. Per Windows:

    1. Aprire "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. In com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log, i numeri presenti nel nome di file più recente sostituiscono n.

    2. Cercare i messaggi che iniziano con il frame caricato. Queste voci contengono anche l’URL caricato dall’applicazione.

Osservando la sequenza URL in fase di caricamento è possibile risolvere eventuali problemi alla fine del SAML per determinare l’errore.

Problema di configurazione SSL ssl-config-v2

Le librerie utilizzate dall'app desktop Experience Manager per la comunicazione HTTP utilizzano una rigida applicazione SSL. A volte una connessione può riuscire utilizzando un browser, ma non riesce quando si utilizza l'app desktop Experience Manager. Per configurare SSL in modo appropriato, installa il certificato intermedio mancante in Apache. Vedi Come installare un certificato CA intermedio in Apache.

Le librerie utilizzate dall'app desktop Experience Manager per la comunicazione HTTP utilizzano una rigorosa applicazione SSL. Pertanto, possono verificarsi casi in cui le connessioni SSL riuscite tramite un browser non riescono con l'app desktop Adobe Experience Manager. Questo risultato è positivo perché incoraggia la corretta configurazione di SSL e aumenta la sicurezza, ma può essere frustrante quando l’applicazione non è in grado di connettersi.

In questo caso, l’approccio consigliato è quello di utilizzare uno strumento per analizzare il certificato SSL di un server e identificare i problemi in modo che possano essere corretti. Esistono siti Web che controllano il certificato di un server fornendo il relativo URL.

Come misura temporanea, è possibile disabilitare l'imposizione SSL rigorosa nell'app desktop Adobe Experience Manager. Questo approccio non è una soluzione consigliata a lungo termine, in quanto riduce la sicurezza nascondendo la causa principale di SSL configurato in modo errato. Per disattivare l'applicazione rigorosa:

  1. Utilizza l’editor che preferisci 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. Individua la seguente sezione nel file:

    code language-shell 
    ...
"assetRepository": {
    "options": {
...

  3. Modificare la sezione aggiungendo "strictSSL": false come segue:

    code language-shell 
    ...
"assetRepository": {
    "options": {
        "strictSSL": false,
...

  4. Salvare il file e riavviare l'app desktop Adobe Experience Manager.

Problemi di accesso quando si passa a un altro server cannot-login-cookies-issue

Dopo aver utilizzato un server Experience Manager, quando si tenta di modificare la connessione a un altro server, potrebbero verificarsi problemi di accesso. Ciò è dovuto all’interferenza dei vecchi cookie con la nuova autenticazione. Un'opzione nel menu principale per Clear Cookies aiuta. Uscire dalla sessione corrente nell'app e selezionare Clear Cookies prima di procedere alla connessione.

Cancella i cookie quando si cambia server

L’app non risponde unresponsive

Raramente l’applicazione potrebbe bloccarsi, visualizzare solo una schermata bianca o visualizzare un errore nella parte inferiore dell’interfaccia senza opzioni. Provare quanto segue nell'ordine:

  • Fare clic con il pulsante destro del mouse sull'interfaccia dell'applicazione e scegliere Refresh.
  • Chiudere l'applicazione e riaprirla.

In entrambi i metodi, l’app inizia dalla cartella DAM principale.

Nascondi risorse scadute hide-expired-assets

Durante l'esplorazione delle risorse dall'interfaccia utente Experience Manager, le risorse scadute non vengono visualizzate. Gli amministratori possono configurare le impostazioni per impedire la visualizzazione, la ricerca e il recupero delle risorse scadute durante la navigazione dall’app desktop e da Asset Link. In questo modo, le risorse scadute non saranno accessibili durante queste operazioni. La configurazione funziona per tutti gli utenti, indipendentemente dal privilegio di amministratore.

Related Articles
recommendation-more-help
d27c3dc5-a94a-4e63-a6d5-c47555beb65d