Tener cientos o miles de dispositivos — y las variables que les pertenecen — puede sentirse como montañas de datos que abrumarían a cualquiera. Con las Propiedades, puedes agregar rápidamente metadatos a tus dispositivos y variables de Ubidots para organizar, recuperar y trabajar eficientemente con datos provenientes de cientos de fuentes diferentes.
1. ¿Qué son las Propiedades?
Por definición, las propiedades son metadatos, o "un conjunto de datos que describe y proporciona información sobre otros datos". En Ubidots, las propiedades son los metadatos que describen un dispositivo, una variable o sus configuraciones. Las propiedades no son variables, ni son los valores que una variable recopila.
Una Variable es el sensor específico o flujo de datos digitales que proporciona información sobre un sistema o proceso, y se actualiza con regularidad.
Las Propiedades son los atributos específicos de identificación o descripción de un dispositivo o variable — su ubicación, características o detalles de configuración. Las propiedades tienden a no cambiar y no se almacenan como datos de series de tiempo.
Tipo de dato | Propiedades (de Dispositivo o Variable) | Variables de Dispositivo |
Definición |
|
|
Ejemplos | Propiedades de dispositivo (predeterminadas):
Propiedades de dispositivo (definidas por el usuario):
Propiedades de variable (definidas por el usuario):
| Variables definidas por el usuario:
|
Las Propiedades de Ubidots te permiten agregar una capa de metadatos personalizados a tus dispositivos y variables para una identificación, organización y usabilidad eficientes — ya sea que estés gestionando metadatos a nivel de dispositivo (por ejemplo, dónde está instalado un activo) o a nivel de variable (por ejemplo, qué modelo de sensor produce una lectura específica).
2. Agregar nuevas Propiedades a un Dispositivo
Para agregar una nueva propiedad a un dispositivo, haz clic en tu dispositivo, luego desplázate hacia abajo en el panel de opciones del dispositivo en el lado izquierdo hasta que veas la sección "Propiedades". En la parte inferior del panel encontrarás "+ AGREGAR PROPIEDAD".
Haz clic en "Agregar Propiedad". Aparecerá un panel lateral donde podrás especificar el nombre, la descripción y el formato de la propiedad.
Formatos admitidos
Texto: Una cadena de texto de hasta 255 caracteres.
Lista: Una lista de cadenas de texto, presentadas como valores individuales en un menú desplegable.
Número: Un número decimal.
Verdadero o Falso: Un valor booleano.
Fecha
JSON: Un objeto JSON que puede usarse como payload en tus eventos.
Dispositivo: Un dispositivo que puede funcionar como "dispositivo global".
La descripción que proporciones aparecerá como un ícono de información junto al nombre de la propiedad — haz clic en él para ver la descripción completa de la propiedad.
Para editar una propiedad, simplemente haz doble clic en su valor.
Puede que quieras revisar los Tipos de Dispositivos de Ubidots para especificar un conjunto predeterminado de Propiedades para cualquier nuevo dispositivo que se incorpore a Ubidots.
Puede que quieras revisar los Tipos de Dispositivos de Ubidots para especificar un conjunto predeterminado de propiedades para cualquier nuevo dispositivo que se incorpore a Ubidots. |
3. Agregar nuevas Propiedades a una Variable
El mismo flujo de trabajo aplica ahora para las variables. Abre cualquier variable, luego desplázate hacia abajo en el panel de opciones de la variable en el lado izquierdo — por debajo de campos como Descripción, Ícono, Etiqueta de API, ID, Rango permitido y Etiquetas — hasta que veas la sección "Propiedades".
Haz clic en "+ AGREGAR PROPIEDAD" en la parte inferior del panel:
Al hacerlo, se abre el mismo panel "Agregar Propiedad" utilizado para los dispositivos, con el nombre de la variable mostrado en la parte superior:
Nombre (requerido)
Clave
Descripción
Formato — las mismas opciones disponibles para dispositivos: Texto, Lista, Número, Verdadero o Falso, Fecha, JSON, Dispositivo
Valor
Completa los campos y haz clic en Guardar. La propiedad aparecerá listada en la sección de Propiedades de la variable y — al igual que con los dispositivos — puedes hacer doble clic en el valor de cualquier propiedad para editarla, y pasar el cursor sobre su descripción para ver más contexto.
3.1. ¿Por qué agregar propiedades a una variable en lugar de a un dispositivo?
Algunos metadatos pertenecen a un flujo de medición específico en lugar de al dispositivo en su conjunto. Por ejemplo, un dispositivo multisensor podría tener varias variables (temperatura, humedad, velocidad del viento), cada una necesitando sus propios metadatos:
Modelo o fabricante del sensor para esa medición específica
Fecha de calibración o último servicio para ese sensor en particular
La fuente o justificación de un umbral de alerta en esa variable
Notas de conversión de unidades o redondeo específicas de ese flujo de datos
En lugar de agrupar todo esto en propiedades a nivel de dispositivo (que describen el dispositivo en su conjunto), ahora puedes asociarlo directamente a la variable correspondiente.