--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications 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: Xanadu * * Mis à jour 1 août 2024 * * ![](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 ToutWorkflowÉditeur de workflow. 2. Depuis l'onglet Personnalisé de la palette, ouvrez une activité personnalisée. 3. Dans le formulaire du 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 renseigne 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/f~2LcS_ZTX6IwV3tWKLd1Q#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 à 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 dans la charge utile à analyser. {#t_CreateAParsingRule__table_yry_ptm_cr__entry__2} | Champ | Description | |-|-| | Source de l'analyse | Source des données renvoyées à partir de l'hôte ou du point de terminaison cible. Chaque modèle s'ouvre sur une charge utile spécifique par défaut. 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 été préalablement définie pour elles. Pour obtenir la liste des charges utiles disponibles pour chaque modèle, reportez-vous à la section [Sources d'analyse du concepteur d'activité](https://servicenow-prod.fluidtopics.net/f~2LcS_ZTX6IwV3tWKLd1Q#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 du test, 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 de données d'échantillon. 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 : requête JSONPath permettant de 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. {#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 | Exemple 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 modifiable à nouveau. | | Analyse des résultats | 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. Champs des règles d'analyse] {#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 apparaît dans le champ Résultat d'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 du 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.en-tête * 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) * executionResult.output * executionResult.eccSysId * executionResult.errorMessages {#r_ActivityDesignerParsingSources__ul_qjz_gvm_cr} | | Powershell | * executionResult.output (par défaut) * executionResult.tags * executionResult.hresult * executionResult.eccSysId * executionResult.errorMessages {#r_ActivityDesignerParsingSources__ul_wg2_hvm_cr} | | REST Web Service | * executionResult.body (par défaut) * executionResult.status_code * executionResult.en-tête * executionResult.error {#r_ActivityDesignerParsingSources__ul_ew3_hvm_cr} | | SFTP | * executionResult.output (par défaut) * executionResult.eccSysId * executionResult.errorMessages * executionResult.tags {#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.tags {#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 du 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 provenant 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 l'exemple de données, l'administrateur doit exécuter la commande sur l'hôte, puis coller les données renvoyées dans le champ de données 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 ToutWorkflowÉditeur de workflow et ouvrez l'activité qui s'exécute sur l'hôte. 2. Cliquez sur l'onglet Entrées et notez la commande. Figure 2. Règle d'analyse Commande des entrées PowerShell 3. Dans une console PowerShell, exécutez la commande sur l'hôte pour extraire l'exemple XML qui contient 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 de données Exemple de charge utile . Dans cet exemple, les données incluent 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 devez sélectionner 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. En fonction 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 de résultat d'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.