TXT Reader

1. Visão Geral

O componente TXT Reader (txt-reader) lê o conteúdo de um arquivo de texto simples já disponível na mensagem.

Use quando o fluxo precisa ler um arquivo .txt (ou qualquer arquivo de texto) recebido — por exemplo, um log ou uma lista simples. Para arquivos estruturados (Excel, PDF, Word), use o componente específico.

2. Pré-requisitos

O arquivo de texto precisa estar disponível na mensagem antes deste componente rodar.

3. Autenticação e Conexão

Não aplicável.

4. Configuração / Operações Suportadas

O componente tem uma única operação: ler o conteúdo de um arquivo de texto.

Campo	Obrigatório	Tipo	Descrição	Exemplo
file	Sim	Texto	Nome da propriedade da mensagem onde está o arquivo.	"log"
encoding	Não	Texto	Codificação de caracteres usada na leitura. Valor padrão: "UTF-8".	"UTF-8"

5. Exemplos Práticos

Exemplo simples: ler um arquivo de log recebido em um passo anterior.

Entrada:

{
  "log": "<arquivo .txt, disponibilizado por um passo anterior>"
}

Configuração do componente:

{
  "componentName": "txt-reader",
  "configurations": {
    "file": "log"
  }
}

Resposta:

{
  "text": "2026-07-20 10:00:00 - Processo iniciado\n2026-07-20 10:01:32 - Processo concluído",
  "encoding": "UTF-8",
  "length": 78,
  "lines": 2
}

Exemplo avançado: ler um arquivo de texto com codificação diferente do padrão.

Configuração do componente:

{
  "componentName": "txt-reader",
  "configurations": {
    "file": "arquivoLegado",
    "encoding": "ISO-8859-1"
  }
}

Resposta:

{
  "text": "Relatório de vendas - região Sul",
  "encoding": "ISO-8859-1",
  "length": 33,
  "lines": 1
}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"A file is required but has not been configured."	O campo file não foi preenchido.	Preencher file com o nome da propriedade que contém o arquivo.
"File [nome] not found inside the execution context."	O arquivo referenciado não está disponível na mensagem com esse nome.	Confirmar que um passo anterior disponibilizou o arquivo com esse nome exato.
"Unsupported operation: [valor]"	O campo operation foi preenchido com um valor diferente de READ.	Remover o campo operation ou usar o valor READ.
Texto com caracteres estranhos (acentos incorretos)	A codificação (encoding) configurada não corresponde à codificação real do arquivo.	Ajustar encoding para a codificação correta (ex.: ISO-8859-1 para arquivos legados).