Identifier et résoudre les erreurs des clients

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Identifiez les erreurs client et résolvez-les dans des scripts côté client.

    Avant de commencer

    Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    Lorsque des erreurs du client se produisent, le Framework de tests automatisés test de l’étape qui était en cours d’exécution au moment de l’erreur é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 sur la procédure en cours d’exécution. Automated Test Framework 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 du test pour 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 testée. Reportez-vous à la section Journaux des tests ayant échoué. Pour ignorer ces erreurs lors de la prochaine exécution du test, utilisez les liens « Ajouter toutes les erreurs client à la liste avertissement/ignorée ».

      Ce résultat d’étape n’apparaît que 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 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 vous voyez l’erreur, essayez d’identifier et de résoudre les problèmes liés au 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 de l’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 les 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 du script. Si vous avez personnalisé un script du système de base, il est possible que le script comporte de nouvelles versions qui ont été ignorées lors de la mise à niveau.

    Exemples d’erreurs du client

    Il existe plusieurs types d’erreurs courantes des clients.

    Erreurs JavaScript client

    Lorsqu’un script client provoque une erreur, la console du navigateur affiche une erreur semblable à 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, c’est le script client Modifier l’étiquette des commentaires qui 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 au moment de son apparition.

    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 ressource de script à l’aide de son ID système. La suite de ce lien peut donner le contexte du script qui 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 qu’ils ont l’autorisation d’accéder aux données. À vérifier :
    • Autorisations de règles 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 Séparation de domaine si Séparation de domaine est configurée.