CSVParser - com escopo

A API CSVParser fornece métodos para analisar registros formatados de valor separado por vírgula (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, caracteres de citação de cadeia de caracteres)

Analisa o conteúdo passado no formato CSV para uma matriz.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
csvLine	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 ','
Caractere de cotação	Cadeia de caracteres	Opcional. Caractere usado como caractere de aspas no conteúdo CSV de origem. Padrão: aspas duplas '"'

Tabela 2. Retorna

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 }

Este exemplo mostra conteúdo simples no formato CSV 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)

Analisa o conteúdo passado no formato CSV para um objeto.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
csvLine	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 ','
Caractere de cotação	Cadeia de caracteres	Opcional. Caractere usado como caractere de aspas no conteúdo CSV de origem. Padrão: aspas duplas '"'

Tabela 4. Retorna

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 }

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 do 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