Iniciar atributo

Cree nuevos atributos de datos a partir de la telemetría entrante usando el Lenguaje de Expresiones de Navixy. Cambie el nombre de los parámetros, aplique fórmulas y enriquezca los datos antes de reenviarlos.

Visión general técnica y capacidades

En IoT Logic, Iniciar atributo el nodo transforma las lecturas del dispositivo creando nuevos atributos de datos basados en la telemetría entrante. Este nodo le permite manipular datos mediante fórmulas matemáticas, cambiar el nombre de parámetros existentes y realizar operaciones a nivel de bits mediante el Navixy Expression Language. El nodo actúa como un componente clave en un flujo, lo que le permite enriquecer los datos antes de enviarlos a sus sistemas de destino.

Iniciar atributo El nodo se configura para cada flujo en la interfaz de usuario de la plataforma Navixy. Para conocer opciones específicas de sintaxis y una referencia detallada del lenguaje de expresiones, consulte Navixy Expression Language en la documentación del usuario.

Integración con la arquitectura del flujo

Iniciar atributo El nodo funciona dentro de la arquitectura del flujo proporcionando capacidades de transformación de datos y permitiendo:

• Procesar datos de telemetría en bruto en métricas de negocio significativas

• Crear campos calculados basados en múltiples valores de parámetros

• Convertir unidades de medida (p. ej., kilómetros a millas)

• Calcular diferencias entre lecturas actuales y anteriores

• Generar análisis basados en el tiempo del comportamiento del dispositivo

El nodo Iniciar atributo requiere al menos un Fuente de datos nodo conectado a él. No se realizarán cálculos sin conexiones de datos de entrada.

Capacidades del nodo

El Iniciar atributo El nodo por sí solo ofrece:

• Transformación de atributos de datos: Cree atributos completamente nuevos aplicando operaciones matemáticas a los que provienen de las fuentes de datos

• Conversión de unidades: Convierta unidades de medida (p. ej., velocidad de km/h a mph, o temperatura de °C a °F)

• Cálculos basados en el tiempo: Compare las lecturas actuales con los valores anteriores para determinar cambios

• Manipulación del tiempo: Personalice las marcas de tiempo de cuándo se generó el atributo en un dispositivo y cuándo lo recibió el servidor para evitar inconsistencias de tiempo y unificar los formatos de hora

• Búsqueda de zona: Escriba el nombre de la zona en la que se encuentra un dispositivo en un atributo con geofenceName(), una opción de pago. Consulte Funciones de zonas

Opciones de configuración

Iniciar atributo El nodo le permite definir cómo se transforman los parámetros del dispositivo en atributos, los cuales estarán disponibles para su procesamiento posterior en su flujo de datos.

Veamos qué elementos utiliza este nodo y qué puede configurar al trabajar con él:

Pasos de configuración

1

Especifique el nombre del nodo

Ingrese un nombre descriptivo para resaltar el propósito del nodo. Use un nombre que le ayude a identificar los cálculos que se realizarán dentro de este nodo; se mostrará en el diagrama de flujo para facilitar su identificación.

2

Definir nombre del atributo

Agregue un identificador distintivo del atributo.

• Este nombre se mostrará en Analizador de datos,

• También puede usar este nombre para crear sensores personalizados en el Seguimiento módulo. Para hacerlo, el Iniciar atributo nodo que contiene este atributo debe conectarse a un Nodo de Salida nodo configurado en modo Nodo de salida predeterminado .

3

Definir fórmula

Agregue expresiones matemáticas para calcular los valores de los atributos.

• Use value('parameter_name' 0, 'valid') formato para hacer referencia a parámetros existentes del dispositivo. Nota. Haga clic en dentro del campo Fórmula el campo para abrir la lista de atributos disponibles y seleccionar el necesario. Se agregará automáticamente al campo en un formato listo para usar. Para obtener detalles sobre el autocompletado de nombres de atributos, consulte Autocompletado de nombres de atributos.

• Aplique operaciones matemáticas basadas en Lenguaje de expresiones de Navixy IoT Logic para transformar los valores.

• Use diferentes valores de índice de profundidad para acceder a valores históricos (el valor predeterminado es 0).

• Maneje valores que podrían faltar. Si falta un valor que la fórmula necesita, la fórmula no produce nada y entonces el atributo no tiene valor para ese paquete. Consulte Valores faltantes en expresiones.

4

(opcional) Agregar más atributos

Haga clic en Agregar atributo para abrir un nuevo cuadro de diálogo de configuración de atributos. Aquí puede crear un nuevo atributo de datos si necesita que se realicen varios cálculos dentro del mismo nodo.

5

Guarde la configuración del nodo

Haga clic en Aplicar cambios para completar la creación del nodo.

Veamos un ejemplo práctico de configuración de atributos:

Este ejemplo crea un atributo que convierte la velocidad de kilómetros a millas por hora dividiendo el parámetro de velocidad CAN entre 1.609.

Para obtener detalles sobre los cálculos de los nuevos atributos, consulte Ejemplos de cálculo.

Además, puede encontrar un ejemplo detallado del uso de atributos calculados en un flujo en Ejemplo de configuración del flujo → pasos 3 y 4.

Opciones de visualización

Los nuevos atributos calculados dentro de Iniciar atributo un nodo pueden monitorearse igual que los atributos de datos reales que provienen de dispositivos en Analizador de datos (DSA) y el Seguimiento módulo.

Para obtener más información sobre las opciones de visualización, consulte Mostrar nuevos atributos calculados en la plataforma Navixy.

Consideraciones sobre el flujo de datos

Después de configurar su Iniciar atributo nodo, asegúrese de:

1. Conecte el nodo a por lo menos un Fuente de datos nodo como entrada

2. Conecte la salida a un Nodo de Salida nodo para enviar los datos transformados

Dentro del Iniciar atributo nodo, los valores de los parámetros se procesan según sus expresiones cada vez que el dispositivo proporciona datos. Como salida, recibirá:

• Todos los parámetros originales del dispositivo

• Todos los atributos calculados con sus valores

• Los valores actualizados del tiempo de generación y del tiempo del servidor, según la configuración

Si usa el mismo nombre para un atributo calculado que para un parámetro existente, el atributo reemplaza al parámetro original en el paquete de datos de salida.

Un atributo cuya fórmula no pudo calcularse no tiene valor para ese paquete. Nada lo marca como un error. Si el atributo usa el mismo nombre que un parámetro del dispositivo, el valor original del parámetro permanece en el paquete en su lugar, por lo que el paquete parece normal y el cálculo simplemente no se realizó. Consulte Valores faltantes en expresiones.

Preguntas frecuentes

¿Puedo hacer referencia a valores que no sean los más recientes en mis cálculos?

Sí. Use el parámetro index en la función value para acceder a valores históricos. Por ejemplo, value('temperature', 1, 'valid') se refiere al valor válido anterior del parámetro de temperatura.

¿Cómo realizo cálculos que involucran tiempo?

Use el encabezado genTime() y srvTime() funciones para trabajar con marcas de tiempo. Puede calcular diferencias de tiempo, agregar desplazamientos de tiempo o dar formato a las marcas de tiempo para su visualización.

¿Qué sucede si elimino un atributo?

El atributo ya no se calcula para los datos recibidos recientemente, pero los datos históricos permanecen sin cambios. El atributo no aparece en ningún paquete de datos nuevo después de su eliminación.

¿Puedo usar atributos creados en un nodo Iniciar atributo en otro?

Sí. Los atributos creados anteriormente en el flujo pueden referenciarse en los siguientes Iniciar atributo nodos, lo que permite realizar cálculos en varias etapas. Todos los atributos creados también están disponibles mediante la función de autocompletado para garantizar una nomenclatura correcta.

¿Cómo evito errores tipográficos al hacer referencia a nombres de atributos en las fórmulas?

Use la función de autocompletado en el campo Fórmula para seleccionar entre los atributos disponibles. Para obtener instrucciones detalladas, consulte Autocompletado de nombres de atributos.

¿Por qué a veces falta uno de mis atributos calculados?

No se pudo calcular la fórmula para esos paquetes, por lo general porque faltaba en el paquete un valor que esta lee. Entonces el atributo no tiene valor y no se informa ningún error. Consulte Valores faltantes en expresiones.