Message Formatter

1. Visão Geral

O componente Message Formatter (message-formatter) monta um texto a partir de um modelo (template) que pode incluir dados da mensagem atual, substituindo o corpo da mensagem pelo texto resultante. É útil para montar mensagens de texto simples (notificações, logs, corpos de e-mail em texto puro) combinando dados do fluxo com texto fixo.

Use quando precisar montar uma string formatada a partir de dados do fluxo. Para formatos mais ricos (com lógica de condição, laços, tabelas), prefira o componente Freemarker.

2. Pré-requisitos

Não há credenciais ou acessos externos — processamento local.

3. Autenticação e Conexão

Não aplicável.

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

O componente tem uma única operação: montar o texto final a partir de um modelo.

Campo	Obrigatório	Tipo	Descrição	Exemplo
message	Não	Texto (modelo/expressão)	Texto ou expressão que será resolvida usando os dados da mensagem atual. Se não resolver para nenhum valor, o resultado é uma string vazia.	"Pedido {$.body.pedidoId} confirmado para {$.body.cliente.nome}"

5. Exemplos Práticos

Exemplo simples: montar uma mensagem de confirmação de pedido usando dados do corpo da mensagem.

Entrada:

{
  "pedidoId": 981,
  "cliente": { "nome": "Maria Silva" }
}

Configuração do componente:

{
  "componentName": "message-formatter",
  "configurations": {
    "message": "Pedido {$.body.pedidoId} confirmado para {$.body.cliente.nome}."
  }
}

Resposta (o corpo da mensagem vira o texto montado):

"Pedido 981 confirmado para Maria Silva."

Exemplo avançado: montar o corpo de texto de uma notificação, combinando vários campos, para em seguida usar no componente Email (textMessage) ou WhatsApp.

Entrada:

{
  "pedidoId": 982,
  "cliente": { "nome": "João Souza" },
  "entrega": { "previsao": "25/07/2026" }
}

Configuração do componente:

{
  "componentName": "message-formatter",
  "configurations": {
    "message": "Olá {$.body.cliente.nome}, seu pedido {$.body.pedidoId} chega em {$.body.entrega.previsao}."
  }
}

Resposta:

"Olá João Souza, seu pedido 982 chega em 25/07/2026."

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
Resultado sempre vazio	O campo message não foi preenchido, ou a expressão usada não resolveu para nenhum valor.	Preencher message e revisar se os caminhos usados existem na mensagem de entrada.

⚠️ CONFIRMAR: o código deste componente não lança nenhuma exceção própria — qualquer erro de resolução de expressão acontece dentro do mecanismo comum de tradução usado por vários componentes, não descrito neste arquivo.