Utiliser des files d’attente personnalisées pour traiter les événements

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

    • Vous pouvez utiliser des files d’attente personnalisées pour les applications qui créent un grand volume d’événements ou qui prennent beaucoup de temps à traiter. Cette tâche montre comment créer une file d’attente personnalisée, son processus de surveillance et utiliser un script pour envoyer des événements à la file d’attente.

    Avant de commencer

    Rôle requis : admin

    Remarque :
    Ces informations sont destinées aux utilisateurs avancés qui comprennent le traitement des événements.

    Procédure

    1. Accédez à la Politique système > Événements > Registre.
    2. Sélectionnez l’événement pour lequel vous souhaitez créer une file d’attente personnalisée.
      Le formulaire d’inscription à l’événement s’affiche.
    3. Renseignez le champ File d’attente de l’événement dans le registre des événements.
      Utilisez uniquement des lettres minuscules, pas d’espace et pas de caractères spéciaux, à l’exception du trait de soulignement (_).

      Formulaire d’inscription à l’événement mettant en surbrillance le champ File d’attente contenant le nom de la file d’attente en minuscules.

    4. Cliquez sur Envoyer.
      Un nouvel événement est répertorié dans la table Événements [sysevent].

      Dans l’exemple suivant, lorsque l’événement employeeOccasion est généré, l’événement est ajouté à my_queue. Les événements sont bloqués dans la file d’attente. Pour résoudre ce problème, créez un processus pour surveiller la file d’attente des événements.Table d’événements répertoriant l’événement avec la file d’attente ajoutée répertoriée dans le champ File d’attente.

    5. Accédez à la Planificateur système > Travaux planifiés > Travaux planifiés et ouvrez la tâche planifiée nommée Processus d’événements d’index de texte.
      Table de calendrier avec *texte dans le Table de calendrierdans le champprocessus d’événements d’index de texte champ de recherche Nom et le nom du calendrier du processus d’événements d’index de texte mis en surbrillance.
    6. Cliquez sur l’icône du menu d’actions supplémentaires ( menu d’icône d’actions supplémentaires) et sélectionnez Insérer et rester pour créer une copie du processus d’événements d’index de texte.
      Important :
      Assurez-vous de copier la tâche et de ne pas remplacer la tâche planifiée du processus d’événements d’index de texte .
    7. Dans l’élément de calendrier copié, modifiez la valeur du champ Nom .
    8. Dans le champ Contexte de la tâche , remplacez la valeur du paramètre GlideEventManager() par le nom de la nouvelle file d’attente.
      Formulaire d’élément de calendrier affichant l’élément copié renommé et le nom de file d’attente mis à jour pour GlideEventManager dans le champde contexte de la tâche.
      Le processus de surveillance de file d’attente recherche et traite les événements dans l’exemple my_queue file d’attente d’événements.

      Table d’événements mettant en évidence le contenu des champs Traité et File d’attente.

    9. Utilisez le cinquième paramètre de la méthode gs.eventQueue() pour envoyer des événements à la file d’attente personnalisée.

      Le code suivant montre comment envoyer un événement à la file d’attente personnalisée my_queue.

      gs.eventQueue('x_60157_employee_spe.employeeOccasion', todaysOccasions, todaysOccasions.number, todaysOccasions.u_employee.name, 'my_queue');
      Remarque :
      Si un événement figure dans le registre des événements et qu’aucun nom de file d’attente n’est fourni à gs.eventQueue, la file d’attente du registre des événements est toujours affectée à l’événement. Par exemple, gs.eventQueue('x_60157_employee_spe.employeeOccasion') associe toujours l’événement à my_queue. Si le nom de file d’attente est fourni dans l’appel gs.eventQueue(), la file d’attente devient prioritaire.
      Vous pouvez vérifier que l’événement appelé a été traité en consultant la table Événements [sysevent].

      Table d’événements répertoriant les événements traités filtrés par le nom de l’événement.