File Writer

1. Visão Geral

O componente File Writer (file-writer) grava um conteúdo de texto em um novo arquivo, disponibilizando o arquivo criado para os próximos passos do fluxo.

Use quando o fluxo precisa gerar um arquivo de texto a partir de dados processados (por exemplo, um relatório ou log). Para gerar documentos formatados (Word, planilhas), use os componentes específicos (Markdown to DOCX, etc.).

2. Pré-requisitos

Não há credenciais externas — o componente grava arquivos localmente no servidor onde a plataforma roda.

3. Autenticação e Conexão

Não aplicável.

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

O componente tem uma única operação: gravar um conteúdo em um arquivo.

Campo	Obrigatório	Tipo	Descrição	Exemplo
content	Sim	Texto	Conteúdo a ser gravado no arquivo.	"Relatório gerado em 20/07/2026"
fileName	Sim	Texto	Nome do arquivo a ser criado.	"relatorio.txt"
encoding	Não	Texto	Codificação de caracteres usada ao gravar o arquivo. Valor padrão: "UTF-8".	"UTF-8"
mode	Não	Texto: CREATE_NEW, APPEND ou OVERWRITE	Comportamento se já existir um arquivo com o mesmo nome. CREATE_NEW (padrão) falha se já existir; APPEND adiciona ao final; OVERWRITE substitui o conteúdo.	"OVERWRITE"

5. Exemplos Práticos

Exemplo simples: gerar um arquivo de texto com um relatório simples.

Entrada:

{
  "relatorio": "Vendas do dia: R$ 15.000"
}

Configuração do componente:

{
  "componentName": "file-writer",
  "configurations": {
    "content": "{$.body.relatorio}",
    "fileName": "relatorio-vendas.txt"
  }
}

Resposta (o arquivo criado fica disponível como propriedade relatorio-vendas.txt para os próximos passos):

{
  "fileName": "relatorio-vendas.txt",
  "size": 24,
  "encoding": "UTF-8",
  "mode": "CREATE_NEW",
  "success": true
}

Exemplo avançado: adicionar uma nova linha a um arquivo de log já existente na mensagem.

Configuração do componente:

{
  "componentName": "file-writer",
  "configurations": {
    "content": "{$.body.novaLinhaLog}",
    "fileName": "log-execucao.txt",
    "mode": "APPEND"
  }
}

Resposta:

{
  "fileName": "log-execucao.txt",
  "size": 1280,
  "encoding": "UTF-8",
  "mode": "APPEND",
  "success": true
}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"content parameter is required"	O campo content não foi preenchido.	Preencher content com o texto a gravar.
"fileName parameter is required"	O campo fileName não foi preenchido.	Preencher fileName com o nome do arquivo.
"Camel failed to create file: [nome]"	O arquivo já existe e mode está como CREATE_NEW (padrão).	Usar mode: "OVERWRITE" ou mode: "APPEND" se o arquivo já pode existir.
"Invalid operation: [valor]. Supported: WRITE_FILE"	O campo operation foi preenchido com um valor diferente de WRITE_FILE.	Remover o campo operation ou usar o valor WRITE_FILE.