Message Formatter

1. Visión General

El componente Message Formatter (message-formatter) arma un texto a partir de una plantilla (template) que puede incluir datos del mensaje actual, reemplazando el cuerpo del mensaje por el texto resultante. Es útil para armar mensajes de texto simples (notificaciones, logs, cuerpos de correo en texto plano) combinando datos del flujo con texto fijo.

Úsalo cuando necesites armar una cadena formateada a partir de datos del flujo. Para formatos más ricos (con lógica de condición, bucles, tablas), prefiere el componente Freemarker.

2. Prerrequisitos

No hay credenciales ni accesos externos — procesamiento local.

3. Autenticación y Conexión

No aplica.

4. Configuración / Operaciones Soportadas

El componente tiene una única operación: armar el texto final a partir de una plantilla.

Campo	Obligatorio	Tipo	Descripción	Ejemplo
message	No	Texto (plantilla/expresión)	Texto o expresión que será resuelta usando los datos del mensaje actual. Si no resuelve a ningún valor, el resultado es una cadena vacía.	"Pedido {$.body.pedidoId} confirmado para {$.body.cliente.nome}"

5. Ejemplos Prácticos

Ejemplo simple: armar un mensaje de confirmación de pedido usando datos del cuerpo del mensaje.

Entrada:

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

Configuración del componente:

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

Respuesta (el cuerpo del mensaje se convierte en el texto armado):

"Pedido 981 confirmado para Maria Silva."

Ejemplo avanzado: armar el cuerpo de texto de una notificación, combinando varios campos, para usarlo luego en el componente Email (textMessage) o WhatsApp.

Entrada:

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

Configuración del componente:

{
  "componentName": "message-formatter",
  "configurations": {
    "message": "Hola {$.body.cliente.nome}, tu pedido {$.body.pedidoId} llega el {$.body.entrega.previsao}."
  }
}

Respuesta:

"Hola João Souza, tu pedido 982 llega el 25/07/2026."

6. Errores Comunes y Troubleshooting

Error / Síntoma	Causa probable	Cómo resolverlo
Resultado siempre vacío	El campo message no fue completado, o la expresión usada no resolvió a ningún valor.	Completar message y revisar que las rutas usadas existan en el mensaje de entrada.