Habilita el monitoreo pasivo, la generación de alertas complejas, el control de dispositivos y la activación de diferentes acciones dentro y fuera de Ubidots creando eventos que se activan según un conjunto de condiciones fáciles de configurar.
1. Crear un evento condicional
Para comenzar, ve a la sección Eventos bajo la pestaña "Datos" y haz clic en el botón "+" ubicado en la esquina superior derecha de la pantalla.
Una vez que aparezca el modal del evento, estarás en la primera etapa de configuración, donde definirás la lógica de los activadores.
De forma predeterminada, un evento recién creado carga con un activador basado en valor, pero puedes elegir otro tipo de activador haciendo clic en los botones "+ agregar activador" o "+ agregar grupo OR".
Los tipos de activadores disponibles son los siguientes:
Basado en valor (por ejemplo, si el valor es mayor que X).
Inactividad (por ejemplo, si la variable no se ha actualizado en X cantidad de tiempo).
Geocerca (si el dispositivo entra o sale de un área definida en un mapa).
Basado en contexto (por ejemplo, el valor de la clave de contexto objetivo de la variable es una cadena de texto específica). Un error de configuración común que se debe evitar es el formato incorrecto de literales numéricos en valores de contexto, los cuales siempre deben estar entre comillas (por ejemplo, en lugar de
1, usar"1").
Estos activadores pueden eliminarse o copiarse haciendo clic en el botón correspondiente ubicado en la esquina superior derecha del activador.
Para aprender sobre los activadores de inactividad, geocerca y basados en contexto, consulta sus guías correspondientes, enlazadas arriba. Continúa leyendo esta guía para aprender sobre los activadores basados en valor.
2. Crear un activador basado en valor
2.1. Activadores
Paso 1: Selecciona una variable por expresión condicional. Se pueden agregar múltiples variables usando condicionales AND ("+ agregar activador") / OR ("+ agregar grupo OR").
Paso 2: Define la condición de activación entre estas opciones:
Igual a
No igual a
Mayor que
Mayor o igual que
Menor que
Menor o igual que
Paso 3: Elige cómo se evaluará el valor de activación haciendo clic en el botón "+" junto al campo "Valor de activación". Hay tres opciones disponibles:
Valor: Compara contra un número fijo que ingresas manualmente. Esta es la opción predeterminada.
Variable: Compara contra el valor en tiempo real de otra variable de Ubidots (también conocido como Umbral Dinámico). Por ejemplo, activa un evento cuando el valor de una variable es mayor que el de otra. Disponible desde el plan Industrial en adelante.
Nota: Es importante tener en cuenta que al actualizar un evento con un umbral dinámico, la variable seleccionada como ese umbral debe recibir una nueva actualización de datos después de que se guarden los cambios. Si la variable de umbral no se actualiza después del cambio más reciente en el evento, el evento no se activará.
Entidad: Compara contra una propiedad del dispositivo o de la variable en lugar de un valor en tiempo real, permitiendo que el activador se adapte automáticamente a la configuración propia de cada dispositivo. Disponible desde el plan Enterprise.
Usar la opción Entidad:
Asegúrate de que ya haya una variable seleccionada en el campo Variable en la parte superior del activador — la opción Entidad resuelve las propiedades en relación con esa variable y su dispositivo principal, por lo que no tendrá nada de donde extraer información hasta que se elija una variable.
Haz clic en el "+" junto a "Valor de activación" y selecciona Entidad.
Aparece un nuevo menú desplegable, con Dispositivo como opción predeterminada, que te permite elegir el alcance de la propiedad:
Dispositivo: Extrae las propiedades del dispositivo al que pertenece la variable seleccionada.
Variable: Extrae las propiedades de la variable seleccionada en sí.
Un segundo campo lista las propiedades disponibles para ese alcance; selecciona la que deseas usar como referencia de comparación (por ejemplo, un valor de calibración o un límite configurado).
Nota: Si aún no se ha seleccionado ninguna variable, o si el dispositivo o variable seleccionados no tienen propiedades configuradas, el segundo campo mostrará "No se encontraron propiedades". Si ya seleccionaste una variable y aún ves este mensaje, confirma que el dispositivo o la variable realmente tenga propiedades configuradas en su configuración. |
2.2. Acciones
Después de configurar la pestaña "activadores" y hacer clic en "siguiente", pasarás a la pestaña "acciones". Allí podrás seleccionar y configurar la acción que se ejecutará cuando el evento se active.
Paso 4: Haz clic en el botón "+ agregar acción" para iniciar este proceso. Estas son las opciones disponibles:
Para una explicación detallada sobre cómo funciona y cómo configurar cada acción, visita su artículo correspondiente (enlazado arriba).
2.3. Configuración
Paso 5: Tras completar la configuración de la acción y hacer clic en "siguiente", verás la pestaña "Configuración", con las siguientes opciones:
Nombre.
Descripción.
Etiquetas: Esta es una excelente manera de controlar lo que tus usuarios finales ven en tu app. En este caso, podrías decidir que tu usuario final vea un evento pero no otro, usando etiquetas. Aprende más sobre las etiquetas aquí.
Período de enfriamiento: este campo te permite silenciar las acciones del evento durante un tiempo determinado (en segundos) después de que el evento se activa.
Ventanas activas durante las cuales deben ejecutarse los eventos. Un evento puede tener múltiples ventanas activas haciendo clic en el botón "+ Agregar ventana" y configurándolas de forma correspondiente.
Notas:
Los eventos solo se activarán durante las ventanas activas que definas en este paso.
Una variable cuyos valores entrantes no bajen por debajo del umbral definido igualmente activará el evento cuando llegue un nuevo valor durante la siguiente ventana activa (como se muestra en la imagen a continuación).
Nota: Para obtener más información sobre cómo y cuándo se activan los eventos de Ubidots, consulta esta guía.
Paso 6: Haz clic en el botón "guardar" para terminar de crear el evento.