CSV-zu-JSON-Vorverarbeitung

Übersicht

In diesem Vorverarbeitungsschritt können Daten aus CSV-Dateien in das JSON-Format konvertiert werden. Dies wird unterstützt in:

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

Konfiguration

So konfigurieren Sie einen CSV-zu-JSON-Schritt der Vorverarbeitung:

  1. Wechseln Sie in der Konfiguration des Datenpunkts/der Ermittlungsregel zur Registerkarte Vorverarbeitung.
  2. Klicken Sie auf Hinzufügen.
  3. 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 darauf ein einzelnes UTF-8-Zeichen folgt, 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 Fall 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"
   }
]