--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Créer une règle d'analyse # Créer une règle d'analyse {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture Renseignez les variables de sortie définies dans une activité personnalisée avec les données de charge utile renvoyées par un test d'entrées sur un hôte ou un point de terminaison externe. ## Avant de commencer Rôles requis : activity_admin, activity_creator ## Pourquoi et quand exécuter cette tâche ## Procédure 1. Accédez à la TousWorkflowÉditeur de workflow. 2. Depuis l'onglet Personnalisé de la palette, ouvrez une activité personnalisée. 3. Dans le formulaire Concepteur d'activité, passez à l'étape Sortie . 4. 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. Mappage des 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](https://servicenow-prod.fluidtopics.net/MvPjfPwcbqm1MnFZeco_Tg#r_ActivityDesignerParsingSources "Ce tableau répertorie les sources d’analyse disponibles avec chaque modèle d’exécution.") par défaut spécifique. 5. Remplissez le formulaire en utilisant les 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 à partir de la charge utile à analyser. {#t_CreateAParsingRule__table_yry_ptm_cr__entry__2} | Champ | Description | |-|-| | Source de l'analyse | Source des données renvoyées par l'hôte cible ou le point de terminaison. Chaque modèle s'ouvre avec 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é](https://servicenow-prod.fluidtopics.net/MvPjfPwcbqm1MnFZeco_Tg#r_ActivityDesignerParsingSources "Ce tableau répertorie les sources d’analyse disponibles avec chaque modèle d’exécution."). | | 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 des tests, l'expression peut renvoyer plusieurs résultats. Discernez quel choix 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'ensemble 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 les 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. {#t_CreateAParsingRule__ul_bgb_d5m_cr} | | 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 . | [Tableau 1. Analyse des champs de règles] {#t_CreateAParsingRule__table_yry_ptm_cr} 6. Pour tester à nouveau les entrées, cliquez sur Obtenir un exemple de charge utile à partir du test. Cette action rouvre le formulaire de test, ce qui vous permet de remplacer différentes valeurs de test et de créer une charge utile différente. 7. Cliquez sur Enregistrer pour que les règles d'analyse remplacent la charge utile précédente par celle que vous venez de créer. 8. Pour créer une expression pour la règle d'analyse, cliquez sur le paramètre spécifique que vous souhaitez afficher dans l'exemple de charge utile. La valeur de ce paramètre s'affiche dans le champ Résultat de l'analyse et le système crée l'expression appropriée dans le champ Expression . 9. Cliquez sur Soumettre pour enregistrer la règle d'analyse de cette variable. ## Sources d'analyse de Concepteur d'activité {#ariaid-title2} Ce tableau répertorie les sources d'analyse disponibles avec chaque modèle d'exécution. {#r_ActivityDesignerParsingSources__table_wjw_bvm_cr__entry__2} | Modèle | Source | |-|-| | SOAP Web Service | * executionResult.body (par défaut) * executionResult.status_code * executionResult.header * executionResult.error {#r_ActivityDesignerParsingSources__ul_fxx_fvm_cr} | | JDBC | * executionResult.output (par défaut) * executionResult.errorMessages * executionResult.probeCompletedEccId * executionResult.totalRows {#r_ActivityDesignerParsingSources__ul_vnc_h1c_kt} | | Sonde JavaScript | * executionResult.payload (par défaut) * Résultat.sortie d'exécution * executionResult.eccSysId * executionResult.errorMessages {#r_ActivityDesignerParsingSources__ul_qjz_gvm_cr} | | Powershell | * executionResult.output (par défaut) * executionResult.balises * executionResult.hresult * executionResult.eccSysId * executionResult.errorMessages {#r_ActivityDesignerParsingSources__ul_wg2_hvm_cr} | | REST Web Service | * executionResult.body (par défaut) * executionResult.status_code * executionResult.header * executionResult.error {#r_ActivityDesignerParsingSources__ul_ew3_hvm_cr} | | SFTP | * executionResult.output (par défaut) * executionResult.eccSysId * executionResult.errorMessages * executionResult.balises {#r_ActivityDesignerParsingSources__ul_htz_c1c_kt} | | Sonde | * executionResult.output (par défaut) * executionResult.payload * executionResult.eccSysId {#r_ActivityDesignerParsingSources__ul_yc4_hvm_cr} | | SSH | * executionResult.output (par défaut) * executionResult.eccSysId * executionResult.errorMessages * executionResult.balises {#r_ActivityDesignerParsingSources__ul_cjt_hvm_cr} | | JMS | * executionResult.status * executionResult.StandardHeaders * executionResult.customHeaders * executionResult.messagePayload * executionResult.eccSysId * executionResult.errorMessages {#r_ActivityDesignerParsingSources__ul_s4t_tzb_kt} | [Tableau 2. Sources d'analyse] {#r_ActivityDesignerParsingSources__table_wjw_bvm_cr} ## Exemple de règle d'analyse de Concepteur d'activité {#ariaid-title3} 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 Rôle requis : activity_creator, activity_admin ### Pourquoi et quand exécuter cette tâche Pour générer les données d'exemple, 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 exemple dans deux formats : `ipv4` et `ipv6`. Dans cet exemple, le système produit deux expressions à utiliser pour la règle d'analyse. ### Procédure 1. Accédez à la TousWorkflowÉditeur de workflow et ouvrez l'activité qui s'exécute sur l'hôte. 2. Cliquez sur l'onglet Entrées , puis notez la commande. Figure 2. Règle d'analyse, commande d'entrées PowerShell 3. Dans une console PowerShell, exécutez la commande sur l'hôte pour extraire l'exemple XML contenant les valeurs dont vous avez besoin. 4. Copiez les données renvoyées dans le presse-papiers. 5. Dans le concepteur d'activité , cliquez sur l'onglet Sorties et collez les données renvoyées dans le champ Exemple de données de charge utile . Dans cet exemple, les données comprennent les adresses IP dans deux formats différents et le nom de domaine. 6. Sélectionnez le type d'analyse de la source. Dans l'exemple suivant, vous sélectionneriez XML. 7. 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 convertir les données cliquées de l'échantillon en une expression. 8. Pour créer l'expression, cliquez sur les éléments de l'échantillon de données que vous souhaitez mapper à la variable. Sur la base des exemples de données sur lesquels vous avez cliqué, le système crée deux expressions. 9. Sélectionnez une expression dans la liste. Le résultat souhaité est l'adresse IP dont l'attribut de typeest ipv4. Le système renseigne le champ Expression avec ce choix. 10. 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 . 11. 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.