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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CSVParser: Bereichsbezogen

# CSVParser: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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) {#ariaid-title2}

Analysiert übergebene CSV-formatierte Inhalte in einem Array.
{#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 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 : 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. Beispiel: { Joe, Smith, 470 W Carmen, Chicago IL, 60640 } |
[Tabelle : 2. Ergebnisse]

{#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb}  
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) {#ariaid-title3}

Analysiert übergebene CSV-formatierte Inhalte in 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 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 : 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. Beispiel: { first_name: Joe, last_name: Smith, address: 1470 W Carmen, Chicago IL, 60640 } |
[Tabelle : 4. Ergebnisse]

{#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb}  
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