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 Vorverarbeitungsschritt für CSV zu JSON:

  • Gehen Sie zur Registerkarte Vorverarbeitung in der Konfiguration von Datenpunkt/Discovery-Regel
  • Klicken Sie auf Hinzufügen
  • Wählen Sie die Option CSV zu JSON

Mit dem ersten Parameter kann ein benutzerdefiniertes Trennzeichen festgelegt werden. Beachten Sie, dass, wenn die erste Zeile der CSV-Eingabe mit „Sep=“ beginnt und darauf ein einzelnes UTF-8-Zeichen folgt, dieses Zeichen als Trennzeichen verwendet wird, falls der erste Parameter nicht gesetzt ist. Wenn der erste Parameter nicht gesetzt ist und kein Trennzeichen aus der Zeile „Sep=“ ermittelt wird, wird ein Komma als Trennzeichen verwendet.

Mit dem zweiten optionalen Parameter kann ein Anführungszeichen festgelegt werden.

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

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

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"
   }
]