Identifier et résoudre les erreurs des clients

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture
  • Identifiez les erreurs des clients et résolvez-les dans des scripts côté client.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Lorsque des erreurs du client se produisent, le test de l’étape Framework de tests automatisés qui s’exécutait au moment où l’erreur s’est produite échoue. Même si les scripts côté client peuvent échouer silencieusement sur des erreurs JavaScript pendant l’exécution des procédures, l’erreur peut toujours avoir un impact sur les données et la procédure en cours d’exécution. L’Automated Test Framework considère ces erreurs comme des échecs de validation.

    Procédure

    1. Accédez à la Tout > Demande > Framework de tests automatisés > Tests et exécuter un test de Framework de tests automatisés qui interagit avec un formulaire.
    2. Dans les résultats des tests de ce test, recherchez un résultat d’étape avec le résumé suivant :

      Cette étape a échoué car l’erreur client « MESSAGE D’ERREUR DÉTAILLÉ » a été détectée sur la page en cours de test. Consultez les journaux de test défaillants. Pour ignorer ces erreurs lors de la prochaine exécution de test, utilisez les liens « Ajouter toutes les erreurs de client à la liste d’avertissement/ignorée ».

      Ce résultat d’étape s’affiche uniquement sur une étape qui interagit avec l’interface utilisateur.

    3. Pour identifier et résoudre ces erreurs de script, ouvrez la console du navigateur des outils de développement sur la page Client Test Runner.
      Remarque :
      Pour plus d’informations sur l’ouverture de la console du navigateur, consultez l’article suivant : http://webmasters.stackexchange.com/questions/8525/how-to-open-the-javascript-console-in-different-browsers
    4. Si l’erreur s’affiche, essayez d’identifier et de résoudre les problèmes du script côté client, qui peut se trouver sur l’une des tables système de base suivantes :
      • ServiceNow Client Script
      • Action d'interface utilisateur
      • Macro d’interface utilisateur (script HTML)
      • Page d’interface utilisateur (script HTML)
      • Politique d'interface utilisateur
      • Script d'interface utilisateur
      • Tables qui étendent les tables système de base précédentes
    5. Examinez le script pour voir s’il y a des erreurs et, une fois que vous les avez corrigées, relancez votre test.

    Que faire ensuite

    Déterminez la source de l’erreur du client en examinant l’historique des versions du script. si vous avez personnalisé un script de système de base, il est possible que le script ait de nouvelles versions qui ont été ignorées pendant la mise à niveau.

    Exemples d’erreurs des clients

    Il existe plusieurs types d’erreurs client courantes.

    Erreurs JavaScript client

    Lorsqu’un script client provoque une erreur, la console du navigateur affiche une erreur similaire à l’exemple suivant :

    ***************************************************
    A script has encountered an error in render events
    TypeError: Cannot read property 'id' of undefined
    Script ends. Continuing happily
    ***************************************************
    [00:00:00.002] onLoad Modify Comments Label

    Dans cet exemple, le script client Modifier l’étiquette des commentaires est à l’origine de l’erreur.

    Autres erreurs de script client

    Tout autre type d’erreur de script signale directement à la console du navigateur avec n’importe quel formatage dès qu’il se produit.

    TypeError : callbacks(id) n’est pas défini

    Liens des ressources de script par ID système

    Dans certains cas, l’erreur de console fournit un lien vers le fichier de ressources de script à l’aide de son ID système. Le fait de suivre ce lien peut donner le contexte auquel le script l’a exécuté.

    Uncaught ReferenceError: myobj is not defined
        at incident.do?sys_id=12345678901234567890123456789012
    (anonymous) @ incident.do?sys_id=12345678901234567890123456789012  <---- LINK
    

    Autorisations d’accès au script

    Tout en identifiant les scripts problématiques, assurez-vous que le script dispose de l’autorisation d’accéder aux données. À vérifier :
    • Autorisations de règle de contrôle d’accès pour les tables et les champs.
    • Autorisations d’accès à l’application si le script accède aux applications dans un périmètre privé.
    • Autorisations de séparation de domaine si la séparation de domaine est configurée.