Disparadores y filtros de los flujos de trabajo

Un flujo de trabajo empieza con un disparador y puede llevar filtros que deciden si se ejecuta para una reserva concreta. Ambos están en la parte superior de los formularios de creación y edición, encima de la acción.

Disparadores

Eliges un tipo de disparador y el formulario muestra solo los campos que le corresponden.

• Status reached (estado alcanzado): se ejecuta cuando una reserva entra en un estado concreto. Eliges el estado de la lista de estados configurados en tu organización; cada opción se muestra como una etiqueta del color de su estado. La primera vez que eliges este tipo de disparador, toma por defecto tu Default status for new bookings (estado por defecto de las reservas nuevas): New, salvo que lo hayas cambiado en Creación de reservas.
• Payment status reached (estado de pago alcanzado): se ejecuta cuando el pago de una reserva llega a un estado concreto (por ejemplo, Completed o Refunded). El desplegable muestra cada estado de pago como una etiqueta de color. Por defecto, Completed.
• Booking created (reserva creada): se ejecuta una vez, cuando se crea una reserva nueva. No necesita más configuración.
• Relative time reached (momento relativo alcanzado): se ejecuta con un desfase configurado antes o después del inicio o del fin de una reserva. Eliges:
  • Relative to (respecto a): Booking start time o Booking end time (inicio o fin de la reserva).
  • Direction (dirección): Before o After (antes o después; un botón segmentado que debe tener un valor).
  • Offset (desfase): un número con un selector de unidad de tiempo (el selector numérico recuerda la unidad, así que un desfase guardado en minutos se puede seguir editando en horas o días). Debe ser mayor que cero.

Estos cuatro son los únicos tipos de disparador. Elijas el que elijas, los filtros opcionales del flujo de trabajo se comprueban justo después de que se cumpla el disparador e inmediatamente antes de ejecutar la acción.

Filtros: "Ejecutar este flujo de trabajo solo cuando…"

Los filtros son un bloque opcional de condiciones de cada flujo de trabajo. Están entre las secciones Trigger y Action del formulario, bajo el título Filters con la ayuda "Only run this workflow when these conditions are met. Leave empty to always run." (ejecutar este flujo de trabajo solo cuando se cumplan estas condiciones; déjalo vacío para que se ejecute siempre). En la Preview en tiempo real, las condiciones aparecen bajo el título "Only when", entre la tarjeta del disparador y la de la acción.

Cómo funciona la coincidencia: AND de grupos OR

Los filtros se organizan en grupos:

• Las condiciones dentro del mismo grupo se combinan con OR (o): basta con que se cumpla una de ellas para que se cumpla el grupo. El editor muestra un conector OR entre las filas.
• Los grupos distintos se combinan con AND (y): se tienen que cumplir todos los grupos. El editor muestra un separador & / AND entre los grupos.

Así, la regla completa se lee como (A o B) y (C o D). Es exactamente como lo evalúa Requiply en el servidor: cada grupo necesita al menos una condición que se cumpla, y tienen que pasar todos los grupos.

Los filtros se comprueban en todos los tipos de disparador (incluidos los flujos de trabajo de tiempo relativo, que procesa más tarde una tarea en segundo plano), después de que se cumpla el disparador y justo antes de ejecutar la acción.

Por qué puedes filtrar

Los campos se agrupan en Booking (reserva) y Client (cliente), cada uno con sus campos predefinidos más los campos personalizados que hayas configurado.

Booking (predefinidos):

Client (predefinidos):

Campos personalizados: también aparece cualquier campo de entidad que hayas configurado en el nivel Booking o Client, agrupado en Booking custom fields / Client custom fields (campos personalizados de la reserva o del cliente). El tipo de valor de cada uno (texto, número, fecha, lista, lista múltiple o casilla) sigue el tipo del propio campo personalizado.

Operadores según el tipo de campo

Los operadores disponibles dependen del tipo de campo:

El campo del valor se adapta al campo y al operador que elijas:

• is empty / is not empty, y los operadores de casilla Yes / No, no muestran ningún campo de valor.
• is between (número o fecha) muestra dos campos (un par mínimo/máximo o un intervalo de fechas).
• is any of / is none of (Select) y los operadores de Multiselect muestran un selector múltiple de chips.
• Todo lo demás muestra un único campo de texto, número, fecha o lista adaptado al campo.

Al cambiar el campo, el operador vuelve al valor por defecto de ese tipo de campo y se borra el valor; al cambiar solo el operador, se borra el valor.

Lo que conviene saber sobre cómo se cumplen las condiciones

• Las comparaciones de texto (is, is not, contains) no distinguen mayúsculas de minúsculas, y un contains con el valor vacío nunca se cumple.
• Los valores de número y de fecha que no se pueden leer se consideran no coincidentes, así que un flujo de trabajo nunca se ejecuta con un valor que no ha podido interpretar.
• Las condiciones de Select guardan el valor interno de la opción (por ejemplo, el id de un estado); la vista previa lo convierte por ti en el nombre legible.
• Una condición cuyo valor dejas en blanco simplemente no se cumple: no deja que el flujo de trabajo se ejecute por accidente.

Crear y editar filtros

• Si todavía no hay condiciones, ves un único botón Add filter (añadir filtro).
• En cuanto añades una, cada grupo es una tarjeta con filas OR. Dentro de la tarjeta hay un botón Add OR condition (añadir condición OR) y un botón Remove group (quitar grupo); debajo de las tarjetas hay un botón Add AND group (añadir grupo AND) para empezar un grupo nuevo, con un separador & entre los grupos. Cada fila tiene además una × para quitar solo esa condición. Los nombres de los campos del desplegable llevan delante su origen, por ejemplo Booking · Total cost o Client · Pricing discount.
• Al guardar, se eliminan los grupos vacíos. Si no queda nada, el flujo de trabajo se guarda sin filtros y vuelve a ejecutarse cada vez que se cumple el disparador.