---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CSVParser - com escopo

# CSVParser - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API CSVParser fornece métodos para analisar registros formatados com valores separados por vírgulas (CSV) em um objeto ou uma matriz.

Esta API é executada no namespace `sn_impex`.

## CSVParser - parseLineToArray(cadeia de caracteres cvsLine, delimitador de cadeia de caracteres, quoteCharacter de cadeia de caracteres) {#ariaid-title2}

Analisa o conteúdo no formato CSV passado para uma matriz.
{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| csvLinha | Cadeia de caracteres | Conteúdo CSV a ser analisado. |
| delimitador | Cadeia de caracteres | Opcional. Caractere usado para delinear os campos no conteúdo CSV de origem. Padrão: vírgula ',' |
| quoteCharacter | Cadeia de caracteres | Opcional. Caractere usado como caractere de aspas no conteúdo CSV de origem. Padrão: aspas duplas '"' |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Matriz | Matriz que contém os valores analisados para cada elemento no conteúdo CSV passado. Por exemplo: { Joe, Smith, 470 W Carmen, Chicago IL, 60640 } |
[Tabela 2. Retorna]

{#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb}  
Este exemplo mostra conteúdo formatado em CSV simples analisado em uma matriz retornada.

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

Saída:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

## CSVParser - parseLineToObject(cadeia de caracteres cvsLine, cabeçalhos de matriz, delimitador de cadeia de caracteres, quoteCharacter de cadeia de caracteres) {#ariaid-title3}

Analisa o conteúdo no formato CSV passado para um objeto.
{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| csvLinha | Cadeia de caracteres | Conteúdo CSV a ser analisado. |
| cabeçalhos | Matriz de cadeia de caracteres | Cabeçalhos associados ao conteúdo CSV. Esses cabeçalhos devem ser especificados na mesma ordem que o conteúdo correspondente em csvLine. Por exemplo, `var headers = ['first_name', 'last_name', 'address'];` |
| delimitador | Cadeia de caracteres | Opcional. Caractere usado para delinear os campos no conteúdo CSV de origem. Padrão: vírgula ',' |
| quoteCharacter | Cadeia de caracteres | Opcional. Caractere usado como caractere de aspas no conteúdo CSV de origem. Padrão: aspas duplas '"' |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Objeto | Objeto que contém o cabeçalho e o valor correspondente para cada elemento no conteúdo CSV passado. Por exemplo: { first_name: Joe, last_name: Smith, address: 1470 W Carmen, Chicago IL, 60640 } |
[Tabela 4. Retorna]

{#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb}  
Este exemplo mostra o conteúdo no formato CSV analisado em um objeto retornado.

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

Saída:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

Este exemplo mostra uma resposta de exceção devido a uma passagem inválida do parâmetro de cabeçalho.

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

Saída:

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