Créer une règle d’analyse
Renseignez les variables de sortie définies dans une activité personnalisée avec les données de charge utile renvoyées à partir d’un test d’entrées sur un hôte ou un point de terminaison externe.
Avant de commencer
Pourquoi et quand exécuter cette tâche
Procédure
-
Faites glisser une variable de sortie du générateur de structure de données vers le champ Nom de variable du générateur de règles d’analyse .
Figure 1. Mapper les variables aux règles d’analyse Le formulaire de règles d’analyse s’affiche pour la variable sélectionnée. Par défaut, le type d’analyse est défini sur Direct, ce qui remplit la variable avec toutes les données de la charge utile sélectionnée, sans analyser le contenu. Chaque modèle a une source d’analyse par défaut spécifique.
-
Remplissez le formulaire à l'aide des champs de la table.
Dans cet exemple, le type d’analyse sélectionné est XML, ce qui vous permet de sélectionner des paramètres spécifiques de la charge utile à analyser.
Tableau 1. Analyse des champs de règles Champ Description Source de l'analyse Source des données renvoyées par l’hôte ou le point de terminaison cible. Chaque modèle s’ouvre sur une charge utile par défaut spécifique. Les choix disponibles dépendent du modèle d’exécution sélectionné pour l’activité. Vous pouvez également utiliser des variables locales comme source d’analyse si une règle d’analyse a déjà été définie pour elles. Pour obtenir la liste des charges utiles disponibles pour chaque modèle, reportez-vous à la section Sources d’analyse de concepteur d’activité. Expression Expression utilisée pour extraire des données spécifiques de la source d’analyse sélectionnée. Cette expression est créée à partir de données cliquables dans l’exemple de charge utile et s’affiche au format sélectionné dans le champ Type d’analyse . Lors du test, l’expression peut renvoyer plusieurs résultats. Discernez quelle option donne des résultats fiables ou prévisibles avant de choisir votre expression. Remarque :Le système ne peut pas générer d’expressions RegEx cliquables à partir d’exemples de données. Vous devez écrire toutes les expressions régulières manuellement.Nom de variable Nom de variable révisé tel qu’il est utilisé dans l’expression de sortie finale. Le système ajoute le préfixe activityOutput ou activityLocal à la variable que vous spécifiez. Type d’analyse Langue à utiliser pour interroger la charge utile de l’hôte cible. Les sélections sont les suivantes : - Direct : mappe à l’intégralité du contenu de la charge utile sélectionnée dans le champ Source d’analyse , sans aucune analyse. Il s’agit du type d’analyse par défaut.
- XML : requête XPath utilisée pour sélectionner des nœuds à partir d’une charge utile XML.
- JSON : JSONPath pour sélectionner des parties d’une charge utile JSON.
- RegEx : méthode d’analyse qui utilise une expression régulière pour extraire des données d’une charge utile. Le type d’analyse RegEx ne prend pas en charge l’analyse multiligne et n’est pas sensible à la casse.
Description brève Brève description de cette règle d’analyse. Exemples de données de charges utiles Exemples de données provenant de la source contenant les données demandées. Ce champ n’est pas disponible pour les types d’analyse directe . Une fois que vous avez cliqué sur Analyser les exemples de données, les données de ce champ ne peuvent pas être modifiées, mais deviennent cliquables dans le but de créer des expressions. Cliquez sur Modifier les exemples de données pour rendre le champ à nouveau modifiable. Résultats d’analyse Affiche les données renvoyées par la source par l’expression sélectionnée. Ce champ n’est pas disponible pour les types d’analyse directe .
Sources d’analyse de concepteur d’activité
Ce tableau répertorie les sources d’analyse disponibles pour chaque modèle d’exécution.
| Modèle | Source |
|---|---|
| SOAP Web Service |
|
| JDBC |
|
| Sonde JavaScript |
|
| Powershell |
|
| REST Web Service |
|
| SFTP |
|
| Sonde |
|
| SSH |
|
| JMS |
|
Exemple de règle d’analyse de concepteur d’activité
Dans cet exemple, la règle d’analyse est configurée pour renseigner la variable activityOutput.ipv4 avec la valeur de l’adresse IP d’un serveur de domaine, à l’aide de PowerShell.
Avant de commencer
Pourquoi et quand exécuter cette tâche
Pour générer les données d’échantillon, l’administrateur doit exécuter la commande sur l’hôte, puis coller les données renvoyées dans le champ Données d’exemple de charge utile lors de la création de la règle d’analyse. L’administrateur peut ensuite créer une expression qui renvoie les adresses IP de cet échantillon dans deux formats : ipv4 et ipv6. Dans cet exemple, le système produit deux expressions à utiliser pour la règle d’analyse.
Procédure
-
Cliquez sur l’onglet Entrées et notez la commande.
Figure 2. Règle d’analyse Commande d’entrées PowerShell -
Sélectionnez le type d’analyse de la source.
Dans l’exemple suivant, vous sélectionneriez XML.
-
Cliquez sur Analyser les exemples de données.
Le système affiche le XML au format approprié et il devient cliquable. Dans cette vue, le système peut traduire les données cliquées de l’échantillon en une expression.
-
Pour créer l’expression, cliquez sur les éléments de l’échantillon de données que vous souhaitez mapper à la variable.
À partir des exemples de données sur lesquels vous avez cliqué, le système crée deux expressions.
-
Sélectionnez une expression dans la liste.
Le résultat souhaité est l’adresse IP qui a un attribut de typeipv4. Le système remplit le champ Expression avec ce choix.
-
Cliquez sur Tester l’expression.
Le système analyse la charge utile à l’aide de l’expression sélectionnée et renvoie les données demandées dans le champ Résultat de l’analyse .
-
Cliquez sur Envoyer.
La vue revient à l’onglet Sorties du concepteur d’activité. La nouvelle règle d’analyse est répertoriée et une ligne vide est disponible pour une autre règle.