---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CSVParser -- Umfang

# CSVParser -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die CSVParser Die API bietet Methoden zum Analysieren von CSV-formatierten Datensätzen (kommagetrennte Werte) in einem Objekt oder Array.

Diese API wird in ausgeführt `sn_impex `Namespace.

## CSVParser -- parseLineToArray(Zeichenfolge cvsLine, Zeichenfolgentrennzeichen, Zeichenfolgenanführungszeichen) {#ariaid-title2}

Analysiert in CSV-formatiertem Inhalt an ein Array übergeben.
{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| CsvLine | Zeichenfolge | Zu analysierender CSV-Inhalt. |
| Trennzeichen | Zeichenfolge | Optional. Zeichen, das zum Abgrenzen 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 : 1. Parameter]

{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb} {#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb__entry__2}

| 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 } |
[Tabelle : 2. Rückgaben]

{#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb}  
Dieses Beispiel zeigt einfachen CSV-formatierten Inhalt, der in einem zurückgegebenen 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(Zeichenfolge cvsLine, Array-Header, Zeichenfolgentrennzeichen, Zeichenfolgenanführungszeichen) {#ariaid-title3}

Analysiert übergebene Inhalte im CSV-Format an ein Objekt.
{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb__entry__3}

| 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 derselben Reihenfolge wie der entsprechende Inhalt in angegeben werden csvLine. Beispiel: `VAR-Header = ['first_Name', 'Last_Name', 'address']; ` |
| Trennzeichen | Zeichenfolge | Optional. Zeichen, das zum Abgrenzen 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 : 3. Parameter]

{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb} {#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb__entry__2}

| 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 } |
[Tabelle : 4. Rückgaben]

{#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb}  
Dieses Beispiel zeigt CSV-formatierten Inhalt, der in einem zurückgegebenen 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 Ausnahmenantwort 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


