CSVParser : Bereichsbezogen

Die CSVParser- API bietet Methoden zum Analysieren von CSV-Datensätzen (Comma-Separated Value) in einem Objekt oder Array.

Diese API wird im Namespace sn_impex ausgeführt.

CSVParser - parseLineToArray(String cvsLine, String delimiter, String QuoteCharacter)

Analysiert übergebene CSV-formatierte Inhalte in einem Array.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
csvLine	Zeichenfolge	Zu analysierender CSV-Inhalt.
Trennzeichen	Zeichenfolge	Optional. Zeichen, das zur Abgrenzung der Felder im CSV-Quellinhalt verwendet wird. Standard: Komma „,“
QuoteCharacter	Zeichenfolge	Optional. Zeichen, das als Anführungszeichen im CSV-Quellinhalt verwendet wird. Standard: Doppeltes Anführungszeichen „“

Tabelle : 2. Rückgaben

Typ	Beschreibung
Array	Array, das die analysierten Werte für jedes Element im übergebenen CSV-Inhalt enthält. Zum Beispiel: { Joe, Smith, 470 W Carmen, Chicago IL, 60640 }

In diesem Beispiel wird einfacher CSV-formatierter Inhalt in einem zurückgegebenen Array analysiert.

var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
var delimiter = ',';
var quoteCharacter = '"';

var x = new sn_impex.CSVParser().parseLineToArray(csvLine, delimiter, quoteCharacter);

gs.log(x[0]);
gs.log(x[1]);
gs.log(x[2]);

Ausgabe:

Joe
Smith
1470 W Carmen, Chicago IL, 60640

CSVParser - parseLineToObject(String cvsLine, Array headers, String delimiter, String QuoteCharacter)

Analysiert übergebene CSV-formatierte Inhalte in ein Objekt.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
csvLine	Zeichenfolge	Zu analysierender CSV-Inhalt.
headers	Array aus Zeichenfolgen	Header, die dem CSV-Inhalt zugeordnet sind. Diese Header müssen in der gleichen Reihenfolge wie der entsprechende Inhalt in csvLineangegeben werden. Beispiel: var headers = ['first_name', 'last_name', 'address'];
Trennzeichen	Zeichenfolge	Optional. Zeichen, das zur Abgrenzung der Felder im CSV-Quellinhalt verwendet wird. Standard: Komma „,“
QuoteCharacter	Zeichenfolge	Optional. Zeichen, das als Anführungszeichen im CSV-Quellinhalt verwendet wird. Standard: Doppeltes Anführungszeichen „“

Tabelle : 4. Rückgaben

Typ	Beschreibung
Objekt	Objekt, das den Header und den entsprechenden Wert für jedes Element im übergebenen CSV-Inhalt enthält. Zum Beispiel: { first_name: Joe, last_name: Smith, address: 1470 W Carmen, Chicago IL, 60640 }

In diesem Beispiel wird CSV-formatierter Inhalt in einem zurückgegebenen Objekt analysiert.

var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
var headers = ['first_name', 'last_name', 'address'];
var delimiter = ',';
var quoteCharacter = '"';

var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);

gs.log(x.first_name);
gs.log(x.last_name);
gs.log(x.address);

Ausgabe:

Joe
Smith
1470 W Carmen, Chicago IL, 60640

Dieses Beispiel zeigt eine Ausnahmeantwort aufgrund einer ungültigen Übergabe des Headerparameters.

var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
var headers = null;
var delimiter = ',';
var quoteCharacter = '"';
try {
var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);

gs.log(x.first_name);
gs.log(x.last_name);
gs.log(x.address);
}
catch(ex) {
      gs.info(ex.message);
}

Ausgabe:

CSVParser: Header list is empty: no thrown error
*** Script: CSVParser: Header list is empty