Événements système

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

    • Les événements sont des enregistrements spéciaux que le système utilise pour consigner lorsque certaines conditions se produisent et pour prendre une action en réponse à ces conditions.

    Le système utilise des règles métier pour surveiller les conditions système et générer des enregistrements d’événements dans la table Événement [sysevent], également appelée journal des événements ou file d’attente des événements.

    Les règles métier génératrices d’événements utilisent généralement la logique de script suivante :

    Si [certaines conditions sont vraies pour l’enregistrement actuel], alors [ajouter un événement spécifique à la file d’attente].

    Par exemple, voici quelques-unes des conditions énoncées dans la règle métier Événement d’incident :
    • Si un utilisateur ajoute un commentaire à un enregistrement d’incident, ajoutez un incident.commented événement.
    • Si un utilisateur ajoute un enregistrement d’incident, ajoutez un incident.inserted événement.
    • Si un utilisateur met à jour un enregistrement d’incident, ajoutez un incident.updated événement.
    Les règles métier génératrices d’événements utilisent la méthode eventQueue GlideSystem pour insérer les enregistrements d’événements, qui contiennent généralement les informations suivantes :
    Tableau 1. Champs d’événement
    Champ Description
    Nom Nom unique de l’événement. Les noms d’événement de base de référence incluent l’enregistrement affecté et l’action de déclenchement, par exemple incident.commented.
    Parm1 Paramètre spécifique à l’événement que le système utilise pour transmettre les informations d’enregistrement à d’autres parties du système, par exemple un ID système d’enregistrement ou une valeur de champ.
    Parm2 Paramètre spécifique à l’événement que le système utilise pour transmettre les informations d’enregistrement à d’autres parties du système, par exemple un ID système d’enregistrement ou une valeur de champ.
    Table Table à laquelle l’événement s’applique. Il s’agit de la même table sur laquelle la règle métier a été exécutée.
    Instance ID système de l’enregistrement auquel cet événement s’applique.
    Les tâches planifiées lisent périodiquement la file d’attente des événements et la transmettent au gestionnaire approprié pour traitement. Le gestionnaire utilise les informations des enregistrements d’événements pour effectuer une action, par exemple :
    • Exécuter une action de script
    • Planifier une tâche
    • Envoyer une notification
    • Déclencher une activité de workflow
    • Déclencher un moniteur d’inactivité

    Par défaut, le système fournit des événements couvrant une vue étendue de l’activité de l’application. Si les événements existants ne répondent pas à vos besoins, vous pouvez créer vos propres événements pour surveiller les changements spécifiques apportés aux enregistrements.

    Pour la formation des développeurs, reportez-vous aux sections Exécutions de script planifiées et Objectifs d’événements sur la ServiceNow® Site Developerpage .

    Traitement des événements pendant la mise à niveau de la plateforme

    Déterminez quels événements doivent être traités lors d’une mise à niveau de plateforme en configurant les propriétés suivantes :

    • glide.event_processor.all_events_upgrade_safe : défini sur vrai pour traiter tous les événements pendant la mise à niveau de la plateforme. Valeur par défaut = faux.
    • glide.event_processor.upgrade_safe_events : configurez une liste de noms d’événements séparés par des virgules pour indiquer que seuls les événements spécifiés sont traités. Valeur par défaut = <empty>.

      Cette propriété n’est pertinente que lorsque glide.event_processor.all_events_upgrade_safe = false.