Configurer une règle d'événement pour personnaliser le contenu de l'alerte

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

    • Vous pouvez configurer une règle d'événement pour personnaliser le contenu de l'alerte. Vous pouvez personnaliser l'ordre des champs et sélectionner les champs affichés. Les champs de la zone de travail à gauche de la section Sortie d'alerte transformer et composer d'une règle d'événement correspondent aux champs qui figurent dans l'alerte générée.

    Avant de commencer

    Rôle requis : evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez personnaliser le contenu de l'alerte en ajoutant les champs d'événement requis et en modifiant le texte dans les champs.
    Remarque :
    lors de la création de l'expression regex pour l'entrée, assurez-vous de créer une entrée avec les variables dans l'ordre séquentiel. Bien que vous puissiez ignorer les variables pour inclusion, l'ordre sélectionné doit être maintenu.
    Mettez en forme le texte de l'alerte à l'aide de l'une ou des deux méthodes suivantes :
    Tableau 1. Mettre en forme le texte de l'alerte
    Méthode de mise en forme Description
    Transformer Créez un champ à afficher dans une alerte. Le champ et sa valeur s’affichent dans la section Informations supplémentaires ou dans la section Balises d’alerte . Dans le volet Entrée d'événement, le nouveau champ est répertorié dans la section Expressions.
    Composer Déterminez le texte à afficher dans le champ sélectionné.
    Remarque :
    • Configurez les champs qui s'affichent dans le volet Entrée d'événement en configurant la liste d'exclusion [em_event_rule_black_list].

      Un champ saisi dans la liste d'exclusion qui apparaît déjà dans une règle d'événement existante n'est pas supprimé de la règle ; au lieu de cela, il est déplacé vers la section Attributs manuels de la règle.

    • Contrôlez l'ordre des champs de formulaire d'événement en configurant l'attribut em_event_rule_order.

    Procédure

    1. Accédez à la Tout > Gestion des événements > Règles > Règles d'événements.
    2. Cliquez sur Nouveau ou ouvrez une règle d'événement.
    3. Cliquez sur Sortie d'alerte transformer et composer.
      Dans cette section, vous pouvez utiliser le mode Transformer et le mode Composer.
    4. Pour transformer les informations dans les champs, en mode standard :
      Remarque :
      dans cette étape, la sélection du texte est effectuée en mode d'édition standard. Dans ce mode, vous pouvez utiliser la fonction d'annulation.
      1. Cliquez sur le champ requis dans le volet Entrée d'événement. La valeur et le contenu du champ sélectionné s'affichent dans la zone de travail de gauche.

        Event Management, sortie

      2. Sélectionnez le mode d'édition standard icône Event Management.
      3. À l’aide du curseur crayon, mettez en surbrillance le texte requis. Vous pouvez double-cliquer sur le texte dans le champ pour sélectionner un terme icône Event Management ou sélectionner le texte et les symboles requis.
        Remarque :
        si vous sélectionnez Accessibilité activée Accessibilité activée dans les paramètres système, le mode d'édition standard n'est pas disponible icône du mode d'édition standard.
      4. Sélectionnez un nom de champ dans la liste ou saisissez le nom d'expression requis. Les champs qui apparaissent dans la liste sont des champs d’événements existants, des champs d’informations supplémentaires ou des balises d’alerte précédemment définies (champs préfixés par « t_ »). Le nom du champ s'affiche dans le volet Expressions et le texte sélectionné est mis en surbrillance. La couleur de surbrillance est la même pour le texte et le nom de l'expression. Chaque expression supplémentaire que vous créez (et sa valeur) est mise en surbrillance dans une couleur différente.

        Event Management, sortie

        Remarque :
        les noms de champs de transformation ne peuvent pas contenir un caractère ‘ (guillemet simple).
      5. Cliquez sur Terminé. Le nom de l'expression s'affiche dans la section Expressions du volet Entrée d'événement.

        Event Management, sortie

      6. Si vous cliquez sur une expression ou sur sa valeur dans le volet Entrée d'événement, les détails correspondants s'affichent dans la zone de travail de gauche.
    5. Pour transformer les informations dans les champs, en mode regex :
      Remarque :
      • En mode regex, l'option d'annulation n'est pas disponible.
      • Lors de la création d'une expression régulière (regex) à partir de variables mises en surbrillance dans l'événement, placez les variables sélectionnées dans le même ordre dans lequel elles figurent dans le champ d'événement.
      • Lors de la composition du regex de règle d'événement, spécifiez les termes à l'aide d'une correspondance exacte de l'entrée à partir des champs d'événement. Par exemple, pour le texte vhxy2stlgwc_8888_hec03v012979, le regex 
        ^([^_]+)_
        devrait prendre en compte le texte « vhxy2stlgwc » qui précède le trait de soulignement. Cela n'est toutefois pas le cas, car ce texte n'est pas une correspondance exacte. Utilisez le regex complet, à savoir :
        ^([^_]+)_.*
      • L'analyseur de correspondance Java est utilisé pour le moteur regex. Assurez-vous d'utiliser un analyseur Java pour tester le regex.
      • Si le regex ne correspond pas à la chaîne complète lors de l'analyse des données, la règle d'événement ne capture pas l'événement et aucune analyse n'a lieu.
      • La méthode de « mise en correspondance » du moteur regex Java est utilisée. Avec cette implémentation, le moteur regex tente de mettre en correspondance l'ensemble de la séquence d'entrée avec le modèle spécifié. D'autres méthodes de mise en correspondance, notamment la méthode de recherche, ne sont pas prises en charge.
      • Aucun marqueur regex n'est défini par défaut, à l'exception du marqueur Pattern.DOTALL. Avec cette implémentation du regex Java, le caractère POINT « . » représente n'importe quel caractère, y compris une marque de fin de ligne.
      • Outre Pattern.DOTALL, les autres marqueurs regex ne peuvent pas être modifiés.
      • Lookahead est pris en charge. Toutefois, Lookbehind n'est pas pris en charge.
      1. Cliquez sur le champ requis dans le volet Entrée d'événement. La valeur et le contenu du champ sélectionné s'affichent dans la zone de travail de gauche.
      2. Sélectionnez le mode d'édition du regex icône Event Management.

        Event Management, sortie

      3. Sélectionnez le texte et les symboles requis graphique Event Management. Remplacez le texte en surbrillance par (.*) pour créer une expression regex.
      4. Dans le volet Expressions , cliquez sur le champ Sélectionner ou ajouter un champ .

        image Event Management

      5. Sélectionnez un nom de champ dans la liste ou saisissez le nom d'expression requis. Les champs qui apparaissent dans la liste sont des champs d’événements existants, des champs d’informations supplémentaires ou des balises d’alerte précédemment définies (champs préfixés par « t_ »). Le nom du champ s’affiche dans le volet Expressions .

        Event Management, sortie

        Remarque :
        les noms de champs de transformation ne peuvent pas contenir un caractère ‘ (guillemet simple).
      6. Cliquez sur Terminé.
      Remarque :
      • Lors de la création d'une expression régulière (regex) à partir de variables mises en surbrillance dans l'événement, placez les variables sélectionnées dans le même ordre dans lequel elles figurent dans le champ d'événement.
      • Lors de la composition du regex de règle d'événement, spécifiez les termes à l'aide d'une correspondance exacte de l'entrée à partir des champs d'événement. Par exemple, pour le texte vhxy2stlgwc_8888_hec03v012979, le regex ^([^_]+)_ devrait prendre en compte le texte « vhxy2stlgwc » qui précède le trait de soulignement. Cela n'est toutefois pas le cas, car ce texte n'est pas une correspondance exacte. Utilisez le regex complet, à savoir : ^([^_]+)_.*
    6. Pour composer du texte, dans la section Sortie d'alerte transformer et composer, cliquez dans le champ requis.
      Event Management, sortie

      Composez le texte dans les champs d'alerte en procédant de l'une des façons suivantes :

      • Déplacez un champ du volet Informations sur l'événement vers le champ requis.
      • Utilisez le volet Informations sur l'événement comme référence des champs disponibles. Spécifiez le nom du champ au format ${<nomduchamp>}, où « $ » signifie « utiliser la valeur ». Entre les accolades, le nom du champ d'événement remplace la variable <nomduchamp>.
      • Saisissez le texte de votre choix (les espaces et tous les caractères sont pris en charge). Par exemple, utilisez des espaces ou des traits de soulignement (_) pour faciliter la lisibilité du texte dans le champ d'alerte.
    7. Pour spécifier les champs qui doivent s’afficher dans l’alerte générée, cochez la case Attributs manuels .
      Remarque :
      Ces champs, ainsi que leurs valeurs, s’affichent dans la section Informations supplémentaires ou dans la section Balises d’alerte pour les attributs précédés du préfixe « t_ ».
      1. Dans la colonne de gauche, saisissez une valeur.
      2. Dans la colonne de droite, faites glisser une valeur à partir des champs Ajouter ou Expression ou saisissez une valeur.
        Lors de la saisie d’une valeur avec des attributs préfixés par « t_ », une liste déroulante apparaît avec tous les attributs « t_ » définis précédemment.
    8. Cliquez sur Enregistrer ou sur Mettre à jour.

    Que faire ensuite

    Vous pouvez filtrer les règles d'événement. Consultez la rubrique Filtrer les événements auxquels une règle d'événement s'applique.