6 CSV-zu-JSON-Vorverarbeitung

Übersicht

In diesem Vorverarbeitungsschritt ist es möglich, CSV-Dateidaten in das JSON-Format zu konvertieren. Dies wird unterstützt in:

  • Datenpunkten (Datenpunkt-Prototypen)
  • Low-Level-Discovery-Regeln

Konfiguration

So konfigurieren Sie einen CSV-zu-JSON-Vorverarbeitungsschritt:

  • Wechseln Sie in der Konfiguration von Datenpunkt/Erkennungsregel zur Registerkarte „Vorverarbeitung“
  • Klicken Sie auf Hinzufügen
  • Wählen Sie die Option CSV zu JSON aus

Mit dem ersten Parameter können Sie ein benutzerdefiniertes Trennzeichen festlegen. Beachten Sie, dass das Zeichen als Trennzeichen verwendet wird, wenn die erste Zeile der CSV-Eingabe mit „Sep=“ beginnt und von einem einzelnen UTF-8-Zeichen gefolgt wird, sofern der erste Parameter nicht festgelegt ist. Wenn der erste Parameter nicht festgelegt ist und kein Trennzeichen aus der „Sep=“-Zeile abgerufen wird, wird ein Komma als Trennzeichen verwendet.

Mit dem zweiten optionalen Parameter können Sie ein Anführungszeichen festlegen.

Wenn das Kontrollkästchen Mit Kopfzeile aktiviert ist, werden die Werte der Kopfzeile als Spaltennamen interpretiert (weitere Informationen finden Sie unter Verarbeitung der CSV-Kopfzeile).

Wenn das Kontrollkästchen Benutzerdefiniert bei Fehler aktiviert ist, wird der Datenpunkt im Falle eines fehlgeschlagenen Vorverarbeitungsschritts nicht nicht unterstützt. Zusätzlich können benutzerdefinierte Optionen für die Fehlerbehandlung festgelegt werden: den Wert verwerfen, einen bestimmten Wert festlegen oder eine bestimmte Fehlermeldung festlegen.

Verarbeitung der Kopfzeile

Die Kopfzeile einer CSV-Datei kann auf zwei verschiedene Arten verarbeitet werden:

  • Wenn das Kontrollkästchen With header row aktiviert ist, werden die Werte der Kopfzeile als Spaltennamen interpretiert. In diesem Fall müssen die Spaltennamen eindeutig sein und die Datenzeile darf nicht mehr Spalten enthalten als die Kopfzeile.
  • Wenn das Kontrollkästchen With header row nicht aktiviert ist, wird die Kopfzeile als Daten interpretiert. Die Spaltennamen werden automatisch generiert (1,2,3,4...).

Beispiel für eine CSV-Datei:

Nr,Item name,Key,Qty
1,active agent item,agent.hostname,33
"2","passive agent item","agent.version","44"
3,"active,passive agent items",agent.ping,55

Ein Anführungszeichen innerhalb eines in Anführungszeichen gesetzten Feldes in der Eingabe muss maskiert werden, indem ein weiteres Anführungszeichen davor gesetzt wird.

Verarbeitung der Kopfzeile

JSON-Ausgabe, wenn eine Kopfzeile erwartet wird:

[
   {
      "Nr":"1",
      "Item name":"active agent item",
      "Key":"agent.hostname",
      "Qty":"33"
   },
   {
      "Nr":"2",
      "Item name":"passive agent item",
      "Key":"agent.version",
      "Qty":"44"
   },
   {
      "Nr":"3",
      "Item name":"active,passive agent items",
      "Key":"agent.ping",
      "Qty":"55"
   }
]

Keine Verarbeitung der Kopfzeile

JSON-Ausgabe, wenn keine Kopfzeile erwartet wird:

[
   {
      "1":"Nr",
      "2":"Item name",
      "3":"Key",
      "4":"Qty"
   },
   {
      "1":"1",
      "2":"active agent item",
      "3":"agent.hostname",
      "4":"33"
   },
   {
      "1":"2",
      "2":"passive agent item",
      "3":"agent.version",
      "4":"44"
   },
   {
      "1":"3",
      "2":"active,passive agent items",
      "3":"agent.ping",
      "4":"55"
   }
]