Datos y expresiones

En cualquier campo que acepte un valor, «Insertar variable» abre un selector con las variables disponibles en ese paso. Una variable pertenece a un grupo:

• Profundizas en las estructuras: Pedido > Email del contacto. El selector muestra la ruta como migas de pan.
• El selector solo ofrece variables cuyo tipo encaja con el campo. Una variable del tipo Desconocido no encaja con ningún campo tipado.
• Un paso ve las variables del sistema, el trigger, los pasos anteriores al mismo nivel y los pasos de los niveles superiores.
• Como la clave es el id del paso, renombrar un paso Definir variable no rompe nada, y eliminar un paso rompe todas las referencias a él. Una referencia rota se pinta en rojo en el editor y bloquea poner el workflow en Live. El servidor no comprueba las referencias al guardar.
• El editor no ofrece los valores creados dentro de una rama o de un bucle una vez terminan, aunque sí existen en tiempo de ejecución si esa rama se ejecutó. Calcula el valor antes del paso compuesto si lo necesitas después.
• A «Intentar» publica solo su resultado, como «Resultado del intento»: «Ha fallado» (verdadero o falso) y «Mensaje de error» (texto, vacío cuando nada falló). Lo que crearon los pasos de dentro nunca sale, porque tras un fallo parte de ello puede no existir. Consulta el paso Intentar.

Un valor tiene un tipo. El editor conoce el tipo de cada variable que ofrece. Los tipos los declaras tú en cinco sitios: el cuerpo de un webhook, la respuesta de una petición HTTP, los datos de una señal, y el formulario de un trigger manual y el de un trigger "desde otro workflow". La referencia de tipos lista los once tipos con sus operadores (texto, number, true/false, fecha, enumeración, registro, estructura, lista, tupla, archivo y desconocido). Qué hace cada uno cuando la ejecución comprueba datos con él:

• Un número es un número JSON: el texto "42" no lo es. Verdadero/falso es estricto.
• Una fecha es un día o un instante. Debes indicar cuál al declararla; en la ejecución se aceptan ambos, y una fecha declarada es por defecto un instante.
• Una enumeración guarda el valor de la opción, no su etiqueta.
• Una estructura tiene campos con nombre y todos los campos declarados son obligatorios; los campos de más se ignoran. En una lista se comprueba cada elemento; en una tupla, solo las posiciones declaradas.
• Un texto puede decir que es el id de un tipo de registro; eso solo ayuda al selector.
• Un archivo lo produce un paso y no se puede escribir a mano.
• Desconocido acepta cualquier cosa, también un valor ausente o nulo, y una variable de ese tipo no encaja en ningún campo tipado del selector.

Cuando los datos no coinciden con su tipo declarado, el paso (o el trigger) falla con la ruta de los primeros campos que no coinciden, por ejemplo customer.email: expected a text and received a number. Un cuerpo de webhook se valida después de que Filmo haya respondido; consulta la página sobre webhooks entrantes.

Las funciones están disponibles en el «Definir variable» paso. Elige «Función» como tipo de valor, elige la función y rellena sus argumentos, que pueden ser funciones a su vez. Usa después el resultado como variable. Los datos de un paso Lanzar una señal también aceptan funciones.

Las funciones se dividen en ocho grupos: aritméticas, booleanas, de comparación, de texto, de fecha, de listas, condicionales y de objetos. referencia de funciones lista cada una con sus argumentos y dónde se puede usar.

Tres ejemplos de las comprobaciones del propio motor:

• Format date usa letras de date-fns, como dd/MM/yyyy (no DD/MM/YYYY, que se rechaza); los nombres de mes y de día que escribe están siempre en español, sea cual sea el idioma de la app.
• Empieza por, Termina por y Contiene distinguen mayúsculas de minúsculas y solo aceptan texto. Un texto vacío para buscar siempre coincide.
• La aritmética usa números de coma flotante normales, con sus artefactos de redondeo habituales. No hay tipo de moneda ni función de formato de números. Para totales de dinero exactos usa el paso Agregar valores, que suma con exactitud.
• No hay una función de valor por defecto ("coalesce"). Puedes construir una con Condición (si, entonces, si no).

El comportamiento de un valor vacío o ausente depende de dónde se use. Estas reglas explican la mayoría de los fallos que verás.

• system_today es una fecha sin hora, en la zona horaria de la empresa. Las fechas del trigger, como trigger_createdAt y trigger_scheduledAt, son instantes en UTC. Compara elementos del mismo tipo.
• Sumar días, Días entre y Formatear fecha mantienen la precisión de lo que les das: una fecha da una fecha, un instante da un instante. Una fecha con un día imposible, o un instante sin zona, no produce ningún valor.
• Las operaciones sobre instantes pueden usar la zona horaria del servidor en lugar de la de la empresa. Prefiere las fechas sin hora, que son exactas, cuando importe el día.
• Cambia la zona horaria de la empresa en «Fecha y formatos» («Zona horaria de la empresa») en los ajustes del negocio.

• Guardar comprueba solo la forma del workflow: que cada campo contenga un tipo de valor que acepta y que la definición no tenga más de 100 niveles de profundidad. Una comprobación fallida es un 422 que nombra la ruta y los tres primeros problemas.
• Los campos obligatorios en blanco se permiten en un borrador. Impiden poner el workflow en Live.
• En el servidor no se comprueba si existe una variable, si los argumentos de una función tienen sentido ni si un valor tiene valor al ejecutarse.