IEventSender - Global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 1 minute de lecture
  • L’API IEventSender fournit des méthodes permettant d’envoyer des événements d’une Serveur MID instance à une ServiceNow et d’interroger l’état de la file d’attente d’événements.

    Avant d’appeler des méthodes de cette classe, vous devez appeler la méthode SNEventSenderProvider.getEventSender() pour instancier un objet IEvent.

    Utilisez l’API d’événement pour ajouter/mettre à jour des champs dans un événement. Utilisez l’API SNEventSenderProvider pour instancier un objet d’expéditeur d’événement. Ensuite, utilisez l’API IEventSender pour envoyer l’événement à une ServiceNow instance.

    Vous devez activer le module d’extension Event Management (com.glideapp.itom.snac) avant de tenter d’accéder à cette API. Le module d’extension Event Management nécessite un abonnement séparé et doit être activé par ServiceNow le personnel. Ce module d'extension inclut des données de démonstration et active les modules d'extension connexes s'ils ne sont pas déjà activés.

    Pour plus d’informations sur Event Management, consultez Event Management.

    IEventSender : getQueueSize()

    Renvoie la taille de la file d’attente d’événements.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Numéro Taille de la file d’attente de l’événement .

    Si une file d’attente d’événements n’est pas actuellement implémentée, elle renvoie « 0 ».

    var event = new Event();
    event.setField("source","SAP Solman");
    event.setField("severity","3");
    event.setField("time_of_event", "2019-18-05 13:12:05");
    event.setField("type", "SAP object");
    event.setField("user", "admin"); // parameter added to additional info section
    
    var eventSender = SNEventSenderProvider.getEventSender();
    var sendStatus = eventSender.sendEvent(event); //send event     
    var queueSize = eventSender.getQueueSize() // check the size of the event queue

    IEventSender - isFullQueue()

    Vérifie si la file d’attente d’événements a dépassé sa taille maximale.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Booléen Marqueur indiquant si la file d’attente d’événements a dépassé sa taille maximale. Dans ce cas, aucun message d’événement supplémentaire ne peut être mis en file d’attente tant que la file d’attente n’a pas diminué.
    Valeurs valides :
    • true : la file d’attente de l’événement est pleine.
    • false : la file d’attente d’événements n’est pas pleine et peut ajouter d’autres entrées d’événements.
    var eventSender = SNEventSenderProvider.getEventSender();
    if (!eventSender.isFullQueue()) // If queue is not full, send event
      eventSender.sendEvent(event);     
    

    IEventSender : sendEvent(événement d’objet)

    Place l’événement spécifié dans la file d’attente des événements.

    Tableau 5. Paramètres
    Nom Type Description
    event IEventSender Objet d’événement à placer dans la file d’attente des événements.
    Tableau 6. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’événement a été correctement mis en file d’attente
    Valeurs valides :
    • true : l’événement a été mis en file d’attente
    • false : erreur
    var eventSender = SNEventSenderProvider.getEventSender();
    eventSender.sendEvent(event); //send event