---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CSVParser - Dans le champ d'application

# CSVParser - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API CSVParser fournit des méthodes d'analyse des enregistrements au format CSV (valeurs séparées par des virgules) en un objet ou un tableau.

Cette API s'exécute dans l'espace `de noms sn_impex` .

## CSVParser : parseLineToArray(String cvsLine, String delimiter, String quoteCharacter) {#ariaid-title2}

Analyse le contenu transmis au format CSV dans un tableau.
{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb__entry__3}

| Nom | Type | Description |
|-|-|-|
| csvLine | Chaîne | Contenu CSV à analyser. |
| délimiteur | Chaîne | Facultatif. Caractère utilisé pour délimiter les champs dans le contenu CSV source. Par défaut : virgule \<\< , \>\> |
| Caractère de citation | Chaîne | Facultatif. Caractère utilisé comme guillemet dans le contenu CSV source. Par défaut : guillemet double '"' |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau contenant les valeurs analysées pour chaque élément du contenu CSV transmis. Par exemple : { Joe, Smith, 470 W Carmen, Chicago IL, 60640 } |
[Tableau 2. Renvoie]

{#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb}  
Cet exemple montre un contenu simple au format CSV analysé dans un tableau retourné.

    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]);

Sortie :

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

## CSVParser : parseLineToObject(String cvsLine, En-têtes de tableau, Délimiteur de chaîne, String quoteCharacter) {#ariaid-title3}

Analyse le contenu transmis au format CSV dans un objet.
{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb__entry__3}

| Nom | Type | Description |
|-|-|-|
| csvLine | Chaîne | Contenu CSV à analyser. |
| en-têtes | Tableau de chaînes | En-têtes associés au contenu CSV. Ces en-têtes doivent être spécifiés dans le même ordre que le contenu correspondant dans csvLine. Par exemple, `var headers = ['first_name', 'last_name', 'address'] ;` |
| délimiteur | Chaîne | Facultatif. Caractère utilisé pour délimiter les champs dans le contenu CSV source. Par défaut : virgule \<\< , \>\> |
| Caractère de citation | Chaîne | Facultatif. Caractère utilisé comme guillemet dans le contenu CSV source. Par défaut : guillemet double '"' |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Objet contenant l'en-tête et la valeur correspondante de chaque élément du contenu CSV transmis. Par exemple : { first_name: Joe, last_name: Smith, address: 1470 W Carmen, Chicago IL, 60640 } |
[Tableau 4. Renvoie]

{#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb}  
Cet exemple montre du contenu au format CSV analysé dans un objet retourné.

    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);

Sortie :

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

Cet exemple montre une réponse d'exception en raison d'une réussite non valide du paramètre d'en-tête.

    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);
    }

Sortie :

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