Identifier et résoudre les erreurs des clients

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 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 de client se produisent, le test de l’étape qui s’exécutait Framework de tests automatisés 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. Framework de tests automatisés considère ces erreurs comme des échecs de validation.

    Procédure

    1. Accédez à la Tout > Application > Framework de tests automatisés > Tests et exécutez un test de Framework de tests automatisés qui interagit avec un formulaire.
    2. Dans les résultats de test 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. Voir 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 Test exécutable client.
      Remarque :
      Pour en savoir plus 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 est constatée, essayez d’identifier et de résoudre les problèmes concernant le script côté client, qui peut se trouver dans 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 rechercher des erreurs et, une fois que vous les avez corrigées, exécutez à nouveau votre test.

    Que faire ensuite

    Déterminez la source de l’erreur du client en examinant l’historique des versions de 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 lors de la mise à niveau.

    Exemples d’erreurs client

    Il existe plusieurs types d’erreur client courante.

    Erreurs JavaScript du 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, l’étiquette Modifier les commentaires du script client est à l’origine de l’erreur.

    Autres erreurs de script client

    Tout autre type d’erreur de script est signalé 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 de 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. 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 aux scripts

    Lors de l’identification des scripts problématiques, assurez-vous que le script a 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 Séparation de domaine est configurée.