Histórico da Página
...
Exportar os dados contidos em uma variável ARRAY OF RECORD para uma planilha no formato CSV, onde os dados são exportados linha a linha e suas informações ficam separadas por ";" (ponto vírgula) em cada linha do arquivo.
Informações | ||
---|---|---|
| ||
A extensão do arquivo de saída será .CSV no formato que pode ser aberto para visualização com ferramenta Excel ou outra ferramenta de edição/visualização de planilhas neste formato CSV. |
Informações | ||
---|---|---|
| ||
ATENÇÃO! O formato CSV pode apresentar problemas para valores numéricos que contenham valores decimais, pois o separador de casas decimais será vírgula ou ponto, conforme estiver configurado a variável de ambiente DBMONEY para o AppServer. |
Sintaxe
...
Bloco de código |
---|
_ADVPL_ExportArrayToExcelCSV( < u4GLRec >, < cCSVFilePath >, < cColumns >, < nRowsCount > ) |
Parâmetros
...
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
u4GLRec |
| Sim | Variável 4GL do tipo ARRAY OF RECORD que contém os dados a serem exportados. |
cCSVFilePath |
| Não | Caminho completo do arquivo a ser gravado no servidor. Se for enviado nome de arquivo sem extensão, irá assumir extensão ".csv". Se não for enviado um caminho de diretório, o valor do parâmetro deverá ser NULL. Neste caso a função irá considerar automaticamente a pasta de destino como uma pasta temporária do AppServer. Se for informado um caminho de diretório inválido ou não existente no servidor, a função será interrompida, retornando valor NULL, indicando que houve algum problema na extração dos dados. |
cColumns |
| Não | Lista com o nome dos elementos do array de record 4GL que deverão ser exportados. Informe NULL para considerar exportação de todos os elementos definidos no array de record.
nomecoluna1|nomecoluna2
NULL |
nRowsCount |
| Não | Número de linhas a serem exportadas do array, considerando sempre a linha inicial como 1. Quando não informado será considerado todas as linhas. |
Retorno
...
Nome | Tipo | Descrição |
---|---|---|
cCSVFilePath |
| Caminho completo do arquivo com formato CSV gerado no servidor. Caso tenha ocorrido qualquer tipo de erro durante a geração do arquivo ou extração dos dados do array, o retorno desta função será NULL. |
...