Observateur de champ

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture

    • L’outil d’observation de champ suit et affiche toutes les actions que le système effectue sur un champ de formulaire sélectionné.

    Remarque :
    L’observateur de champ n’est pas pris en charge avec Next Experience le Utahfichier . Pour en savoir plus sur les fonctionnalités prises en charge dans Next Experience, consultez Considérations relatives à l’activation de Next Experience.

    Les administrateurs peuvent utiliser l’observateur de champ pour déterminer ce qui arrive au champ et comment la valeur du champ change lorsqu’un événement tel que le déclenchement d’une règle métier ou l’application d’une politique de données se produit. Les administrateurs peuvent également emprunter l’identité d’utilisateurs non-administrateurs pour déboguer ce qui se passe lorsque ces utilisateurs apportent des modifications sur une instance. Un seul champ peut être surveillé à la fois. Les utilisateurs non-administrateurs disposant du rôle emprunteur d’identité ont accès à la fonctionnalité d’observateur de champ.

    Fonctionnement de l’observateur de terrain

    L’outil Observateur de champ consigne l’activité lorsque l’un des événements suivants se produit sur un champ :
    • La valeur par défaut est définie sur le champ.
    • Les droits d’accès de l’utilisateur pour le changement de champ en raison d’un paramètre ACL ou de dictionnaire.
    • Une politique de données empêche de définir la valeur.
    • Une requête de qualificatif de référence de la valeur de champ s’exécute.
    • Une politique d’interface utilisateur fait passer un champ de lecture seule, visible, obligatoire ou modifiable.
    • Une valeur dépendante dans un autre champ restreint les choix de champs.
    • La valeur du champ est définie ou modifiée en fonction des :
      • Règles d'affectation
      • Actions provenant d’un moteur, tel que le moteur de workflow
      • Règles métier
      • Entrées utilisateur
      • Scripts clients
      • Actions d'interface utilisateur
    Remarque :
    L’observateur de champ fonctionne uniquement sur les champs de formulaire. Il ne peut pas être utilisé sur les champs de liste. De plus, l’observateur de champ n’est pas disponible sur les champs protégés par mot de passe ou les champs chiffrés. L’observateur de champ n’est disponible que dans le cadre de l’interface utilisateur. L’option permettant d’observer un champ n’apparaît pas dans le menu contextuel si vous ouvrez un enregistrement en dehors du cadre de l’interface utilisateur, par exemple dans un nouvel onglet.

    Utiliser un observateur de champ

    Accédez aux informations de débogage au niveau des champs à l’aide de l’observateur de champ.

    Avant de commencer

    Rôle requis : aucun

    Procédure

    1. Accédez au formulaire pour lequel vous souhaitez afficher des informations de débogage au niveau des champs.
    2. Activez l’observateur de champ en cliquant avec le bouton droit de la souris sur n’importe quelle étiquette de champ d’un formulaire et sélectionnez Observer : « <nom de champ > ».

      L’icône de débogage ( L’icône de débogage) apparaît à côté de l’étiquette du champ. À partir de ce moment, l’observateur de champ enregistre chaque action effectuée sur le champ sélectionné. Par exemple, si vous observez un champ Priorité , si la priorité passe de Modérée à Faible et que l’enregistrement est mis à jour, l’observateur de champ affichera des informations sur ce changement.

    3. Affichez le journal de l’observateur de champ en cliquant sur l’icône de débogage.
      Un nouveau volet s’ouvre en bas de l’écran, affichant un onglet d’observateur de champ. Il peut également afficher des onglets pour la journalisation JavaScript et le débogueur JavaScript.
    4. Cliquez sur l’onglet Observateur de champ , si nécessaire.
    5. Pour arrêter d’observer un champ, cliquez avec le bouton droit de la souris sur le champ et sélectionnez Ne pas regarder - <nom du champ>.
      Pour observer un autre champ, cliquez avec le bouton droit de la souris sur ce champ et sélectionnez Regarder - <nom du champ>.
    6. Effacer le journal de l’observateur de champ en cliquant sur le bouton Effacer le journal ( Le bouton Effacer le journal).
    7. Redimensionnez le volet de l’observateur de champ en faisant glisser la barre de séparation vers le haut ou vers le bas.
      Faites glisser la barre de séparation vers le bas de l’écran pour fermer le volet de l’observateur de champ. Rouvrez le volet en cliquant à nouveau sur l’icône de débogage.

    Détails de l’onglet Observateur de champ

    L’observateur de champ affiche des informations de champ et des options de configuration.

    La partie gauche de l’onglet Observateur de champ affiche les informations suivantes pour le champ surveillé.
    • Table : table à laquelle le champ appartient.
    • Élément : étiquette du champ.
    • Type : type de données stockées dans le champ.
    • Dépendant : champ dont dépend le champ actuel.
    • Référence : table d’où provient la valeur du champ, le cas échéant.
    • Qualificatif de référence : qualificatifs de référence qui peuvent restreindre les données sur le champ.
    • Attributs : attributs sur le champ spécifiés dans l’entrée de dictionnaire pour ce champ.

    Sur le côté droit de l’onglet Observateur de champ, sélectionnez les types d’informations d’activité que vous souhaitez afficher pour le champ sélectionné. Décochez la case pour tout type d’information qui n’est pas nécessaire.

    Observation d’un champ caché

    Les administrateurs peuvent avoir besoin de surveiller un champ masqué.

    Procédure

    1. Utilisez le dictionnaire pour déterminer le nom de colonne du champ.
    2. Élevez les privilèges au rôle security_admin.
    3. Accédez à la Définition du système > Scripts - Arrière-plan.
    4. Dans Exécuter le script (JavaScript exécuté sur le serveur), entrez la commande suivante : 
      gs.getSession ( ). setWatchField ( "hidden_field" ) ;

      Remplacez hidden_field par le nom de colonne du champ masqué.

    5. Accédez au formulaire contenant le champ manquant.

      La sortie de l’onglet Observateur de champ contient des informations sur le champ masqué.

    Affichage des informations pour le champ surveillé

    Lorsque les informations d’un champ surveillé sont modifiées et que l’enregistrement est mis à jour, l’onglet Observateur de champ affiche les informations pertinentes en bas.

    Figure 1. Observateur de champ affichant les données
    Observateur de champ affichant les données
    Les informations relatives aux observateurs sur le terrain comprennent :
    • Horodatage : heure à laquelle le champ a été modifié à l’aide du format HH :MM :SS (ms).
      • Texte orange : changements côté serveur, tels que les ACL.
      • Texte bleu : changements côté client, tels que les scripts clients.
    • Type d’objet qui a modifié le champ et son nom associé : le type d’élément qui a changé sur le champ ; par exemple, SCRIPT CLIENT, RÈGLE MÉTIER ou ACL. Dans le cas de scripts, de règles métier ou d’autres champs de type configuration, l’observateur de champ affiche le nom du script ou de la règle métier qui a modifié le champ, le cas échéant. Cliquez sur le nom pour accéder directement à l’enregistrement de cet élément.
    • Anciennes et nouvelles valeurs : les anciennes et nouvelles valeurs du champ, si la valeur a changé0. L’observateur de champ n’enregistre pas la valeur si elle a été insérée dans le formulaire par défaut au moment de la création de l’enregistrement.
    • Informations supplémentaires : informations de suivi des appels, telles que le nom du moteur de script ou du workflow qui a modifié le champ. Cliquez sur l’icône plus pour développer la sélection.
      • Texte orange : indique une activité côté serveur.
      • Texte bleu : indique l’activité côté client.

    Exemple : Surveillance de la priorité de l’incident

    L’exemple suivant montre ce qu’il advient du champ Priorité du formulaire d’incident lorsque les champs Impact et Urgence sont modifiés.

    Le formulaire Incident comporte deux recherches de données côté client pour changer la priorité. En outre, les ACL côté serveur et le moteur de recherche de données se déclenchent lorsque l’enregistrement est enregistré. Enfin, une politique d’interface utilisateur côté client redéfinit le champ Priorité en lecture seule, qui est le paramètre par défaut.
    Tableau 1. Surveillance de la priorité de l’incident
    Valeurs d'origine
    • Priorité :1 - Critique
    • Impact :1 - Élevé
    • Urgence : 1 à élevée
    Premier changement
    1. L’utilisateur remet la valeur d’impact à 3 : faible.
    2. La priorité passe automatiquement à 3 - Modérée en fonction de la définition de recherche de données de recherche de priorité utilisée par défaut dans ServiceNow les incidents.
    Remarque :
    À ce stade, l’enregistrement n’a pas été enregistré.
    Deuxième changement
    1. L’utilisateur remplace la valeur d’urgence par 2 : moyenne.
    2. La priorité passe automatiquement à 4 - Faible en fonction de la même définition de recherche de données de recherche de priorité .
    3. L’utilisateur enregistre l’enregistrement en cliquant avec le bouton droit sur l’en-tête du formulaire et en choisissant Enregistrer.
    Figure 2. Exemple d’observateur de champ
    Remarque :
    Les valeurs qui changent de 1 à 3, puis de 3 à 4, font référence aux valeurs numériques de la liste de choix.