Las variables en Ubidots son los bloques fundamentales de tu aplicación IoT. Almacenan los "dots" o puntos de 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, incluida su creación, campos y funcionalidades avanzadas.

1. Cómo crear una variable

Puedes crear variables en Ubidots de tres maneras:

1.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.

1.2. Manualmente, en la aplicación web

Ve a la sección 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.

1.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.

2. 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 conocer los campos ocultos:

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 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.
Preprocesamiento	(Opcional) Pendiente y desplazamiento aplicados a los datos entrantes para ajustar dinámicamente los valores. (Opcional) Redondeo aplicado a las marcas de tiempo de los datos entrantes.
Unidad	(Opcional) La unidad de medida de la variable (por ejemplo, °C, %, kg).
Última actividad	La marca de tiempo del último punto de datos recibido para esta variable.

2.1. Funcionalidad "Rango permitido"

Configurar un rango permitido garantiza la integridad de tus datos al filtrar valores demasiado altos, demasiado bajos o 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 activen alertas incorrectas.

2.2. Preprocesamiento

Agregar pendiente y desplazamiento

Puedes ajustar los valores de los datos crudos usando una transformación lineal simple:

Valor ajustado = (Valor crudo × Pendiente) + Desplazamiento

Por ejemplo, imagina que un sensor envía datos de voltaje crudos en un rango de 0–5 V, pero deseas que los datos se muestren en términos de presión, en un rango de 0–100 PSI.

Configura la pendiente en 20 (100 PSI ÷ 5 V) y el desplazamiento en 0, de modo que el valor crudo entrante se escale automáticamente para coincidir con el rango deseado.

Esta funcionalidad simplifica los cálculos posteriores y garantiza la consistencia de tus datos.

Redondear marca de tiempo

Puedes homogeneizar las marcas de tiempo de tus datos entrantes para facilitar los cálculos y el análisis de datos, sin depender de funciones de Variables Sintéticas.

Al seleccionar una unidad de tiempo (segundos, minutos u horas) y un valor, las marcas de tiempo entrantes se normalizan truncándolas al inicio del intervalo de tiempo correspondiente. Esto garantiza marcas de tiempo consistentes y equidistantes según la configuración que definas.

Ejemplo en segundos

Valor: 30
Unidad: Segundos

Marca de tiempo original	Marca de tiempo redondeada
2025-05-15 13:06:42	2025-05-15 13:06:30
2025-05-15 13:07:06	2025-05-15 13:07:00
2025-05-15 13:07:41	2025-05-15 13:07:30

Ejemplo en minutos

Configuración:

Valor: 5
Unidad: Minutos

Marca de tiempo original	Marca de tiempo resultante
2025-05-15 13:02:18	2025-05-15 13:00:00
2025-05-15 13:04:59	2025-05-15 13:00:00
2025-05-15 13:07:10	2025-05-15 13:05:00

Ejemplo en horas

Configuración:

Valor: 1
Unidad: Horas

Marca de tiempo original	Marca de tiempo resultante
2025-05-15 14:25:00	2025-05-15 14:00:00
2025-05-15 14:59:59	2025-05-15 14:00:00
2025-05-15 15:01:12	2025-05-15 15:00:00

Notas importantes:

El redondeo de marcas de tiempo funciona truncando las marcas de tiempo entrantes al inicio del intervalo configurado. No redondea al intervalo más cercano ni avanza al siguiente intervalo.
Si se reciben múltiples puntos de datos para la misma variable dentro del mismo intervalo de tiempo, compartirán la misma marca de tiempo. Dado que Ubidots permite solo un valor por marca de tiempo por variable, los valores más recientes sobrescribirán a los anteriores.

Para cálculos más avanzados, puedes aprovechar las Variables Sintéticas.

3. Exportar datos de variables de Ubidots

Ubidots facilita la exportación de datos de variables para análisis externos o para fines de registro. Puedes exportar datos de dos maneras:

3.1. A través de la aplicación web

Navega a la sección 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.

3.2. A través de la API

Usa nuestra API para obtener los datos de una variable:

¿Qué son las Variables?