Observateur de champ

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • L’outil Observateur 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 Next Experience avec le Utahfichier . Pour plus d’informations 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 sa valeur 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 à une instance. Il n’est possible d’observer qu’un seul champ à 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 des utilisateurs 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 de champ s’exécute.
    • Une politique d’interface utilisateur fait passer un champ de l’état en lecture seule, visible, obligatoire ou modifiable.
    • Une valeur dépendante dans un autre champ restreint les choix de champ.
    • La valeur du champ est définie ou modifiée en fonction des éléments suivants :
      • 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 fonctionne uniquement sur les champs de formulaire. Elle ne peut pas être utilisée 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 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 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 des informations de débogage au niveau du champ.
    2. Activez l’observateur de champ en cliquant avec le bouton droit sur une étiquette de champ d’un formulaire et sélectionnez Regarder : « <nom de champ> ».

      L’icône de débogage (icône de débogage) apparaît à côté de l’étiquette du champ. À partir de ce point, l’observateur de champ enregistre chaque action effectuée sur le champ sélectionné. Par exemple, si vous surveillez un champ de 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. Arrêtez d’observer un champ en cliquant avec le bouton droit de la souris sur le champ et en sélectionnant 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. Effacez le journal de l’observateur de champ en cliquant sur le bouton Effacer le journal (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.

    Le côté 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 dépend le champ courant.
    • 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 tels que spécifiés dans l’entrée de dictionnaire de ce champ.

    Sur le côté droit de l’onglet Observateur de champ, sélectionnez les types d’informations d’activité que vous souhaitez voir 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 devront peut-être 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 sur les 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 en 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é dans 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 : 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 sur le 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 élargir la sélection.
      • Texte orange : indique une activité côté serveur.
      • Texte en bleu : indique une 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 changent.

    Le formulaire Incident comporte deux recherches de données côté client : modifier la priorité. En outre, les ACL côté serveur et le moteur de recherche de données se déclenchent lors de la sauvegarde de l’enregistrement. 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 définit la valeur de l’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é 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 fait passer la valeur d’urgence à 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, puis 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.