CSVParser - Com escopo

. CSVParser A API fornece métodos para analisar registros formatados em CSV (Comma-Separated Value, valor separado por vírgulas) em um objeto ou uma matriz.

Esta API é executada no sn_impex namespace.

CSVParser - parseLineToArray (cadeia de caracteres cvsLine, delimitador de cadeia de caracteres, cadeia de caracteres quoteCharacter)

Analisa conteúdo passado em formato CSV em 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 delimitar os campos no conteúdo CSV de origem. Padrão: Vírgula ','
QuoteCaracter	Cadeia de caracteres	Opcional. Caractere usado como caractere de citação no conteúdo CSV de origem. Padrão: Aspas duplas '"'

Tabela 2. Retornos

Tipo	Descrição
Matriz	Matriz que contém os valores analisados para cada elemento no conteúdo CSV transmitido. 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, cadeia de caracteres quoteCharacter)

Analisa conteúdo passado em 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 do conteúdo correspondente em csvLine. Por exemplo, ['first_name', 'last_name', 'address'];
delimitador	Cadeia de caracteres	Opcional. Caractere usado para delimitar os campos no conteúdo CSV de origem. Padrão: Vírgula ','
QuoteCaracter	Cadeia de caracteres	Opcional. Caractere usado como caractere de citação no conteúdo CSV de origem. Padrão: Aspas duplas '"'

Tabela 4. Retornos

Tipo	Descrição
Objeto	Objeto que contém o cabeçalho e o valor correspondente para cada elemento no conteúdo CSV transmitido. 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 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