Domanda

Come posso eseguire il debug di Zendesk App Framework (ZAF)?

Risposta

Il framework Zendesk Apps consente di creare app con funzionalità e caratteristiche complesse. Questo articolo fornisce linee guida su come affrontare i problemi negli scenari più comuni.

Avvertenza: L’assistenza clienti Zendesk può solo fornire assistenza dimostrando le capacità e le funzionalità del framework Zendesk Apps (ZAF). Qualsiasi problema relativo al codice personalizzato o alle implementazioni deve essere discusso con gli sviluppatori dell’app.

Per risolvere questi problemi, procedi nel seguente modo:

  • Cattura gli errori
  • Genera un elenco di app installate
  • Identifica l’app
  • Genera un file HAR
  • Usa l’API delle app

Cattura gli errori

Usa lo strumento per sviluppatori del browser. Se un'app mostra comportamenti inaspettati, raccogli un elenco di errori per ulteriori ricerche dallo strumento per sviluppatori del browser.

Accedi allo strumento per sviluppatori in diversi browser:

  • Chrome: Apri Chrome DevTools 
  • Firefox: Console web 
  • Safari: Usa gli strumenti per sviluppatori nel menu Sviluppo in Safari sul Mac 
  • Microsoft Edge: Apri Microsoft Edge DevTools

La console visualizza eventuali errori o messaggi di avviso. Per gli errori relativi alle richieste di rete, dai un'occhiata alla scheda Rete dello strumento.

Genera un elenco di app installate

Genera un elenco di tutte le app installate nell’account.

L’endpoint API Elenca installazioni di app genera un elenco JSON delle app installate. Le proprietà incluse possono essere usate per noapps e app_ids parametri di query discussi più avanti:

  • abilitata:indica se un’app è attiva o meno
  • app_id: l’ID dell’app. È necessario quando si usa il file app_idsparametro.
  • ID installazione: l’ID di installazione dell’app. Può essere usato facoltativamente per noappsparametro. Le app possono essere installate più volte, se l’app lo consente. Ogni installazione avrà un ID di installazione diverso, ma avrà lo stesso ID app.

Per accedere all’endpoint:

  • Usa l’arricciatura 
    curl https://{subdomain}.zendesk.com/api/v2/apps/installations.json\
    -u{email_address}:{password}
  • Oppure aggiungi /api/v2/apps/installations.json all’URL del sottodominio dell’account: 
    https://your_subdomain.zendesk.com/api/v2/apps/installations.json

Devi essere un agente nell’account Zendesk

Identifica l’app

Disattiva le app in modo selettivo per trovare il colpevole. Per disattivare un’app:

  • In Support, segui le istruzioni in questo articolo: Gestione delle app installate.
  • Oppure aggiungi il ?noapps suffisso nell’URL del ticket: 
https://your_subdomain.zendesk.com/agent/tickets/123456?noapps

Genera un file HAR

Il file HAR è un formato standard per il monitoraggio di informazioni ed eventi tra un browser e un sito web. Registra gli eventi di rete in un file HAR per risolvere i problemi di prestazioni o rendering. Per generare un file HAR, leggi questo articolo: Generazione del file HAR per la risoluzione dei problemi.

Usa l’API delle app

Risolvi il problema sfruttando l’endpoint API Elenca installazioni di app per generare un elenco delle app installate. Tra le proprietà contenute nella risposta JSON, quella per cui usa l’ ID di installazione come parametro di query noapps per disabilitare più app contemporaneamente:

https://your_subdomain.zendesk.com/agent/tickets/123456?noapps=11111,22222,44444

Se vuoi informazioni su come creare un’app Support da zero, leggi questo articolo: Crea la tua prima app Support - Parte 1: Gettare le basi. Se hai bisogno di informazioni su come creare un’app lato server, leggi questo articolo: Creazione di un’app lato server - Parte 1: Concetti fondamentali.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.

Powered by Zendesk