CSVParser – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Die CSVParser -API stellt Methoden zum Analysieren von CSV-formatierten Datensätzen (Comma Separated Value) in einem Objekt oder Array bereit.

    Diese API wird im Namespace sn_impex ausgeführt.

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

    Analysiert in CSV-formatierten Inhalten übergebene Inhalte in einem Array.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    csvLine Zeichenfolge Zu analysierender CSV-Inhalt.
    Trennzeichen Zeichenfolge Optional. Zeichen, das zum Begrenzen der Felder im CSV-Quellinhalt verwendet wird.

    Standard: Komma ','

    QuoteCharacter Zeichenfolge Optional. Zeichen, das im Quell-CSV-Inhalt als Anführungszeichen verwendet wird.

    Standard: Doppelte Anführungszeichen „“

    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Array Array mit den analysierten Werten für jedes Element im übergebenen CSV-Inhalt.

    Beispiel:

    {
    Joe,
    Smith,
    470 W Carmen, Chicago IL, 60640
    }

    Dieses Beispiel zeigt einfachen CSV-formatierten Inhalt, der in ein zurückgegebenes Array analysiert wird.

    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 in CSV-formatierten Inhalten übergebene 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 Kopfzeilen müssen in derselben Reihenfolge wie der entsprechende Inhalt in csvLineangegeben werden. Beispiel: var headers = ['first_name', 'last_name', 'address'];
    Trennzeichen Zeichenfolge Optional. Zeichen, das zum Begrenzen der Felder im CSV-Quellinhalt verwendet wird.

    Standard: Komma ','

    QuoteCharacter Zeichenfolge Optional. Zeichen, das im Quell-CSV-Inhalt als Anführungszeichen verwendet wird.

    Standard: Doppelte Anführungszeichen „“

    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Objekt Objekt, das die Kopfzeile und den entsprechenden Wert für jedes Element im übergebenen CSV-Inhalt enthält.

    Beispiel:

    {
    first_name: Joe,
    last_name: Smith,
    address: 1470 W Carmen, Chicago IL, 60640
    }

    Dieses Beispiel zeigt CSV-formatierten Inhalt, der in ein zurückgegebenes Objekt analysiert wird.

    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 Header-Parameters.

    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