Form Render

Descripcion

El modulo Form Render permite generar formularios pre-poblados con datos provenientes del workflow. Consulta la base de datos para obtener la estructura del formulario, procesa el mapeo de campos con variables dinamicas, y genera una sesion temporal con los datos pre-poblados (valida por 24 horas). Soporta tres modos de salida: URL del formulario, respuesta HTML directa con el formulario renderizado, o redireccion HTTP al formulario. Es ideal para crear formularios de atencion al cliente, encuestas personalizadas, o formularios de aprobacion que necesitan datos pre-cargados.

Configuracion

Parametro	Tipo	Requerido	Descripcion
form_id	form_selector	Si	Selecciona el formulario a renderizar
field_mapping	key_value_mapping	No	Mapeo de datos del workflow a campos del formulario (soporta `{{variable}}`)
output_type	select	No	Tipo de salida: URL del formulario, respuesta HTML directa, o redireccion al formulario (por defecto: url)
redirect_after_submit	boolean	No	Redirigir despues de enviar el formulario (por defecto: false)
custom_title	text	No	Titulo personalizado (soporta variables `{{variable}}`)
custom_description	textarea	No	Descripcion personalizada (soporta variables `{{variable}}`)

Salida

Modo URL (por defecto)

{
  "nextModule": null,
  "data": {
    "success": true,
    "form_url": "https://app.ejemplo.com/f/abc123?prefill=hash456",
    "session_hash": "hash456",
    "form_id": "1",
    "form_name": "Mi Formulario",
    "prefill_data": { "nombre": "Juan", "email": "juan@test.com" },
    "expires_at": "2024-01-02T00:00:00.000Z"
  }
}

Modo redirect

{
  "nextModule": null,
  "data": {
    "code_response": 302,
    "headers": { "Location": "https://app.ejemplo.com/f/abc123?prefill=hash456" },
    "body_response": "<html>...</html>"
  }
}

Ejemplo de Uso

Caso basico

{
  "form_id": "15",
  "field_mapping": {
    "nombre": "{{clienteNombre}}",
    "email": "{{clienteEmail}}",
    "pedido_id": "{{orderId}}"
  },
  "output_type": "url",
  "custom_title": "Formulario para {{clienteNombre}}"
}

Notas

Soporta variables dinamicas {{variable}} en field_mapping, custom_title y custom_description
La sesion de datos pre-poblados expira en 24 horas
Los datos se almacenan en la tabla form_prefill_sessions
El formulario se busca en la tabla forms de la base de datos
El modo HTML genera un formulario completo con estilos CSS integrados y JavaScript para el envio
Los modos html y redirect detienen el flujo del workflow (_stopflowprocess: true)
Soporta tipos de campo: text, textarea, select, checkbox, hidden, header, divider, paragraph

Nodos Relacionados

webresponse (respuesta HTTP personalizada)
http (peticiones HTTP)