Question

Comment déboguer Zendesk Apps Framework (ZAF)?

Réponse

Le framework des applications Zendesk vous permet de créer des applications dotées de fonctionnalités complexes. Cet article fournit des instructions sur la façon d'aborder les problèmes dans les scénarios les plus courants.

Exonération : L'assistance client Zendesk peut seulement vous aider à montrer les capacités et fonctionnalités de Zendesk Apps Framework (ZAF). Tout problème concernant le code personnalisé ou ses implémentations doit être discuté avec les développeurs de l'application.

Pour résoudre ces problèmes, suivez les étapes ci-dessous :

  • Capturez les erreurs
  • Générer une liste des applications installées
  • Identifier l'application
  • Générer un fichier HAR
  • Utiliser l'API des applications

Capturez les erreurs

Utilisez l'outil de développement du navigateur. Si une application présente des comportements inattendus, créez une liste des erreurs à partir du navigateur pour développeurs, à des fins de recherches plus approfondies.

Accédez à l'outil pour les développeurs dans différents navigateurs :

  • Chrome : Ouvrir Chrome Devtools 
  • Firefox : Console Web 
  • Safari : Utilisation des outils de développement du menu Développer dans Safari pour Mac 
  • Microsoft Edge : Ouvrir Microsoft Edge Devtools

La console affiche tous les messages d'erreur ou d'avertissement. Pour les erreurs de demande de réseau, consultez l'onglet Réseau de l'outil.

Générer une liste des applications installées

Générer une liste de toutes les applications installées dans le compte.

La liste Installations d'applications du point final de l'API génère une liste JSON des applications installées. Les propriétés incluses peuvent être utilisées pour les noapps et app_ids paramètres de requête abordés plus tard :

  • enabled :indique si une application est active ou non.
  • app_id : l'ID de l'application. Elle est nécessaire si vous utilisez app_ids.
  • installation ID: l'ID d'installation de l'application. Peut être utilisé pour noapps. Les applications peuvent être installées plusieurs fois si l'application le permet. Chaque installation aura un ID d'installation différent, mais le même ID de l'application.

Pour accéder au point de terminaison :

  • Utiliser curl 
    curl https://{subdomain}.zendesk.com/api/v2/apps/installations.json\
    -u{email_address}:{password}
  • Ou annexer /api/v2/apps/installations.json à l'URL du sous-domaine du compte : 
    https://your_subdomain.zendesk.com/api/v2/apps/installations.json

Vous devez être un agent dans le compte Zendesk.

Identifier l'application

Désactivez les applications de façon ciblée pour trouver le responsable. Pour désactiver une application :

  • Dans Assistance, suivez les instructions de cet article : Gestion de vos applications installées.
  • Ou ajoutez la balise ?noapps suffixe à l'URL du ticket : 
https://your_subdomain.zendesk.com/agent/tickets/123456?noapps

Générer un fichier HAR

Le fichier HAR est un format standard pour le suivi des informations et des événements entre un navigateur et un site Web. Enregistrez les événements réseau dans un fichier HAR pour résoudre les problèmes de performances ou de rendu. Pour générer un fichier HAR, consultez cet article : Génération d'un fichier HAR à des fins de dépannage.

Utiliser l'API des applications

Résolvez ce problème en utilisant la liste du point de terminaison de l'API Installations d'applications pour générer une liste des applications installées. Parmi les propriétés contenues dans la réponse JSON, utilisez l' ID d'installation comme paramètre de requête pour noapps Pour désactiver plusieurs applications à la fois :

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

Si vous voulez des informations sur la façon de créer une application Support de zéro, consultez cet article : Création de votre première application Support - Partie 1 : Jeter les bases. Si vous avez besoin d'informations sur la façon de créer une application côté serveur, consultez cet article : Création d'une application côté serveur - Partie 1 : Concepts de base.

Traduction - exonération : cet article a été traduit par un logiciel de traduction automatisée pour permettre une compréhension élémentaire de son contenu. Des efforts raisonnables ont été faits pour fournir une traduction correcte, mais Zendesk ne garantit pas l’exactitude de la traduction.

Si vous avez des questions quant à l’exactitude des informations contenues dans l’article traduit, consultez la version anglaise de l’article, qui représente la version officielle.

Réalisé par Zendesk