Idioma: Español
El desencadenador Cuando se añade un registro inicia una automatización cada vez que se guarda un nuevo registro en un formulario específico. Se activa una vez por registro, después de que el registro se haya guardado con éxito, incluyendo los registros añadidos a través de la entrada de datos, la aplicación móvil, las importaciones y la API.
El desencadenador se configura con un único Formulario. Los registros añadidos a otros formularios, incluidos los subformularios del formulario seleccionado, no activan el desencadenador. Para reaccionar a los registros de subformularios, seleccione el propio subformulario como el formulario del desencadenador.
Importaciones
Los registros importados activan este desencadenador exactamente igual que los registros introducidos individualmente: una importación de 500 registros inicia 500 ejecuciones, una por registro. (Esto es un cambio con respecto a ActivityInfo 4.0, cuyos webhooks omitían las importaciones — consulte De los webhooks de ActivityInfo 4.0 a las automatizaciones.) Tenga esto en cuenta cuando una automatización publique en un sistema externo: el receptor debe estar preparado para una ráfaga de una solicitud por cada registro importado.
Datos de los pasos
Cada desencadenador produce una única fila de datos de los pasos: 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 recién añadido:
| Columna | Tipo | Descripción ||--------|------|-------------|| una columna por campo del formulario | el tipo del campo | El valor de cada campo del nuevo registro. Vea a continuación cómo hacer referencia a los campos. | | _id | Texto | El ID de registro del nuevo registro. | | _lastEditTime | Fecha y hora | La hora en que se añadió el registro. | | _user.name | Texto | El nombre del usuario que añadió el registro. | | _user.email | Texto | La dirección de correo electrónico del usuario que añadió el registro. | | _user.id | Texto | El ID de usuario del usuario que añadió el registro. | | _trigger.type | Texto | Siempre RECORD_ADDED para este desencadenador. | | _trigger.time | Fecha y hora | La hora en que ocurrió el evento. |
Si el formulario es un subformulario, la fila también incluye una columna Parent que hace referencia al registro principal, a cuyos campos se puede navegar de la misma manera que a cualquier campo de referencia.
No hay columna _previous para este desencadenador: un registro recién añadido no tiene un estado anterior con el que compararse. Las fórmulas que hacen referencia a _previous son rechazadas por el editor cuando el desencadenador es Cuando se añade un registro.
Hacer referencia a los campos
Se puede hacer referencia a los campos por código, por etiqueta o por ID de campo. Recomendamos encarecidamente asignar códigos cortos y estables a sus campos y utilizarlos en las fórmulas y plantillas de automatización: los códigos sobreviven al cambio de nombre de la etiqueta del campo, son más fáciles de leer que los ID de campo y nunca necesitan las comillas [corchetes] que requieren las etiquetas con espacios.
| Referencia | Ejemplo ||-----------|---------|| Por código (recomendado) | NAME | | Por etiqueta | [Full Name] | | Por ID de campo | cgnp9n6msbq938m7 |
Los valores de cada tipo de campo aparecen en los datos de los pasos de la siguiente manera:
| Tipo de campo | Valor en los datos del paso | Ejemplo de fórmula ||-----------|-----------------|-----------------|| Texto, texto multi-línea, código de barras | Texto | NAME == "Amina Yusuf" | | Número de serie | Texto, p. ej. "00042" | NUMBER != "" | | Cantidad | Número | AGE >= 18 | | Fecha | Fecha, p. ej. 2026-07-30 | REGDATE > "2026-01-01" | | Semana | Semana, p. ej. 2026W31 | WEEK == "2026W31" | | Mes | Mes, p. ej. 2026-07 | MONTH == "2026-07" | | Selección única | La opción seleccionada | STATUS == "Recovered" | | Selección multiple | La lista de opciones seleccionadas | CONTAINS(SYMPTOMS, "Fever") | | Referencia | El ID del registro referenciado; navegue para acceder a sus campos | CLINIC.NAME == "Mangina Health Post" | | Punto geográfico | Componentes LATITUDE, LONGITUDE y ACCURACY | LOCATION.LATITUDE > 0 | | Datos adjuntos | La lista de archivos adjuntos | !ISBLANK(FILES) | | Calculado | El resultado de la fórmula del campo | ADULT |
Un campo de referencia contiene el ID del registro referenciado, pero puede navegar a través de él a cualquier campo del formulario referenciado, incluyendo sus propios campos de referencia: CLINIC.DISTRICT.NAME.