file.parse

Ler ficheiro

Lê um ficheiro anexado (CSV, Excel ou JSON) e converte-o em registos.

• Kind: step
• Key: file.parse
• Categoria: source
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
parser	enumeration	não	"csv"	Que leitor usar. Um valor fora do trio é recusado em autoria e falha em execução - nunca se lê um livro binário como CSV.	-
delimiter	string	não	","	Só CSV: separador dos campos, UM carácter (, ; tab). Mais do que um nunca casava e o ficheiro virava uma coluna só.	-
hasHeader	boolean	não	true	CSV e Excel: a primeira linha dá os nomes dos campos; senão chamam-se col1, col2, …	-
sheet	string	não	""	Só Excel: nome da folha a ler. Vazio = a primeira.	-
path	string	não	""	Só JSON: caminho pontuado até à LISTA de registos (ex.: data.items). Vazio = a raiz já é a lista.	-
encoding	enumeration	não	"utf8"	Só CSV: como descodificar os bytes. Em utf8 é estrito - um ficheiro latin-1 falha em vez de virar mojibake em silêncio.	-
inferredColumns	list de string	não	[]	Nomes das colunas que o form detetou numa amostra do ficheiro. Vazio = desconhecidas. Não afeta a execução.	-

Exemplo JSON

{
  "parser": "csv",
  "delimiter": ",",
  "hasHeader": true,
  "sheet": "",
  "path": "",
  "encoding": "utf8",
  "inferredColumns": []
}

---

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.