Analyser la sortie de la commande

Dans le cadre de la création ou de la modification d'un modèle de détection, vous pouvez utiliser l'opération Analyser la sortie de la commande pour extraire des informations de la sortie de la commande et enregistrer le résultat de l'opération dans une variable. Vous pouvez également enregistrer l'intégralité de la sortie de la commande sous forme de variable.

Avant de commencer

Rôle requis : pd_admin

Accédez à l'étape de modèle pertinente :

1. Sur le formulaire de modèle, sélectionnez la section d'identification pertinente pour Détection.

   Vous pouvez également sélectionner la section d'identification ou de connexion pertinente pour Mappage des services.

2. Sélectionnez l'étape de modèle pertinente ou cliquez sur le bouton pour ajouter une étape.

Une connaissance de base de la programmation est souhaitée.

Procédure

1. Sélectionnez Analyser la sortie de la commande dans la liste Opération.
2. Spécifiez la commande dans Définir les détails de la commande.
   Vous pouvez utiliser des variables. Vous pouvez également saisir une valeur du champ spécifique dans une variable tabulaire, comme décrit dans Saisir des valeurs et des variables dans les modèles.

   Vous pouvez concaténer plusieurs commandes.

   Important :

   Évitez d'entrer un chemin spécifique vers un emplacement ou un fichier, car il peut être différent sur différents systèmes d'exploitation. Vous devez utiliser des variables pour les chemins d'accès.

   Pour faire en sorte que la Now Platform applique les informations d'identification applicatives lors de l'exécution de cette commande, utilisez les espaces réservés aux informations d'identification à l'aide de la syntaxe suivante :

   • $$username$$ : pour le nom d'utilisateur
   • $$password$$ : pour le mot de passe

   Par exemple, une commande d'analyse pour un serveur Microsoft SQL Server utilise des espaces réservés pour les informations d'identification : "su - " + $userid + " -c '" + $ExecutableDir + "mysql --user=" + "$$username$$" + " --password=" + "$$password$$"
3. Pour changer le mode d'exécution ou les informations d'identification, cliquez sur Avancé et renseignez les champs comme il convient.

   Champ	Description
   Mode d'exécution	Sélectionnez l'option pertinente pour l'exécution de cette commande : Par défaut (distant) : sur l'appareil distant Script local : sur le Serveur MID Service Windows : sur le service en cours d'exécution sur le serveur Windows distant
   Type de CI	Saisissez le nom du type de CI dont vous souhaitez utiliser les informations d'identification applicatives pour cette étape. Le système utilise des informations d'identification applicatives pour le type de CI défini, différent du type de CI, que ce modèle détecte. Par exemple, lors de la détection du serveur Microsoft SQL Server, vous pouvez basculer vers les informations d'identification applicatives de l'instance Microsoft SQL. S'il existe plusieurs informations d'identification applicatives pour le type de CI sélectionné, le système utilise les informations d'identification applicatives en fonction de leur paramètre Order. Pour plus d'informations sur la configuration des informations d'identification applicatives, consultez la rubrique Informations d'identification applicatives.

4. Pour enregistrer l'intégralité de la sortie de la commande sous forme de variable, sélectionnez AUCUN dans la liste Définir l'analyse et définissez la variable comme décrit dans 7.
5. Sélectionnez la stratégie d'analyse dans la liste Définir l'analyse.

   Stratégie d'analyse	Description
   Oracle Fichier LDAP Fichier XML Fichier INI Fichier de propriétés Fichier JSON (personnalisé)	Stratégie d'analyse horizontale du fichier (pas verticale). Vous pouvez utiliser cette stratégie d'analyse uniquement pour les fichiers texte. Pour en savoir plus, consultez Analyser du texte à partir d'un fichier horizontal.
   Fichier vertical	Récupérez le texte à partir d'un fichier texte structuré où chaque ensemble de données s'étend sur plusieurs lignes. Pour en savoir plus, consultez Analyser du texte à partir d'un fichier vertical.
   Après le mot clé	Récupérez le texte directement en suivant un mot clé spécifique. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
   Style de ligne de commande Java	Récupérez la valeur d'un paramètre de ligne de commande à l'aide des paramètres de style Java. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
   Style de ligne de commande Unix	Récupérez la valeur d'un paramètre de ligne de commande à l'aide des paramètres Unix standard. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
   Position à partir de la fin	Récupérez le texte spécifié par sa position à partir de la fin de la ligne. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
   Position à partir du début	Récupérez le texte spécifié par sa position à partir du début de la ligne. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
   Expression régulière	Récupérez le texte spécifié par une expression régulière. Cette option nécessite de connaître la syntaxe Regex Java. Pour en savoir plus, consultez Analyser du texte à l'aide d'une expression régulière.
   Texte délimité	Récupérez le texte spécifié par les délimiteurs et la position dans la ligne (la manière la plus courante de récupérer le texte à partir des fichiers texte génériques). Voir Analyser du texte à l'aide d'un texte délimité.

6. Si vous travaillez avec le mode Déboguer, effectuez les étapes suivantes :
   1. Cliquez sur Exécuter la commande pour afficher le résultat dans le volet Sortie.
   2. Dans le panneau Sortie, marquez le texte ou les symboles que vous souhaitez que la variable contienne.
   3. Dans la zone de nom de la variable, saisissez le nom de la nouvelle variable, par exemple « process_name ».
      
      
      
   4. Appuyez sur Entrée.
      La nouvelle variable est ajoutée dans le panneau Variables.
7. Si vous ne travaillez pas en mode de débogage, effectuez les étapes suivantes pour définir les critères d'analyse comme suit.
   1. Dans le panneau Variables, cliquez sur Ajouter une variable, puis saisissez le nom de la nouvelle variable.
   2. Cliquez sur l'icône Avancé.
      
      
      
   3. Cliquez sur Ajouter une étiquette de colonne.
   4. Entrez la requête d'analyse.
   5. Entrez une valeur pour le délimiteur.
   6. Entrez une valeur pour la position.
8. Sélectionnez Utiliser le cache pour enregistrer les résultats de l'opération dans le Serveur MID.
   Utilisez le cache pour optimiser la détection et éviter de créer une charge inutile sur les composants partagés centraux, tels que les équilibreurs de charge. Le système de base conserve les résultats de l'opération en cache pendant une heure.
9. Sélectionnez Terminer pour arrêter la détection si aucun résultat n'est trouvé.
10. Si vous êtes en mode de débogage, testez l'étape en cliquant sur Test et en vérifiant que l'opération renvoie le résultat attendu.

Exemple

Dans cet exemple, le script d'analyseur Tibco contenu dans la variable $TibcoParser s'exécute sur l'hôte cible. La méthode d'analyse est un texte délimité avec le délimiteur « = ». Le résultat de l'analyse est le chemin d'accès au répertoire contenant tous les fichiers de configuration pour Tibco Business Works et Tibco Business Works Process. Cette étape crée une variable temporaire pour héberger le résultat de l'analyse.

Que faire ensuite

• Continuez à modifier le modèle en ajoutant une nouvelle étape et en définissant son fonctionnement.
• Finalisez le modèle.

Tâches associées

• Activer le mode Déboguer du modèle
• Rendre une étape conditionnelle

Référence associée

• Saisir des valeurs et des variables dans les modèles
• Variables de modèle