Gestión de atributos

El Iniciar Atributo El nodo le permite crear, editar y administrar atributos de datos a lo largo de su flujo IoT Logic. Esta guía cubre las acciones básicas de gestión de atributos (crear, editar, eliminar) y las operaciones esenciales, incluida la funcionalidad de autocompletar para la creación de fórmulas.

Creación de atributos

Así es como se crea un nuevo atributo en el nodo Iniciar atributo:

1

Agregar nuevo atributo

Haga clic en el Agregar atributo botón

2

Nombre del atributo

Ingrese un nombre para su atributo (por ejemplo, "Speed mph"). Este nombre se mostrará en Data Stream Analyzer y actuará como un nombre de sensor personalizado en Navixy.

3

Definir fórmula

Defina la expresión de valor. Para crear fórmulas más rápidamente, utilice autocompletar.

La sintaxis corta es la opción predeterminada para nombres de atributos autocompletados en fórmulas, y también puede usarla para la entrada manual de fórmulas. Al hacer referencia únicamente al último valor válido de un atributo, puede omitir la sintaxis completa de value() y las comillas. Por ejemplo, la fórmula de conversión de temperatura puede escribirse como temperature*1.8 + 32 en lugar de value('temperature', 0, 'valid')*1.8 + 32.

4

Agregar configuraciones de tiempo (opcional)

Opcionalmente, configure la hora de generación y la hora del servidor; para hacerlo, active el Especificar atributos de tiempo interruptor Para más detalles, consulte Configuraciones de tiempo para atributos

5

Finalizar configuración

Haga clic en Guardar para confirmar la configuración del nodo

El nuevo atributo se guarda en el nodo y el cálculo configurado se aplica inmediatamente en el flujo.

Configuraciones de tiempo para atributos

Las configuraciones de tiempo le dan control sobre las marcas de tiempo asociadas con sus atributos:

• Hora de generación: Cuándo se creó el dato

  • Use now() para establecer la hora actual en milisegundos

  • Use genTime('parameter_name', 0, 'valid') para usar la propia hora de generación del parámetro

• Hora del servidor: Cuándo se recibió el dato por IoT Logic

  • Use now() para establecer la hora actual en milisegundos

  • Use srvTime('parameter_name', 0, 'valid') para usar la hora del servidor del parámetro

  • Agregue compensaciones para ajustar las zonas horarias (por ejemplo, srvTime('can_speed', 0, 'valid') + 120000 agrega 2 minutos)

Las configuraciones de tiempo son importantes para el análisis de datos y la sincronización. Una configuración de tiempo adecuada asegura que sus datos mantengan la integridad cronológica a lo largo del flujo.

Autocompletar nombres de atributos

Al crear fórmulas de cálculo, necesita referenciar nombres de atributos existentes desde dispositivos físicos o atributos calculados de otros nodos. Para simplificar este proceso y evitar errores tipográficos, IoT Logic proporciona la funcionalidad de autocompletar para nombres de atributos.

Para usar el autocompletar al construir fórmulas:

1. Haga clic en en el Fórmula campo.

2. Seleccione el atributo deseado de la lista que aparece; la lista admite la entrada manual de texto para fines de búsqueda.

3. Haga clic en el nombre del atributo para insertarlo en su fórmula.

El atributo seleccionado se inserta automáticamente en el formato listo para usar, empleando la sintaxis corta del Lenguaje de Expresiones IoT Logic de Navixy. Esto significa que las entradas autocompletadas acceden a cualquier último valor del atributo seleccionado.

Puede modificar los parámetros según sea necesario: cambie el número de índice para valores históricos o ajuste la bandera de validez. Para hacerlo, necesita definir la fórmula usando la sintaxis completa explícitamente, dentro de la vaue() función.

La lista se filtra en función de las fuentes de datos de su flujo y coincide con lo que es visible en Data Stream Analyzer.

La lista de autocompletar muestra solo atributos que cumplen todas las siguientes criterios simultáneamente:

• Soportado por dispositivos - El atributo debe ser compatible con al menos un dispositivo actualmente agregado a su flujo

• Transmitido realmente - El dispositivo debe haber enviado datos reales para este atributo (no solo soportarlo teóricamente)

• Disponible en el flujo - Esto incluye tanto parámetros del dispositivo como atributos calculados desde otros Iniciar Atributo nodos dentro del mismo flujo

Ejemplo: Si su dispositivo soporta tanto sensores de velocidad como de temperatura pero solo ha transmitido datos de velocidad (quizá debido a un sensor de temperatura defectuoso), la lista de autocompletar mostrará el atributo 'speed' pero no 'temperature'. El atributo de temperatura solo aparecerá una vez que el dispositivo envíe lecturas de temperatura reales, aunque el dispositivo lo soporte técnicamente.

Atributos indexados en autocompletar

Algunos atributos de datos contienen múltiples valores indexados dentro de un solo atributo, como lecturas de múltiples sensores analógicos conectados a un dispositivo telemático principal. Para usar estos atributos en cálculos, debe especificar el número de índice exacto correspondiente al sensor específico o entrada que desea referenciar.

Por ejemplo, si necesita trabajar con lecturas de voltaje del tercer ingreso analógico en su dispositivo, estos datos llegan a través del atributo analog_2 (usando indexación basada en cero donde la primera entrada es el índice 0). En su fórmula, esto aparecería como value('analog_2', 0, 'valid').

Autocompletar también gestiona este escenario por usted:

• Los atributos indexados están marcados con icono en la lista de autocompletar.

• Estas entradas muestran el rango de índices disponible entre corchetes, por ejemplo analog_[1..4] para atributos que soportan cinco valores indexados (índices del 1 al 4).

• Cuando selecciona un atributo indexado, el cursor se posiciona automáticamente al final del nombre del atributo dentro de las comillas, permitiéndole escribir inmediatamente el número de índice específico que necesita.

Lenguaje de expresiones

Todas las fórmulas en IoT Logic siguen las especificaciones de Navixy IoT Logic Expression Language. A continuación, encontrará una breve referencia de la sintaxis del lenguaje.

Sintaxis corta

La opción de fórmula corta accede al último valor del atributo, sin verificar la validez. Es útil cuando no necesita valores históricos en una fórmula y no desea filtrar null valores.

Autocompletar la función siempre usa la sintaxis corta.

Sintaxis: attribute_name

Valores predeterminados:

• Índice: 0 (valor actual)

• Validación: 'all' (incluye valores nulos)

Por ejemplo, la forma corta temperature equivale a la fórmula completa value('temperature', 0, 'all'). Esto significa que puede crear cálculos fácilmente sin agregar explícitamente los parámetros predeterminados:

temperature * 1.8 + 32

Sintaxis completa

Usar la sintaxis completa de la fórmula le permite acceder a valores históricos o a un modo de validación explícito. Esto ayuda cuando necesita usar valores que no son los más recientes y manejar nulos. En el caso de la sintaxis completa, debe definir la value() función.

Función: value(attribute_name, index, validation)

Parámetros:

Parámetro	Rango/Valores	Descripción
attribute_name	Cualquier atributo válido	Nombre exacto de la telemetría del dispositivo (puede ser autocompletado)
índice	0-12	Posición histórica: 0=actual, 1=anterior, 12=hace 12 lecturas
validación	'all' o 'valid'	'all'=incluye nulos (índice exacto), 'valid'=excluye nulos (la N-ésima lectura válida)

Ejemplos:

• Cualquier lectura anterior

value('temperature', 1, 'all')

• 5.ª lectura válida hacia atrás

value('speed', 5, 'valid')

• Cambio de temperatura (sintaxis corta y completa usadas en la misma fórmula)

temperature - value('temperature', 1, 'all')

Para más ejemplos de fórmulas, consulte Ejemplos de cálculos.

Editar atributos existentes

Para modificar un atributo existente:

1. Abra la ventana de configuración del nodo pasando el ratón sobre el nodo para mostrar acciones rápidas, o haciendo doble clic en el nodo

2. Encuentre el atributo que desea editar en la lista de atributos

3. Realice los cambios necesarios en los campos de texto de las propiedades del atributo: Nombre del atributo, Fórmula o configuraciones de tiempo

4. Si necesita editar otros atributos en este nodo, repita el paso 3 para ellos

5. Haga clic en Guardar para aplicar sus cambios a la configuración del nodo

Cuando edita un atributo, los cambios solo se aplicarán a los datos nuevos recibidos después de guardar. Los datos históricos ya recopilados no se recalcularán.

Eliminar atributos

Para eliminar un atributo que ya no es necesario:

1. Abra la ventana de configuración del nodo pasando el ratón sobre el nodo para mostrar acciones rápidas, o haciendo doble clic en el nodo

2. Encuentre el atributo que desea eliminar en la lista de atributos y pase el ratón sobre él para mostrar un menú

3. Haga clic en el menú que apareció y seleccione Eliminar

4. Confirme su decisión de eliminar el atributo

5. Haga clic en Guardar para aplicar sus cambios a la configuración del nodo

Cuando elimina un atributo, ya no se calculará para datos nuevos, pero los datos históricos que contienen este atributo permanecerán sin cambios en la base de datos.