Nodo: Script
El nodo Script es una especie de "calculadora inteligente" dentro del flujo de automatización de Hashdata. Cada vez que alguien envía un formulario, el Script puede leer todas las respuestas a la vez y transformar esos datos en información lista para usar. Suma valores, cuenta cuántos ítems fueron reprobados, calcula plazos y porcentajes, arma textos automáticamente y decide si una situación es normal, merece atención o exige acción inmediata. En un checklist de equipos, por ejemplo, identifica por sí solo qué ítems fallaron, separa los críticos de los simples, define la prioridad y redacta la descripción de la falla encontrada. Todo esto ocurre en segundos, en el momento en que llega la respuesta, sin que nadie tenga que abrir una planilla, revisar ítem por ítem o escribir un informe.
El resultado de ese cálculo se convierte en materia prima para el resto del flujo. El Script puede decidir qué camino sigue la automatización, por ejemplo bloquear un equipo y avisar a mantenimiento, o solo registrar que todo está bien. Puede completar automáticamente una Orden de Servicio en PDF, armar el texto de un correo, elegir quién debe recibir cada aviso según la unidad o el responsable, e incluso generar tablas con la lista de ítems pendientes para el cuerpo del correo o del documento. En la práctica, las reglas de negocio que antes dependían de la experiencia de alguien para aplicarse (qué es grave, quién necesita saberlo, qué se debe hacer) pasan a aplicarse siempre de la misma manera, en todas las unidades, con trazabilidad completa. El equipo deja de dedicar tiempo a organizar información y pasa a actuar sobre ella.
El nodo Script ejecuta un código escrito por usted para calcular valores a partir de los datos de los nodos anteriores — respuestas de formularios, resultado de aprobaciones, salidas de otros scripts. Los resultados (texto, número, lista de correos o lista de objetos) pueden usarse en los nodos siguientes: en el texto de los correos, en condiciones, en los destinatarios, en el estado, en el contenido de los PDF y en otros campos de texto.
El nodo se ejecuta solo, sin esperar ninguna acción externa, y avanza en cuanto el código termina.
Cuándo usar
Use el nodo Script cuando un valor que el proceso necesita no existe listo en ningún formulario. Ejemplos comunes:
- Cálculos — sumar ítems, contar no conformidades, aplicar un descuento, calcular un plazo, un porcentaje o un valor total a partir de varias respuestas.
- Clasificar — definir un estado (por ejemplo, LIBERADO, ATENCIÓN o BLOQUEADO) y una prioridad a partir de reglas con pesos diferentes.
- Armar textos — componer un mensaje, un asunto de correo o la descripción de una Orden de Servicio con partes de respuestas diferentes.
- Elegir destinatarios — devolver una lista de correos que depende de las respuestas (por ejemplo, el gerente de cada sucursal).
- Tablas en correos y PDF — devolver una lista de filas (ítem, cantidad, valor) para que aparezca como tabla en el cuerpo del correo o del PDF.
- Decidir el camino — calcular un número o un texto para usar como condición en un nodo Si/Sino (If-Else).
| Necesidad | Recurso indicado |
|---|---|
| Mostrar la respuesta de un campo en un correo o PDF | Variable normal del workflow |
| Condición simple sobre una o pocas preguntas | Si/Sino con origen Pregunta |
| Regla que combina muchos campos, con criterios diferentes | Script + Si/Sino con origen Script |
| Valor mostrado al respondente durante el llenado | Campo calculado (script) del formulario |
El campo calculado se ejecuta durante el llenado y guarda el resultado en la propia respuesta (por ejemplo, avgByTag('r')*100 para un porcentaje de conformidad). El nodo Script se ejecuta después del envío, lee la respuesta completa y entrega valores al flujo. Los dos se complementan: el campo calculado informa a quien completa el formulario, y el Script decide qué hace el proceso.
El código se escribe en TypeScript en un editor con autocompletado. Para reglas simples, como mostrar la respuesta de un campo, prefiera las variables normales del workflow: el nodo Script es para cuando hay que calcular.
Antes de empezar: prepare el formulario
El Script lee las respuestas por el Nombre del campo de cada pregunta. Por eso, el formulario debe estar listo antes de configurar el nodo.
Configure todas las preguntas del formulario, con el Nombre del campo completado, y publique el formulario antes de crear el nodo Script. Así el contexto de prueba y el autocompletado ya traen todos los campos, y el script funciona como se espera desde la primera prueba.
- Nombre del campo en todas las preguntas usadas por el script — en el editor del formulario, en Atributos del elemento → Nombre del campo. Ese nombre se convierte en la clave de la pregunta en los datos que recibe el script.
- Patrón de nombres — use minúsculas, sin tildes, sin espacios y con un número fijo de dígitos:
item_01…item_25,equipo,horometro. Los bloques de Visualización de texto no reciben nombre. - Mismo sentido en todas las respuestas — en checklists de Sí/No, redacte las preguntas de modo que "No" siempre signifique falla. Por ejemplo, "Sin fuga de agua/aceite" en lugar de "Fuga de agua/aceite".
- Valor asignado a las opciones — en Configurar selección, active Asignar valor a los ítems (por ejemplo, Sí = 1 y No = 0). Esto permite comparar por el texto o por el valor.
- Comentario y foto por opción — en la misma pantalla, los interruptores Coment. y Fotos pueden activarse solo en la opción "No". El operador registra evidencia solo cuando hay una falla, y el llenado es más rápido.
- Etiquetas — si el formulario usa un campo calculado por etiqueta (por ejemplo,
avgByTag('r')), deje la etiqueta solo en las preguntas que deben entrar en el promedio. Los campos numéricos, como un nivel de batería, deben quedar fuera. - Publique el formulario.
El Nombre del campo y las Etiquetas están uno al lado del otro en Atributos del elemento, pero tienen funciones diferentes. Una pregunta sin Nombre del campo llega al script con una clave generada automáticamente (por ejemplo, qt_6aedab461b8d267155213d55), aunque tenga una etiqueta con el nombre deseado. Los campos calculados sin nombre también aparecen así.
Configuración
Haga clic en el nodo en el canvas del editor de workflow. El panel lateral tiene el campo Rótulo, tres pestañas, Inputs, Outputs y Probar, y el área Código justo debajo de ellas. Los atajos Alt+I, Alt+O y Alt+T cambian de pestaña; no funcionan mientras escribe en un campo o en el editor de código.
- Rótulo — es el nombre del nodo en el canvas, en el selector de variables (por ejemplo, "Clasificar checklist → status") y en las condiciones del Si/Sino. Use un verbo que describa el cálculo.
- Configuración mínima — un input, un output declarado y la función
calculateValuedevolviendo ese output.
Inputs — lo que el script lee
Cada input le da al script los datos de un nodo anterior del workflow. Haga clic en Agregar input y complete:
| Campo | Descripción |
|---|---|
| Tipo | Datos (predeterminado) entrega los datos del nodo; PDF entrega el enlace y el nombre del archivo PDF del nodo. Vea Input de tipo PDF. |
| Nodo anterior | El nodo de donde vienen los datos ("Seleccione un nodo anterior"). Solo aparecen los nodos que vienen antes del Script en el flujo. Con el tipo PDF, solo aparecen los nodos que generan PDF. |
| Nombre de la variable | El nombre con el que el código accede a esos datos. Vea las reglas de nombres. |
En el código, el input llega por el nombre declarado, entre las llaves de la firma:
function calculateValue({ checklist }: Context): Result { ... }
Si el nombre en el código es diferente del nombre del input, el editor subraya la variable en rojo.
Lo que el script recibe depende del tipo del nodo elegido:
| Nodo anterior | Lo que el script recibe |
|---|---|
| Disparador de formulario, Solicitar Respuesta de Formulario y Solicitar Seguimiento | La respuesta del formulario, con un ítem por pregunta (número, texto, fecha, opciones elegidas, etc.) e información de la respuesta. El autocompletado del editor muestra los campos reales del formulario. Vea Estructura de una respuesta de formulario. |
| Aprobación | El nombre del nodo, el resultado de la aprobación y el comentario de quien respondió. Antes de la respuesta, solo el nombre. |
| Disparador programado | El nombre del nodo y el horario programado. |
| Disparador: Plan de Acción y Solicitar Plan de Acción | Los datos del plan de acción de ese nodo. |
| Otro nodo Script | Los outputs que devolvió el otro script. Así un script usa el resultado de otro, incluidas las listas de objetos. |
| Otros nodos (Esperar, Enviar Correo, Crear PDF, etc.) | El nombre del nodo y el horario en que el flujo llegó a él. |
Webhook, Slack, Teams, Google Sheets, Excel, Google Drive y OneDrive no pueden ser inputs, porque no producen datos para que el script los lea.
El formato de los datos refleja lo que el nodo anterior tiene en el momento en que el script se ejecuta. Si el formulario cambia después, el dato recibido cambia con él. El plan de acción es la excepción: sus datos se guardan cuando el disparador se activa o cuando se crea el plan solicitado, y un cambio posterior en el plan no llega al script.
Estructura de una respuesta de formulario
Un input vinculado a un disparador de formulario llega con cuatro partes:
{
"checklist": {
"formId": "6aed0730ca681f11ccb29a37",
"formName": "Checklist de Inspección",
"response": {
"equipo": { "name": "equipo", "tags": [], "label": "EMP-01" },
"horometro": { "name": "horometro", "tags": [], "number": 1523.4 },
"item_01": { "name": "item_01", "tags": ["#r"], "label": "Sí", "number": 1 },
"item_02": { "name": "item_02", "tags": ["#r"], "label": "No", "number": 0, "comment": "Fuga en la manguera" }
},
"metadata": {
"SURVEY_ID": "6aedb8e058d722c8a03b78a7",
"RESPONDENT_IS_ANONYMOUS": "0",
"RESPONSE_SUBMITTED_AT": "2026-11-06 11:24:16",
"N_OF_ATTACHMENTS": 1,
"TOTAL_TIME": 312,
"NET_TIME": 287,
"RESPONDENT_USER_ID": "69b16aa871cb3030b6523e72",
"RESPONDENT_EMAIL": "operador@empresa.com"
}
}
}
| Parte | Contenido |
|---|---|
formId / formName | Identificación del formulario. |
response | Un objeto con una clave por pregunta. La clave es el Nombre del campo de la pregunta. |
metadata | Datos de la recopilación: ID de la recopilación, si la respuesta es anónima, fecha y hora de envío (AAAA-MM-DD HH:MM:SS), número de adjuntos, tiempos total y neto de llenado, ID y correo del usuario que respondió. |
Cada pregunta dentro de response trae:
| Propiedad | Aparece en | Contenido |
|---|---|---|
name | Todas las preguntas | El Nombre del campo. |
tags | Todas las preguntas | Lista de etiquetas de la pregunta, o lista vacía. |
label | Selección única | El texto de la opción elegida (por ejemplo, "Sí" o "No"). |
number | Selección con valor asignado, campos numéricos y campos calculados | El valor de la opción (por ejemplo, 1 o 0), el número ingresado o el resultado del cálculo. |
comment | Preguntas que aceptan comentario, cuando quien respondió comentó | El comentario, exactamente como fue escrito. Un comentario hecho solo de espacios cuenta como ausente: comment no aparece. |
En general, una pregunta con comentario también tiene valor, porque el formulario no acepta enviar solo el comentario. La excepción es el cambio del tipo de la pregunta descartando los valores que no se convierten: la respuesta anterior queda solo con el comentario y llega al script como { name, tags, comment }, sin label ni number.
El comentario llega solo al nodo Script del workflow. El campo calculado (Script o Fórmula) del formulario no recibe el comentario de las respuestas.
Para verificar cómo llega un tipo de pregunta, cree un output de texto llamado estructura y devuelva JSON.stringify(checklist, null, 2). Inserte ese output en un correo de prueba enviado solo a usted: trae la respuesta completa, exactamente como el script la recibe. Quite el output del correo cuando el flujo esté validado.
Una pregunta no respondida puede no existir en response, y una pregunta sin comentario no trae comment. Use siempre ?. y ?? al leer los campos, por ejemplo: respuestas["horometro"]?.number ?? 0 o respuestas["item_02"]?.comment ?? ''.
Input de tipo PDF
Con el tipo PDF, el script recibe el PDF del nodo anterior en lugar de sus datos. La variable tiene dos campos, ambos de texto:
url— la dirección del PDF.fileName— el nombre del archivo.
Sirven como nodo anterior: Disparador de formulario, Disparador: Plan de Acción, Solicitar Respuesta de Formulario, Solicitar Seguimiento, Solicitar Plan de Acción, Crear PDF e Historial del Workflow. En los demás, el input queda con el error "Este nodo no genera PDF" y el workflow no se publica.
- En los nodos Crear PDF e Historial del Workflow, el script recibe el PDF que el propio nodo ya generó.
- En los demás, el PDF se genera en cada ejecución del script, lo que aumenta su tiempo. El editor muestra un aviso cuando esto ocurre. Si otro nodo de la misma ejecución ya generó el PDF de ese nodo (por ejemplo, un correo con la respuesta adjunta), se reutiliza: el PDF se genera una sola vez.
- Si el nodo elegido no se ejecutó en esta ejecución (por ejemplo, el otro lado de una condición),
urlyfileNamellegan vacíos, y el historial del Script registra el aviso de nodo que no se ejecutó. - Si la generación del PDF falla, el script no se ejecuta con un enlace vacío: la instancia queda con estado Fallido, como en la falla al leer el formulario (vea Cuando el nodo anterior no se ejecutó).
Un correo muestra un texto simple como texto, no como enlace. Para que el enlace sea clicable, devuelva la dirección en el formato [etiqueta](url) en un output de tipo Texto:
return { pdf: '[Abrir PDF](' + pdf.url + ')' };
Aquí pdf es el nombre de la variable del input y también el nombre del output. Devolver solo pdf.url hace que el correo muestre la dirección sin enlace. En el editor, al escribir pdf., la sugerencia Enlace Markdown del PDF inserta esa expresión lista. El formato [etiqueta](url) se explica en Enlace y tabla en el cuerpo del correo y del PDF.
Outputs — lo que el script devuelve
Cada output es un valor que el script entrega a los nodos siguientes. Haga clic en Agregar output, elija el Tipo y póngale un nombre. Existen cuatro tipos:
| Tipo | Qué es | Dónde puede usarse |
|---|---|---|
| Texto | Una frase o palabra. Una fecha devuelta como texto llega al destino como texto en formato ISO (por ejemplo, 2026-03-01T10:00:00.000Z). | Textos en general (correos, estado, nombre de archivo, contenido del PDF) y condiciones. |
| Número | Un número válido. NaN e infinito son rechazados. | Textos en general y condiciones. |
| Lista de correos | Una lista de direcciones de correo. | Destinatarios de los nodos de correo ("Agregar desde un nodo Script"). |
| Lista de objetos | Una tabla: cada ítem de la lista es una fila, y usted declara los atributos (columnas), cada uno de tipo Texto o Número. | Solo en el cuerpo de un correo o de un PDF, como tabla, o como input de otro nodo Script. |
Todo output declarado debe volver en el resultado del script, con el tipo declarado. Si falta uno, viene con un tipo diferente, o si una fila de una lista no tiene algún atributo, el nodo falla y el mensaje indica qué output o fila causó la falla. Lo que el script devuelva además de los outputs declarados se descarta.
- El nombre del output debe ser idéntico a la clave usada en el
return. Una clave sin output declarado queda subrayada en rojo en el editor. - El orden de los outputs en la lista no importa.
- Si el nombre declarado es diferente del devuelto, la prueba muestra, por ejemplo:
El output descripcon no tiene el tipo declarado (recibido: undefined).
La lista de objetos aparece como tabla en el cuerpo de los cinco nodos de correo: Aprobación, Enviar Correo, Solicitar Respuesta de Formulario, Solicitar Seguimiento y Solicitar Plan de Acción, y en el contenido de Crear PDF. No funciona en el asunto, en el estado, en el nombre del archivo del PDF, ni en Slack, Teams, webhook, planilla o Drive.
Código
El código tiene una regla fija de estructura: la función calculateValue debe ser lo primero del código, con la firma de abajo. Las funciones y constantes auxiliares van después de ella, nunca antes.
function calculateValue({ pedido, aprobacion }: Context): Result {
const total = calcularTotal(pedido);
return { total, resumen: `Total: ${total}` };
}
function calcularTotal(pedido: Context['pedido']): number {
// las funciones auxiliares van después de calculateValue
return 0;
}
- Entre las llaves de la firma, liste los nombres de los inputs que el script usa (
pedido,aprobacion). - La función devuelve un objeto, con una clave para cada output declarado.
ContextyResultson tipos generados automáticamente a partir de los inputs y outputs configurados en el panel.try/catch,throwyErrorestán permitidos: úselos para tratar situaciones esperadas y devolver un valor por defecto.- Los recursos comunes de JavaScript funcionan normalmente:
?.,??, template strings,filter,map,join,Number,String,JSON.stringifyy constantes declaradas al final del código. - Palabras bloqueadas, que impiden guardar el código:
async,await,import,importScripts,eval,then,prototype,__proto__,setTimeout,setInterval,constructor,fetchyXMLHttpRequest. Tampoco pueden usarse como nombres de variables o propiedades. El script no accede a internet, archivos ni temporizadores. - El código puede tener hasta 100.000 caracteres.
- Un error de sintaxis se señala con la línea en que ocurre, y el workflow no puede publicarse mientras el código no compile.
El código se compila cuando se guarda el borrador, lo que ocurre solo cada 30 segundos o al cerrar el panel del nodo. Si aparece el aviso "Código aún no compilado", espere el guardado automático; si el aviso continúa, corrija los errores de sintaxis.
Patrones de código recomendados
// Acceso seguro a la respuesta del formulario
const respuestas: any = (checklist as any)?.response ?? {};
const meta: any = (checklist as any)?.metadata ?? {};
// Lectura de un número, con valor por defecto
const horometro = Number(respuestas["horometro"]?.number ?? 0);
// Sí/No robusto: acepta el texto o el valor de la opción
function esNo(resp: any): boolean {
if (!resp) return false;
const label = String(resp.label ?? "").trim().toLowerCase();
return label === "no" || resp.number === 0;
}
- Separe la configuración de la lógica — las listas de ítems, pesos, límites y registros van en constantes al final del código (por ejemplo,
ITEMSyLIMITE_BATERIA). Para cambiar la regla, basta con editar la constante. - Saltos de línea — use
\nen los textos. En el resultado de la prueba aparecen literalmente como\n; en el correo y en el PDF se convierten en saltos de línea. - Valores de estado — prefiera valores en mayúsculas (
BLOQUEADO,LIBERADO). Las condiciones comparan el texto exacto.
Reglas de nombres
| Nombre | Regla | Por qué |
|---|---|---|
| Input (nombre de la variable) y Output | Solo letras sin tilde, números y _; empieza con una letra; hasta 60 caracteres; no puede ser una palabra reservada de JavaScript (como class o return) ni una de las palabras bloqueadas del código (como then). | El nombre se convierte en una variable del código y en una clave usada en los textos ({{script...}}). Una tilde, un guion o un espacio romperían ambas cosas. |
| Atributo de una lista de objetos | Libre (puede tener espacio en el medio y tildes), excepto los caracteres , " & < > }, y sin espacio al inicio ni al final. | Esos caracteres perjudican la lista de columnas de la tabla del correo (,), el texto HTML (& < > ") y el cierre de la variable (}). Tampoco se aceptan nombres iguales en la misma lista. |
Dos inputs, o dos outputs, no pueden tener el mismo nombre.
Usando los resultados en los nodos siguientes
Los outputs aparecen en el grupo Script del selector de variables de los campos de texto, y en otros dos lugares:
- Textos — en el asunto y el cuerpo de los nodos de correo, en el estado del nodo Definir Estado y en el nombre del archivo y el contenido de Crear PDF. El valor entra en el texto en lugar de la variable.
- Condiciones — en una regla de tipo Script (nodo, output, operador y valor). Sirven los outputs de tipo Texto o Número. En la flecha que sale del propio Script, la regla también puede usar los outputs de ese mismo Script. Si el output cambia de tipo o se elimina después, la regla muestra "El output cambió de tipo o fue eliminado. Revise el output, el operador y el valor de esta regla."
- Destinatarios — en los nodos de correo, Agregar desde un nodo Script usa un output de tipo Correos. Las direcciones repetidas o inválidas se ignoran, y lo descartado queda registrado en el historial.
Selector de variables
Toda variable se inserta por el ícono de etiqueta, en el editor de texto o a la derecha del campo. El selector muestra un árbol con búsqueda:
- Nodo Script — por el rótulo, con un ítem por output (por ejemplo, Clasificar checklist →
status,prioridad,descripcion). - Formulario — la carpeta Metadatos (datos de la recopilación) y la carpeta Preguntas (cada pregunta por su enunciado).
En el editor, la variable insertada aparece como una píldora azul. Una variable inexistente aparece como una píldora roja.
El texto escrito o pegado en el formato {{nombre}} no se convierte en variable: aparece como píldora roja e impide publicar el workflow. Borre las píldoras rojas e inserte las variables por el ícono de etiqueta.
En Metadatos, la variable Usuario respondente trae el ID interno del usuario (por ejemplo, 69b16aa871cb3030b6523e72). Para identificar a quien respondió en un correo o en una Orden de Servicio, use el correo del respondente.
Condiciones en el Si/Sino
- En Condiciones, elija el origen Script (los otros son Pregunta y Metadato de la Recopilación).
- En Nodo Script, seleccione el nodo por el rótulo.
- Elija el output, el operador (por ejemplo, igual a) y el valor (por ejemplo,
BLOQUEADO). - Presione Tab o haga clic fuera del campo de valor para registrarlo. Mientras eso no ocurra, el campo muestra "Informe el complemento".
Las salidas Verdadero y Falso deben estar conectadas para que el workflow se publique. Cuando el camino Falso no tiene acción, conéctelo a un nodo Definir Estado (por ejemplo, "Sin falla crítica").
Enlace y tabla en el cuerpo del correo y del PDF
- Un texto en el formato
[etiqueta](url), en un output de tipo Texto, se convierte en un enlace clicable en el cuerpo del correo y en el contenido del PDF (solo direccioneshttpyhttps). En el asunto y en los demás campos, el texto aparece tal como fue escrito. - Una lista de objetos se convierte en una tabla en el cuerpo del correo y en el contenido del PDF, con una columna por atributo. El selector de variables siempre incluye la lista de columnas, en el orden en que usted las seleccione. Una lista vacía muestra solo el encabezado.
Consejos para los editores de correo y de PDF
- Los editores son de texto con formato: títulos, negrita, colores, alineación, listas, imágenes, tablas y variables. El botón Cargar plantilla (ejemplo) muestra una plantilla lista con esos recursos.
- En el correo, el clip de la barra adjunta los PDF generados por nodos anteriores, como el de Crear PDF.
- Al hacer clic en una tabla, aparece una barra para insertar y quitar filas y columnas, combinar y dividir celdas y eliminar la tabla.
- Las tablas colocadas una justo después de otra se unen en una sola. Separe cada tabla con una línea de texto, como el título de la sección.
- En el PDF generado, las tablas aparecen sin bordes. Para formularios como una Orden de Servicio, prefiera un campo por línea, en el formato Etiqueta: valor, con líneas punteadas para lo que se completará a mano.
- Los textos de varias líneas que vienen del Script (como una descripción de servicio) quedan mejor en un párrafo propio, fuera de una tabla.
- El nombre del archivo del PDF también acepta variables, y la extensión
.pdfse agrega automáticamente.
Los textos provenientes de respuestas de formularios, al entrar en el correo o en el PDF por un script, no ejecutan código ni formato indebido: el contenido se muestra como texto.
Probar el script
La pestaña Probar, junto a Inputs y Outputs, ejecuta el script sin disparar el workflow. Solo aparece para quien puede editar el workflow:
- Haga clic en Cargar contexto de ejemplo. El campo Contexto se completa con un ejemplo para cada input, en el formato real del nodo elegido, usando los formularios que están en la pantalla.
- Ajuste los valores del ejemplo al caso que quiere simular. En un input de formulario, cada pregunta del ejemplo trae
commentcon el texto ficticioExample comment: bórrelo para simular una respuesta sin comentario. En un input de tipo PDF, el ejemplo traeurlyfileNameficticios (https://example.com/document.pdfydocument.pdf): la prueba no genera ningún PDF. Si agrega o cambia el nombre de un input después, las claves que faltan se agregan al contexto al ejecutar, sin perder lo que ya editó. - Haga clic en Ejecutar. El Resultado aparece al lado, o el mensaje del error, si lo hay.
El contexto de ejemplo viene con valores por defecto: la primera opción de cada pregunta y números fijos. Para probar una falla, edite el JSON directamente. Por ejemplo, para marcar el ítem 22 como "No":
"item_22": { "name": "item_22", "tags": ["#r"], "label": "No", "number": 0 }
Si un campo nuevo del formulario todavía no aparece en el ejemplo, agréguelo a mano al contexto. Guarde un contexto para cada escenario (liberado, atención, bloqueado) y ejecútelos todos con cada cambio en el código.
Puntos de atención:
- La prueba usa el código que está en la pantalla, sin necesidad de guardar el borrador antes. Los errores de sintaxis, de firma o las palabras bloqueadas aparecen en el Resultado.
- La prueba y la ejecución real tienen el mismo límite de 10 segundos por ejecución, y 64 MB de memoria. Superar el tiempo muestra "El script superó el límite de 10 segundos".
- El servidor acepta 2 pruebas al mismo tiempo. Si hay más, aparece "Hay demasiadas pruebas en curso. Espere unos segundos e inténtelo de nuevo": basta intentarlo otra vez. Las pruebas nunca retrasan los scripts de los workflows en ejecución, que tienen sus propios cupos.
- Si el Contexto no es un JSON válido, aparece "El contexto indicado no es un JSON válido." Revise las comas y las comillas, y si el texto pegado está completo.
- El Contexto puede tener hasta 256 KB. Por encima de eso aparece "El contexto de la prueba supera el límite de 256 KB", y la prueba ni siquiera empieza.
- Los atajos de teclado, como Cmd+A o Ctrl+A, actúan en el cuadro donde está el cursor. Haga clic dentro de Contexto o de Código antes de seleccionar todo.
- En el Resultado, los saltos de línea aparecen como
\n, y los textos generados conJSON.stringifyaparecen con\". Es solo la forma de mostrarlos.
Publicación
Al hacer clic en Publicar, el editor valida todo el workflow y lista las inconsistencias encontradas. Los nodos con pendientes quedan con el borde rojo en el canvas, y el aviso aparece en la parte superior del panel del nodo.
| Mensaje | Qué hacer |
|---|---|
| "IF/ELSE sin transición Falso configurada" | Conectar la salida Falso del Si/Sino a un nodo. |
| "Una plantilla usa una variable inexistente o una sintaxis no admitida. Los bloques y helpers solo valen para salidas de SCRIPT (script.*); en las demás variables, use solo las insertadas por el selector de variables" | Borrar las píldoras rojas e insertar las variables por el selector. Aparece un mensaje por variable. |
| "Este nodo no genera PDF" | Elegir, en el input de tipo PDF, un nodo que genere PDF. |
| "Código aún no compilado" | Esperar el guardado automático o corregir la sintaxis. |
La parte superior del editor muestra "Borrador guardado a las…". Si aparece "Guardado automático pausado", corrija el campo pendiente (por ejemplo, un valor de condición todavía no registrado) y haga clic en Intentar de nuevo antes de agregar nuevos nodos. Si se elimina un nodo por error, el botón Deshacer de la barra del editor lo recupera.
Cuando el script falla
Si el script supera los 10 segundos o los 64 MB, lanza un error no tratado, devuelve un output con tipo incorrecto, o devuelve un resultado mayor que 256 KB, el nodo falla. Con eso:
- La instancia queda con estado Fallido, y el responsable del workflow recibe un correo avisando, con el enlace para ver los eventos.
- El error aparece en el historial de la instancia, con la causa (por ejemplo, qué output o fila estaba incorrecto).
- Los datos de entrada del script no se envían a herramientas de monitoreo de errores ni se registran en el log del servidor, porque pueden contener respuestas de formularios.
Use try/catch para casos previsibles (campo vacío, división por cero) y devuelva un valor por defecto. Así la instancia sigue adelante en lugar de fallar.
Cuando el nodo anterior no se ejecutó
El workflow solo garantiza que existe un camino del nodo anterior hasta el Script, no que el nodo ya se ejecutó. Esto ocurre, por ejemplo, cuando el Script lee un nodo del otro lado de un Si/Sino (If-Else), o cuando una aprobación todavía no fue respondida.
En esos casos el dato llega vacío (el input llega como un objeto sin datos, el texto aparece en blanco; en un input de tipo PDF, url y fileName llegan vacíos y no se genera ningún PDF para ese nodo; un nodo que empezó y falló también cuenta como no ejecutado), y el nodo que leyó el dato muestra en el historial de la instancia el aviso "Datos vacíos de nodos que no se ejecutaron antes", con el nombre de cada nodo. El workflow no falla por eso: trate el caso vacío en el código.
Un nodo de plan de acción puede haberse ejecutado y aun así entregar un objeto vacío: cuando el plan no se pudo leer, o cuando el problema o la acción que dispararon el flujo se eliminaron antes de que el workflow guardara sus datos. En ese caso el historial muestra el aviso "Datos no disponibles de nodos que se ejecutaron antes", con el nombre del nodo, y el workflow también sigue adelante.
Esto es distinto de una falla al leer el formulario o la respuesta, o al generar el PDF de un input PDF (por ejemplo, una indisponibilidad momentánea de la base de datos o del almacenamiento de archivos): en ese caso el script no se ejecuta con datos vacíos. La instancia queda con estado Fallido, el responsable del workflow recibe el correo de aviso, y el error aparece en el historial como falla del script.
Ejemplo completo: checklist de inspección con Orden de Servicio
Un checklist de inspección de montacargas con ítems de Sí/No, de los cuales algunos son críticos. Si algún ítem crítico falla, el equipo se bloquea y se envía a mantenimiento una Orden de Servicio en PDF.
Flujo
- Disparador: Respuesta de Formulario "Checklist recibido", que se dispara solo en Nueva respuesta — así, editar una respuesta no genera una nueva OS.
- Script "Clasificar checklist".
- Si/Sino "Falla crítica": origen Script,
statusigual aBLOQUEADO. - Salida Verdadero:
- Definir Estado — "Bloqueado – esperando mantenimiento".
- Crear PDF — plantilla de la OS, con las variables del Script.
- Enviar Correo — a mantenimiento, con
descripcionen el cuerpo y el PDF adjunto.
- Salida Falso: Definir Estado — "Sin falla crítica".
Regla de clasificación
| Estado | Condición | Prioridad |
|---|---|---|
| BLOQUEADO | Al menos un ítem crítico con "No". | 1 |
| ATENCIÓN | Ningún ítem crítico con falla, pero al menos un ítem común con "No" (o batería por debajo del límite, cuando está definido). | 2 |
| LIBERADO | Todos los ítems con "Sí". | 3 |
Configuración del nodo
- Input: nodo "Checklist recibido", con la variable
checklist. - Outputs:
| Output | Tipo | Contenido |
|---|---|---|
status | Texto | BLOQUEADO, ATENCIÓN o LIBERADO. |
prioridad | Número | 1, 2 o 3. |
descripcion | Texto | Descripción de los servicios, con los ítems con falla. |
cant_criticos_nc | Número | Cantidad de ítems críticos con falla. |
cant_nc | Número | Cantidad total de ítems con falla. |
nivel_bateria | Número | Nivel de carga informado. |
numero_os | Texto | Número de la OS, generado a partir de la fecha y hora de envío. |
equipo | Texto | Equipo elegido en el formulario. |
ubicacion | Texto | Ubicación del equipo, tomada del registro en el código. |
gerente | Texto | Gerente del equipo, tomado del registro en el código. |
extension | Texto | Extensión telefónica, tomada del registro en el código. |
horometro | Texto | Horómetro formateado (por ejemplo, "1523,4 h"). |
fecha_checklist | Texto | Fecha y hora del checklist (por ejemplo, "06/11/2026 10:36"). |
estructura | Texto | Diagnóstico: la respuesta completa. Quitar de los correos después de validar. |
Código
function calculateValue({ checklist }: Context): Result {
const respuestas: any = (checklist as any)?.response ?? {};
const meta: any = (checklist as any)?.metadata ?? {};
// Clasificación
const noConformes = ITEMS.filter(item => esNoConforme(respuestas[item.id]));
const criticosNC = noConformes.filter(item => item.critico);
const nivelBateria = Number(respuestas["item_18"]?.number ?? 0);
const bateriaBaja = LIMITE_BATERIA !== null && nivelBateria < LIMITE_BATERIA;
const status = criticosNC.length > 0 ? "BLOQUEADO"
: (noConformes.length > 0 || bateriaBaja) ? "ATENCIÓN"
: "LIBERADO";
const prioridad = status === "BLOQUEADO" ? 1 : status === "ATENCIÓN" ? 2 : 3;
// Descripción de los servicios
const encabezado = status === "BLOQUEADO"
? "BLOQUEO AUTOMÁTICO: Falla Crítica Detectada"
: status === "ATENCIÓN" ? "ATENCIÓN: Falla no crítica detectada" : "";
const lineas = noConformes.map(item => `- ${item.num} - ${item.nombre}`);
if (bateriaBaja) lineas.push(`- 18 - Nivel de carga de la batería (${nivelBateria}%)`);
const descripcion = lineas.length
? `${encabezado}\n\nÍTEMS DEL CHECKLIST CON FALLA:\n${lineas.join("\n")}`
: "Ninguna no conformidad registrada.";
// Identificación de la OS
const equipo = String(respuestas["equipo"]?.label ?? "").trim();
const registro = REGISTRO[equipo] ?? { ubicacion: "", gerente: "", extension: "" };
const enviadoEn = String(meta.RESPONSE_SUBMITTED_AT ?? ""); // "2026-11-06 10:36:32"
const numero_os = enviadoEn ? "OS-" + enviadoEn.replace(/\D/g, "") : "";
const horometroNum = respuestas["horometro"]?.number;
const horometro = horometroNum !== undefined && horometroNum !== null && horometroNum !== ""
? `${String(horometroNum).replace(".", ",")} h`
: "";
return {
status,
prioridad,
descripcion,
cant_criticos_nc: criticosNC.length,
cant_nc: noConformes.length,
nivel_bateria: nivelBateria,
numero_os,
equipo,
ubicacion: registro.ubicacion,
gerente: registro.gerente,
extension: registro.extension,
horometro,
fecha_checklist: formatearFecha(enviadoEn),
estructura: JSON.stringify(checklist, null, 2)
};
}
function esNoConforme(resp: any): boolean {
if (!resp) return false;
const label = String(resp.label ?? "").trim().toLowerCase();
return label === "no" || resp.number === 0;
}
function formatearFecha(fechaHora: string): string {
// "2026-11-06 10:36:32" -> "06/11/2026 10:36"
const m = fechaHora.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})/);
return m ? `${m[3]}/${m[2]}/${m[1]} ${m[4]}:${m[5]}` : fechaHora;
}
const LIMITE_BATERIA: number | null = null; // ej.: 20 para exigir como mínimo 20%
// Registro de los equipos: la clave debe ser IDÉNTICA al texto de la opción en el formulario
const REGISTRO: Record<string, { ubicacion: string; gerente: string; extension: string }> = {
"EMP-01": { ubicacion: "Expedición", gerente: "Nombre del Gerente", extension: "1234" },
"EMP-02": { ubicacion: "Cámara frigorífica", gerente: "Nombre del Gerente", extension: "1235" }
};
const ITEMS = [
{ id: "item_01", num: 1, nombre: "Fuga de agua/aceite", critico: true },
{ id: "item_02", num: 2, nombre: "Mangueras", critico: false },
{ id: "item_03", num: 3, nombre: "Pintura general", critico: false },
{ id: "item_04", num: 4, nombre: "Material atascado en las ruedas", critico: false },
{ id: "item_05", num: 5, nombre: "Ruedas delanteras/traseras", critico: false },
{ id: "item_06", num: 6, nombre: "Cadenas del mástil", critico: true },
{ id: "item_07", num: 7, nombre: "Cinturón de seguridad", critico: true },
{ id: "item_08", num: 8, nombre: "Extintor de incendios", critico: false },
{ id: "item_09", num: 9, nombre: "Sistema de climatización", critico: false },
{ id: "item_10", num: 10, nombre: "Acrílico/vidrio de protección", critico: false },
{ id: "item_11", num: 11, nombre: "Pedales/Joystick/Mandos", critico: true },
{ id: "item_12", num: 12, nombre: "Bocina y faro", critico: true },
{ id: "item_13", num: 13, nombre: "Freno y volante", critico: true },
{ id: "item_14", num: 14, nombre: "Retrovisores", critico: false },
{ id: "item_15", num: 15, nombre: "Baliza giratoria", critico: false },
{ id: "item_16", num: 16, nombre: "Alarma de marcha atrás", critico: false },
{ id: "item_17", num: 17, nombre: "Código de error en el panel", critico: false },
{ id: "item_19", num: 19, nombre: "Luz de freno", critico: false },
{ id: "item_20", num: 20, nombre: "Luz de advertencia del panel", critico: false },
{ id: "item_21", num: 21, nombre: "Dirección", critico: true },
{ id: "item_22", num: 22, nombre: "Mástil", critico: true },
{ id: "item_23", num: 23, nombre: "Pedal de aproximación", critico: true },
{ id: "item_24", num: 24, nombre: "Protecciones de seguridad", critico: false },
{ id: "item_25", num: 25, nombre: "Pedal de seguridad o timón", critico: true }
];
El operador elige solo el equipo en el formulario. La ubicación, el gerente y la extensión vienen de la constante REGISTRO, lo que evita errores de escritura y hace el checklist más rápido. La clave de cada equipo debe ser idéntica al texto de la opción en el formulario, incluidos espacios, guiones y barras.
En la constante ITEMS, los nombres describen la falla ("Fuga de agua/aceite"), y no la pregunta del formulario ("Sin fuga de agua/aceite"). Así la descripción de la OS queda clara para quien va a ejecutar el servicio.
Resultado de la prueba
Con el equipo EMP-01, el horómetro 1523.4 y los ítems 3 y 22 marcados como "No":
| Output | Valor |
|---|---|
status | BLOQUEADO |
prioridad | 1 |
cant_criticos_nc | 1 |
cant_nc | 2 |
numero_os | OS-20261106103632 |
ubicacion | Expedición |
horometro | 1523,4 h |
fecha_checklist | 06/11/2026 10:36 |
descripcion:
BLOQUEO AUTOMÁTICO: Falla Crítica Detectada
ÍTEMS DEL CHECKLIST CON FALLA:
- 3 - Pintura general
- 22 - Mástil
Evoluciones posibles
- Tabla de ítems en la OS — reemplace
descripcionpor un output Lista de objetos (atributos Ítem, Descripción, Crítico). La OS en el PDF y en el correo pasa a mostrar una tabla. - Destinatarios por unidad — devuelva un output Lista de correos con el responsable de cada equipo y úselo en Agregar desde un nodo Script.
- Camino de atención — en la salida Falso, agregue un segundo Si/Sino con
statusigual aATENCIÓN, para pedir mantenimiento programado con Solicitar Plan de Acción. - Ejecución y liberación digitales — después del correo, use Solicitar Respuesta de Formulario para que mantenimiento registre el servicio, Aprobación para que el gerente lo valide y un segundo Crear PDF para generar la OS cerrada.
- Más seguridad — envuelva el cálculo en
try/catchy devuelvastatus = "ERROR"con una descripción, para que la instancia siga adelante.
Errores frecuentes y solución
| Lo que aparece | Causa | Solución |
|---|---|---|
| Variable de la firma subrayada en rojo | Input sin nombre, o con un nombre diferente. | Igualar el Nombre de la variable al nombre usado en el código. |
Clave del return subrayada en rojo | Output no declarado. | Declarar el output con el mismo nombre y el tipo correcto. |
| El valor calculado no aparece en el Resultado | Output no declarado: lo que no está declarado se descarta. | Declarar el output en la pestaña Outputs. |
| "El output X no tiene el tipo declarado (recibido: undefined)" | Nombre del output diferente de la clave del return. | Corregir uno de los dos nombres. |
| "calculateValue is not defined" | Área Código vacía o sin la función. | Pegar el código completo, empezando por calculateValue. |
response vacío o sin un campo en el contexto de prueba | Pregunta sin Nombre del campo, o formulario no publicado. | Completar el Nombre del campo y publicar el formulario antes de crear el Script; si es necesario, agregar el campo a mano en el contexto. |
El campo llega con clave qt_... | Pregunta sin Nombre del campo (el nombre se puso en Etiquetas). | Completar el Nombre del campo y quitar la etiqueta. |
| Clasificación invertida en una pregunta | Pregunta en la que "Sí" indica falla. | Reescribir la pregunta para que "No" siempre indique falla. |
| Contexto de ejemplo siempre sin fallas | El ejemplo usa valores por defecto. | Editar el contexto manualmente. |
| "Código aún no compilado" | Borrador todavía no guardado. | Esperar el guardado automático; si continúa, corregir la sintaxis. |
| El código no se guarda | Palabra bloqueada (then, fetch, async…). | Quitarla o cambiarle el nombre. |
| "El script superó el límite de 10 segundos" | Cálculo pesado o repetición sin fin. | Simplificar la lógica. |
| "El contexto indicado no es un JSON válido." | Coma o comillas fuera de lugar, o texto pegado incompleto. | Corregir el JSON o pegar el bloque completo de nuevo. |
| "Informe el complemento" (Si/Sino) | Valor de la condición no registrado. | Presionar Tab o hacer clic fuera del campo. |
| "IF/ELSE sin transición Falso configurada" | Salida Falso sin conexión. | Conectar la salida Falso a un nodo. |
| Píldora roja en una plantilla | Variable escrita a mano o de un campo inexistente. | Insertarla por el selector de variables. |
| El solicitante aparece como un código en el PDF | Variable Usuario respondente, que trae el ID. | Usar el correo del respondente. |
| Tablas unidas o sin bordes en el PDF | Tablas colocadas en secuencia; el PDF no dibuja bordes. | Separarlas con una línea de texto o usar un campo por línea. |
| "El output cambió de tipo o fue eliminado…" | Output modificado después de usarse en una condición. | Revisar la regla de la condición. |
| Instancia con estado Fallido | Error no tratado, tipo incorrecto, límite de tiempo, memoria o tamaño, o falla al leer los datos. | Ver el historial de la instancia y tratar los casos previsibles con try/catch. |
Guía paso a paso
- Formulario — completar el Nombre del campo de todas las preguntas usadas, estandarizar el sentido de las respuestas, asignar valores a las opciones y publicar.
- Nodo — con el formulario listo, crear el Script, conectarlo al nodo anterior y darle un rótulo con un verbo.
- Input — elegir el nodo anterior y darle un nombre de variable válido.
- Diagnóstico — crear el output
estructura(Texto) conJSON.stringify(input, null, 2), cargar el contexto y verificar queresponsetraiga todos los campos. - Outputs — declarar cada output con el nombre exacto y el tipo correcto.
- Código —
calculateValueprimero, lectura con?.y??, reglas y registros en constantes al final, sin palabras bloqueadas,try/catchen los casos previsibles. - Pruebas — un contexto por escenario, incluidos campos vacíos y casos extremos.
- Nodos siguientes — variables siempre por el selector (píldora azul), las dos salidas del Si/Sino conectadas, valores de condición idénticos a los devueltos por el código.
- Publicación — resolver todas las inconsistencias y hacer la primera prueba real con un destinatario interno, con el output
estructuraen el cuerpo del correo. - Ajuste final — quitar la
estructurade los correos y reemplazar los destinatarios de prueba por los definitivos.
Buenas Prácticas
- Dé nombres que expliquen el valor:
total_pedidoycorreos_gerentesayudan más quexylista. - Declare solo los inputs que usa: el script recibe solo lo que usted configuró, y eso deja el autocompletado más limpio.
- Prepare el formulario primero: Nombre del campo completado en todas las preguntas y formulario publicado antes de crear el Script.
- Pruebe antes de publicar: use Cargar contexto de ejemplo, ajuste los valores con casos extremos (campo vacío, lista vacía, todos los ítems con falla) y ejecute.
- Mantenga el script corto: cada script debe calcular un conjunto de valores. Para etapas diferentes, encadene dos nodos Script.
- Separe regla y configuración: las listas, pesos, límites y registros en constantes facilitan los ajustes sin tocar la lógica.
- Combine con el nodo Definir Estado: un estado en cada camino ayuda a saber, en el panel de instancias, en qué etapa está la instancia y qué decisión tomó el Script.