Analyse von CSV-Dateien in CDM

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Der CSV-Parser CDM ermöglicht die Analyse von Daten in CSV-Dateien. Wenn Sie also Konfigurationsdaten aus einer CSV-Datei (Comma-Separated Value) in CDMhochladen, können Sie die Datenformatattribute und Konfigurationsdaten im Editor CDM oder einfach identifizieren Listenansicht.

    Wichtig:
    Ab Release Washington DC wird DevOps Config auf seine künftige Stilllegung vorbereitet. Es wird ausgeblendet und in neuen Instanzen nicht mehr installiert, aber weiterhin unterstützt. Weitere Informationen finden Sie im Artikel Deprecation Process [KB0867184] (Abkündigungsprozess) in der Now Support Knowledge Base.
    Der CSV-Parser CDM entspricht dem CSV-Standard RFC 4180. Diese Analyse von Daten aus einer CSV-Datei in einem JSON-Format in CDM hilft Ihnen auf folgende Weise:
    • Vorhandene Konfigurationsdaten werden aus einer CSV-Datei mit anwenderdefinierten Header- und Trennzeichen-Attributen hochgeladen, um sie als entsprechende Schlüssel-Wert-Paare in JSON zu analysieren.
    • Datenformatattribute (Metadaten) von den Konfigurationsdatenelementen (Daten) im Editor CDM unterscheiden.
    • Importierte CSV-Daten in CDM werden für die Bereitstellung validiert.
    • Konfigurationsdaten werden aus dem JSON-Format in das CSV-Format mit Attributen im ursprünglichen Format konvertiert.

    Analyse von CSV in JSON während des Imports

    Wenn Sie eine CSV-Datei in CDMimportieren, konvertiert der Parser die Daten im CSV-Format wie folgt in das JSON-Format:
    • Fügt jeden Datensatz aus der CSV-Datei als CDI in separaten indizierten Knoten unter dem Knoten data im JSON-Format hinzu.
    • Fügt die Datenformatattribute hinzu, die während des CSV-Uploads unter dem Knoten metadata verwendet werden.

      Der Abfrageparameter dataFormatAttributes enthält Attribute zur Bestimmung des Trennzeichens, der Header, der ersten Zeile als Header und der gesicherten Header.

      Tabelle : 1. Attribute für den CDM-CSV-Parser
      Attributname Beschreibung
      Trennzeichen Zeichen, um jedes Headerfeld als Schlüssel und das Datensatzfeld als Wert einer CDI zu trennen. Sie können ein gültiges Zeichen als Trennzeichen angeben.

      Standard: „Trennzeichen“: ",".

      enthältHeader Option, um zu bestimmen, ob die erste Zeile in der CSV-Datei als Header-Zeile betrachtet wird. Dieses Attribut ist optional.
      • „wahr“: Die CSV-Datei enthält die erste Zeile als Header.
      • „falsch“: Die CSV-Datei enthält nicht die erste Zeile als Header. In diesem Fall müssen Sie die Header im Attribut headers angeben.

      Standard: „containsHeader“: „wahr“.

      headers Liste der Headerfelder für Datensatzfelder in der CSV-Datei. Diese Header werden in die Schlüsselnamen der CDIs im JSON-Format konvertiert.
      Hinweis:
      Dieses Attribut ist nur anwendbar, wenn das Attribut containsHeader auf falsefestgelegt ist.

      Wenn Ihre CSV-Datei nicht die erste Zeile mit Headern enthält, können Sie ein Array von Headern angeben. Die Anzahl der Header muss mit der Anzahl der Datensatzfelder übereinstimmen. Beispiel: "headers": ["FirstName","LastName","Location","Salary"].

      Standard: Ein leeres Array: "headers": [].

      GesicherteHeader Liste der Headerfelder, für die der Wert für alle Datensätze im verschlüsselten Format im JSON-Format angezeigt wird. Dieses Attribut ist optional.

      Sie können ein Array von Headern angeben, die gesichert werden müssen. Der Name der gesicherten Header muss mit dem Namen der Header im Header -Attribut oder in der CSV-Datei übereinstimmen. Beispiel: "secureHeaders":["Salary"].

      Standard: Ein leeres Array: "secureHeaders": [].

    Konvertierung des CSV- in das JSON-Format

    Dieses Beispiel zeigt die angegebenen Datenformatattribute und die Konvertierung von CSV-Inhalten in das JSON-Format basierend auf diesen Attributen.
    Datenformatattribute
    Hinweis:
    Dieser Parameter ist optional. Wenn Sie keine Werte angeben, werden die Standardwerte der Attribute verwendet.

    { "delimiter": ",", "containsHeader": "true", "headers": [], "secureHeaders": ["salary"] }

    CSV-Format
    //Sample CSV file content: no header in the first row; each line represents a record 
      FirstName,LastName,Location,Salary
      David,Ben,NYC,1000
      Jakes D,Ron,IRE,1220
      "George, R",Martin,US,12120
      "Antony, ""Ron",Mak,US,1210
    JSON-Format
    
    //data node for the records from CSV - each record row converted to individual nodes with fields separated by delimiter character converted to individual items of the node{
    	"data": {   
    		"0": {
    			"FirstName": "David",
    			"LastName": "Ben",
    			"Location": "NYC",
    			"Salary": "*****"
    		},
    		"1": {
    			"FirstName": "Jakes D",
    			"LastName": "Ron",
    			"Location": "IRE",
    			"Salary": "*****"
    		},
    		"2": {
    			"FirstName": "George, R",  //the name has a delimiter char so the full name is enclosed within " "
    			"LastName": "Martin",
    			"Location": "US",
    			"Salary": "******"
    		},
    		"3": {
    			"FirstName": "Antony, \"Ron", //the last name has "" so a \ is added to include " in the last name
    			"LastName": "Mak",
    			"Location": "US",
    			"Salary": "*****"
    		}
    	},
    //metadata added for the data format attributes
    	"metadata": {   
    		"containsHeader": "true",
    		"delimiter": ",",
    		"headers": "FirstName�LastName�Location�salary",
    		"securedHeaders": "Salary"
    	}
    }

    Analyse von JSON in CSV während des Exports

    Damit die CSV-Konfigurationsdaten beim Exportieren der Konfigurationsdaten in ein CSV-Dateiformat in ihrem ursprünglichen Format beibehalten werden, stellen Sie sicher, dass Ihre Daten die Knoten data und metadata enthalten.
    • Konfigurationsdatenelemente innerhalb des Knotens data werden in einzelne Datensatzzeilen in der CSV-Datei konvertiert.
    • Datenformatattribute innerhalb des Knotens metadata werden verwendet, um die Informationen für Trennzeichen, Header und geheimen Header in der CSV-Datei zu definieren.