Exemple de sonde et de capteur de découverte personnalisés : renseigner un CI avec des valeurs de fichier texte

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture
  • Cette sonde personnalisée Découverte vous aide si vous devez lire un fichier texte à partir d’un Windows ordinateur et renseigner un CI dans la CMDB avec les valeurs du fichier.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Dans cet exemple, l’utilisateur voulait lire les fichiers créés par BGinfo.
    Remarque :
    Lorsque vous avez terminé la sonde et le capteur, placez la sonde dans le classifieur Windows approprié à l’adresse Définition de découverte > Classification CI > Windows.

    Procédure

    1. Accédez à la Définition de découverte > Probes, puis cliquez sur Nouveau.
    2. Renseignez les champs suivants :
      • Nom : nom unique et descriptif de la sonde
      • Type de sonde : sélectionnez Sonde.
      • Description : décrivez la fonction de cette sonde.
      • Utilisé par la découverte : cochez cette case
      • Rubrique de file d’attente ECC : il s’agit du nom de la sonde que le serveur MID doit exécuter. Dans cet exemple, nous utilisons WMIRunner.
      • Nom de file d’attente ECC : dans cet exemple, nous utilisons le nom descriptif WMI : fichiers BGInfo.
    3. Cliquez avec le bouton droit dans la barre d’en-tête et sélectionnez Enregistrer dans le menu contextuel.
    4. Sélectionnez l’onglet Paramètres de sonde dans le formulaire Sonde, puis cliquez sur Nouveau.
    5. Entrez WMI_GetFiles.js comme nom de ce paramètre.
    6. Copiez le script ci-dessous dans le champ Script et modifiez-le si nécessaire.
    7. Cliquez sur Envoyer.
      
      //
       // Use ServiceNow WMIAPI to gather stats
       //
       var CMD_RETRIES = 3;
       var scanner = getScanner();
       if (scanner) {
         var output = "";
         for(var i = 0; i < CMD_RETRIES; i++) {
            output = scanner.winExec("%SystemRoot%\\system32\\cmd.exe /C type \\\"C:\\Information Systems\\BgInfo\\*.txt\\\"");
            if (output)
               break;
         }
         scanner.appendToRoot("output", output);
       }
    8. Accédez à la Définition de découverte > Capteurs, puis cliquez sur Nouveau.
      Renseignez les champs suivants :
      • Nom : utilisez le même nom que la sonde correspondante. Dans cet exemple, nous utilisons Windows - Get BGInfo files.
      • Réagit à la sonde : nom de la sonde créée lors de la procédure précédente : Windows : obtenir les fichiers BGInfo
      • Type de capteur : sélectionnez le type de capteur à créer, dans cet exemple de capteur.
      • Description : décrit la fonction de ce capteur.
      • Script : copiez le script ci-dessous dans le champ Script et modifiez-le si nécessaire.
      • Type de capteur : détermine comment la réponse de la sonde est traitée, dans cet exemple JavaScript.
    9. Cliquez sur Envoyer.
       
       
      new DiscoverySensor({ data: {}, process: function(result) { 
       
              this.parseOutput(result.output);
              this.update(this.data);
          },
       
       parseOutput: function(output) {
              var currentFile;
              var files = {};
       
       if (output.startsWith("<wmi")) {
                  var bgout = new XMLHelper(output).toObject();
                  if (!bgout)
                      return;
       
       output = bgout.output;
              }
       
       var lines = output.split(/\n/);
       
       for(var i = 0; i < lines.length; i++) {
                  var line = lines[i];
                  if (line.startsWith("C:\\Information Systems\\BgInfo\\")) {
                      currentFile = line.substr(30);
                      files[currentFile] = "";
                  } else if (currentFile) {
                      var newLine = line.trim();
                      if (newLine)
                          files[currentFile] += (files[currentFile]? "\n " : "") + newLine;
                  }
              }
       
       this.data['u_jack_id'] = files['JackID.txt'];
       this.data['warranty_expiration'] = files['Warranty.txt'];
       this.data['po_number'] = files['Ponum.txt'];},
       type: "DiscoverySensor"
       
       });