Observateur de champ

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • L’outil d’observateur de champ suit et affiche toutes les actions effectuées par le système sur un champ de formulaire sélectionné.

    Remarque :
    L’observateur de champ n’est pas pris en charge dans Next Experience .Utah Pour plus d’informations sur les fonctionnalités prises en charge dans , voir Considérations relatives àNext Experience l’activation de Next Experience.

    Les administrateurs peuvent utiliser l’observateur de terrain 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 ayant le rôle d’emprunteur d’identité ont accès à la fonctionnalité d’observateur de champ.

    Fonctionnement de l’observateur de champ

    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 utilisateur pour le champ changent en raison d’un paramètre d’ACL ou de dictionnaire.
    • Une politique de données empêche la définition de la valeur.
    • Une requête de qualificatif de référence de la valeur du champ s’exécute.
    • Une politique d’interface utilisateur fait passer un champ en lecture seule, visible, obligatoire ou modifiable.
    • Une valeur dépendante dans un autre champ limite les choix de champs.
    • La valeur du champ est définie ou modifiée en fonction de :
      • Règles d'affectation
      • Actions 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 travaille uniquement sur les champs de formulaire. Il ne peut pas être utilisé dans les champs de liste. En outre, 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 d’observation d’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 du champ à 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 les informations de débogage au niveau des champs.
    2. Activez l’observateur de champ en cliquant avec le bouton droit sur n’importe quelle étiquette de champ d’un formulaire et en sélectionnant Observer : « <nom de champ > ».

      L’icône de débogage ( L’icône de débogage) apparaît en regard 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 affiche 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 sur le champ et sélectionnez Annuler la visualisation : <nom du champ>.
      Pour observer un autre champ, cliquez avec le bouton droit sur ce champ et sélectionnez Observer - <nom de champ>.
    6. Effacez 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 les informations de champ et les 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 de champ.
    • Type : type de données stockées dans le champ.
    • Dépendant : champ dont le champ actuel dépend.
    • Référence : table d’où provient la valeur du champ, le cas échéant.
    • Qualificatifs de référence : qualificatifs de référence qui peuvent restreindre les données sur le champ.
    • Attributs : attributs sur le champ tels que 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’informations qui n’est pas nécessaire.

    Observation d’un champ masqué

    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 Script exécuté (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. Données d’affichage d’observateur de champ
    Données d’affichage d’observateur de champ
    Les informations de l’observateur 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é : type d’élément qui a changé sur le champ ; par exemple, SCRIPT CLIENT, RÈGLE MÉTIER ou ACL. Dans le cas des scripts, des 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.
    • Valeurs anciennes et nouvelles : 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 par défaut dans le formulaire 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 : Observation 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 changent.

    Le formulaire Incident dispose de deux recherches de données côté client qui modifient 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 change la valeur d’impact sur 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és utilisée par défaut dans ServiceNow les incidents.
    Remarque :
    À ce stade, l’enregistrement n’a pas été sauvegardé.
    Deuxième changement
    1. L’utilisateur change la valeur Urgence sur 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 sauvegarde 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, se réfèrent aux valeurs numériques de la liste de choix.