Idioma: Español
El desencadenador En una fecha inicia una automatización según un cronograma establecido por un campo de fecha de un formulario. Una vez al día, a la hora del día que usted elija, ActivityInfo busca los registros cuyo campo de fecha cae un número de días elegido antes o después de ese día, e inicia una ejecución para cada uno de ellos.
Mientras que los desencadenadores de registro reaccionan a algo que hace un usuario, este desencadenador reacciona al calendario: una visita de seguimiento que debe realizarse en tres días, una subvención que caduca a final de mes, un registro que hoy cumple un año. Es el desencadenador que se debe usar para recordatorios, fechas límite y aniversarios.
Ajustes
| Ajuste | Descripción ||---------|-------------|| Formulario | El formulario cuyos registros se comprueban. Al igual que con los otros desencadenadores, los registros de los subformularios no se incluyen; seleccione el subformulario para programar desde uno de sus campos. | | Campo de fecha | El campo de fecha del formulario que establece el cronograma. Solo se ofrecen campos de fecha: no se pueden usar campos de semana, mes y calculados. Un registro cuyo campo de fecha está en blanco nunca activa el desencadenador. | | Zona horaria | La zona horaria en la que se interpretan la hora del día y el propio día del calendario. Por defecto, es la zona horaria de su navegador. | | Hora del día | La hora, de 00:00 a 23:00, a la que se activa el desencadenador. | | Cuándo iniciar | El primer día en que se activa el desencadenador para un registro, en relación con la fecha en el campo: En la fecha del campo, un número de días antes de la fecha del campo, o un número de días después de la fecha del campo. El número de días puede ser de hasta 3650. | | Cuánto tiempo repetir | Durante cuántos días consecutivos, contados desde el primer día, el desencadenador sigue activándose para el mismo registro. Ver más abajo. |
Cuánto tiempo repetir
| Opción | Efecto ||--------|--------|| Una vez | El desencadenador se activa para un registro solo en su primer día. | | Todos los días hasta la fecha del campo | El desencadenador se activa el primer día y cada día siguiente hasta la fecha del campo inclusive. Esta opción solo está disponible cuando el desencadenador se inicia un número de días antes de la fecha del campo. | | Durante un número de días | El desencadenador se activa el primer día y los días siguientes, durante el número de días que ingrese, hasta 366. |
Algunos ejemplos, para un registro cuyo campo de fecha contiene el 20 de noviembre:
| Cuándo iniciar | Número de días | Cuánto tiempo repetir | Se activa el ||---------------|----------------|--------------------|----------|| En la fecha del campo | | Una vez | 20 de noviembre | | Días antes de la fecha del campo | 3 | Una vez | 17 de noviembre | | Días antes de la fecha del campo | 3 | Todos los días hasta la fecha del campo | 17, 18, 19 y 20 de noviembre | | Días después de la fecha del campo | 1 | Durante un número de días: 7 | 21 al 27 de noviembre |
Cómo se activa el desencadenador
ActivityInfo comprueba cada automatización En una fecha una vez por hora. Cuando la hora en la zona horaria del desencadenador es la hora del día del desencadenador, busca los registros del formulario cuyo campo de fecha hace que ese día sea un día de activación, e inicia una ejecución por registro. Las ejecuciones aparecen en el Historial de la automatización como las ejecuciones de cualquier otro desencadenador.
Vale la pena conocer algunas consecuencias de esta programación:
- Un registro se activa como máximo una vez al día. Si los pasos de la automatización fallan y se reintentan, o si la comprobación se ejecuta dos veces, el registro no obtiene una segunda ejecución en el mismo día.
- Un registro se comprueba una vez al día, a la hora elegida. Un registro que se añade, o cuya fecha se cambia, más tarde en el día no es recogido ese día. Se activará en su próximo día de activación, si los ajustes de repetición se lo permiten.
- Cambiar el registro entretanto no importa. El desencadenador solo mira el valor del campo de fecha en el día de la comprobación. Eliminar un registro impide que se active.
- Las automatizaciones pausadas no se activan. Reanudar una automatización no recupera los días que estuvo pausada.
- Solo cuenta la hora del día elegida. El día en que comienza el horario de verano, la hora que se salta no ocurre; un desencadenador configurado para activarse a esa hora no se activará ese día.
- Una automatización inicia como máximo 10.000 ejecuciones por día. Si más registros que esa cantidad califican en el mismo día, los registros restantes se omiten para ese día.
Pasos de filtro
Cuando un paso de filtro viene inmediatamente después del desencadenador, ActivityInfo aplica su condición mientras busca registros, en lugar de iniciar una ejecución para cada registro y detener la mayoría de ellos en el filtro. Por lo tanto, un registro que el filtro rechaza no aparece en el historial de la automatización. Los filtros que vienen después de un paso de acción se comportan como de costumbre.
La condición puede usar los datos del paso del desencadenador, incluyendo _trigger.date y _trigger.field. Mientras busca registros, ActivityInfo comprueba la condición con los propios datos del formulario: lee _trigger.date del campo de fecha de cada registro, y _trigger.field es la etiqueta del campo. _trigger.time no tiene contraparte en los datos del formulario, por lo que una condición que lo use no puede ser comprobada mientras se buscan registros. Ese filtro se ejecuta como un paso normal, después de que la ejecución ha comenzado, y los registros que rechaza aparecen en el historial.
Campos y formularios eliminados
Cuando el campo de fecha, o el propio formulario, ha sido eliminado, la automatización ya no puede ser comprobada. Cada día, el historial de la automatización registra una única ejecución fallida que nombra el campo o formulario faltante, y la automatización muestra el error hasta que el desencadenador se edita para usar otro campo, o la automatización es pausada o eliminada.
Datos del paso
Cada desencadenador produce una única fila de datos del paso: los valores a los que los pasos posteriores de la automatización (los pasos de filtro, correo electrónico y webhook) pueden hacer referencia en fórmulas y plantillas.
Para este desencadenador, la fila describe el registro cuya fecha activó el desencadenador:
| Columna | Tipo | Descripción ||--------|------|-------------|| una columna por campo de formulario | el tipo del campo | El valor de cada campo del registro. Ver Referencia a campos. | | _id | Texto | El ID de registro. | | _lastEditTime | Fecha y hora | La hora en que el registro fue modificado por última vez. | | _trigger.type | Texto | Siempre DATE_FIELD para este desencadenador. | | _trigger.time | Fecha y hora | La hora de activación programada: la hora del día del desencadenador en el día de activación, por ejemplo 09:00 del 17 de noviembre. | | _trigger.date | Fecha | El valor del campo de fecha que activó el desencadenador, por ejemplo 2026-11-20. | | _trigger.field | Texto | La etiqueta del campo de fecha que activó el desencadenador. |
Si el formulario es un subformulario, la fila también incluye una columna Parent que hace referencia al registro principal.
No hay columna _user: nadie hizo nada para iniciar la ejecución. Las fórmulas y plantillas que hacen referencia a _user son rechazadas por el editor cuando el desencadenador es En una fecha. Del mismo modo, no hay columna _previous.
Webhooks
El paso de webhook envía el registro en el formato de carga útil Estándar o Personalizado como de costumbre. El formato Compatible con ActivityInfo 4.0 no puede describir un evento programado, por lo que un paso de webhook configurado con ese formato envía la carga útil Estándar cuando su automatización utiliza este desencadenador.
Ver también
- Recordar a un trabajador social antes de una visita de seguimiento, un tutorial que configura este desencadenador con un paso de correo electrónico
- Desencadenador: Cuando se añade un registro
- Desencadenador: Cuando se edita el registro
- Paso de filtro