Las variables en Ubidots son los bloques de construcción fundamentales para tu aplicación IoT. Almacenan los "puntos" o datos con marca de tiempo que envías a Ubidots desde tus dispositivos IoT. Cada variable pertenece a un dispositivo y puede almacenar datos históricos, lo que te permite monitorear, analizar y visualizar tendencias a lo largo del tiempo. Este artículo explica todo lo que necesitas saber sobre las variables en Ubidots, incluyendo su creación, campos y características avanzadas.
Cómo Crear una Variable
Puedes crear variables en Ubidots de tres maneras:
1. Automáticamente, a través de la API (Recomendado)
Cada vez que envías datos a un dispositivo que no existe, Ubidots crea automáticamente tanto el dispositivo como las variables enviadas. Este método es rápido y escalable, especialmente para aplicaciones con múltiples variables o dispositivos.
2. Manualmente, en la Aplicación Web
Ve a la sección de Dispositivos en tu cuenta de Ubidots.
Selecciona un dispositivo o crea uno nuevo.
Haz clic en Agregar Variable y completa los campos requeridos, como el nombre de la variable.
3. Manualmente, a través de la API
Puedes crear variables enviando una solicitud HTTP POST a la API de Ubidots. Consulta la documentación de la API de Ubidots para obtener instrucciones detalladas y ejemplos.
Campos de la Variable
Los siguientes campos se pueden editar a través de la aplicación web. Consulta nuestra documentación de la API para aprender sobre campos ocultos como el color de la variable:
Campo | Descripción |
Nombre | El nombre de la variable. |
Descripción | (Opcional) Un breve resumen o nota sobre el propósito o uso de la variable. |
Ícono | Una representación visual de la variable para facilitar su identificación en los dashboards. Usa cualquier etiqueta de ícono de Fontawesome v6. |
Etiqueta de API | Un identificador único utilizado para referenciar la variable en llamadas a la API. |
ID | Un identificador único generado por el sistema para la variable. |
Rango Permitido | (Opcional) Los valores mínimo y máximo aceptables para esta variable. Ayuda a filtrar datos inválidos o fuera de rango. |
Etiquetas | (Opcional) Palabras clave que categorizan y agrupan variables para facilitar el filtrado y la organización. |
Pre-procesamiento | (Opcional) Inclinación y Desplazamiento aplicados a los datos entrantes para ajustar los valores dinámicamente. |
Unidad | (Opcional) La unidad de medida para la variable (por ejemplo, °C, %, kg). |
Última Actividad | La marca de tiempo del último punto de datos recibido para esta variable. |
Función de "Rango Permitido"
Establecer un rango permitido asegura la integridad de tus datos al filtrar valores que son demasiado altos, demasiado bajos o de otro modo inválidos. Por ejemplo, un sensor de temperatura podría enviar lecturas solo entre -40°C y 125°C. Al definir este rango, puedes evitar que valores atípicos distorsionen tu análisis de datos o desencadenen alertas incorrectas.
Pre-procesamiento: Agregando Inclinación y Desplazamiento
El pre-procesamiento te permite ajustar los valores de datos en bruto utilizando una simple transformación lineal:
Valor Ajustado = (Valor en Bruto × Inclinación) + Desplazamiento
Por ejemplo, imagina que un sensor envía datos de voltaje en bruto que varían de 0 a 5V, pero deseas que los datos se muestren en términos de presión, que varían de 0 a 100 PSI. Establece la inclinación en 20 (100 PSI ÷ 5V) y el desplazamiento en 0, de modo que el valor en bruto entrante se escale automáticamente para coincidir con el rango deseado.
Esta función simplifica los cálculos posteriores y asegura consistencia en tus datos.
Para cálculos más avanzados, puedes aprovechar las Variables Sintéticas.
Exportando Datos de Variables de Ubidots
Ubidots facilita la exportación de datos de variables para análisis externos o mantenimiento de registros. Puedes exportar datos de dos maneras:
1. A través de la Aplicación Web
Navega a la sección de Dispositivos y selecciona un dispositivo.
Haz clic en la variable que deseas exportar.
Utiliza la opción Exportar Datos para descargar los datos como un archivo CSV.
2. A través de la API
Utiliza nuestra API para obtener los datos de una variable: