Form Render

Descripción

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 dinámicas, y genera una sesión 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 redirección HTTP al formulario. Es ideal para crear formularios de atención al cliente, encuestas personalizadas, o formularios de aprobación que necesitan datos pre-cargados.

Configuración

Parámetro	Tipo	Requerido	Descripción
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 redirección al formulario (por defecto: url)
redirect_after_submit	boolean	No	Redirigir después de enviar el formulario (por defecto: false)
custom_title	text	No	Título personalizado (soporta variables {{variable}})
custom_description	textarea	No	Descripción 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 básico

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

Notas

• Soporta variables dinámicas {{variable}} en field_mapping, custom_title y custom_description
• La sesión 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 envío
• 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)