Guía de inicio rápido

Esta guía le ayudará a configurar rápidamente su primer flujo de datos en IoT Logic y comenzar a procesar sus datos de telemática.

Requisitos previos

Antes de proceder con la creación de su primer flujo, asegúrese de contar con:

• Un(a) Propietario rol en su cuenta de Navixy

• Dispositivos activados en su cuenta

• Comprensión de qué fuentes de datos desea procesar

El espacio de trabajo de IoT Logic está disponible solo para la cuenta Propietarios y no se muestra para los Usuariosregulares. Para más detalles sobre los roles de usuario, consulte Usuarios y roles.

Configuración del flujo

Vea un breve video que muestra el proceso de creación de un nuevo flujo con cálculos de atributos de datos y la adición de atributos personalizados a los dispositivos en la plataforma:

Proceso de creación de un nuevo flujo con cálculos de atributos de datos y adición de atributos personalizados a los dispositivos en la plataforma

Ahora, desglosaremos el proceso de configuración del flujo paso a paso.

1

Paso 1: Acceder al espacio de trabajo de IoT Logic

1. Inicie sesión en su cuenta de Navixy

2. Haga clic en el ícono de su perfil en la esquina superior izquierda de la pantalla para acceder a Ajustes de cuenta

3. Seleccione IoT Logic en la barra lateral de ajustes

El espacio de trabajo de IoT Logic aparece con tres secciones principales:

• Barra de ajustes del flujo - Contiene controles para gestionar los flujos

• Panel de nodos - Lista los nodos disponibles para construir su flujo

• Lienzo - El área de trabajo principal donde diseña su flujo

Para más detalles sobre el espacio de trabajo, consulte Espacio de trabajo y flujo predeterminado.

2

Paso 2: Crear un nuevo flujo

1. Haga clic en el New flow botón en la barra de ajustes del flujo

2. En el New flow diálogo:

• Introduzca un nombre descriptivo para su flujo (por ejemplo, "Procesamiento de telemetría de flotas")

• Agregue una breve descripción que explique el propósito del flujo

• Asegúrese de que el Flow enabled el interruptor está en ON

1. Haga clic en Guardar para crear el flujo

Para información adicional sobre la configuración del flujo, consulte Gestión de flujos -> Creación de un nuevo flujo.

Los flujos deshabilitados no procesan ningún dato. Cuando un flujo está deshabilitado, los dispositivos en ese flujo no transmitirán datos a ningún destino, incluida la plataforma Navixy.

3

Paso 3: Configurar un nodo Data Source

1. Desde el Nodes panel, arrastre un nodo Data Source al lienzo

2. Pase el cursor sobre el nodo para mostrar acciones rápidas, o haga doble clic en el nodo para abrir su panel de configuración

3. Configure los siguientes ajustes:

• Nombre del nodo - Introduzca un nombre descriptivo, especificando el origen de los datos enviados (por ejemplo, Vehículos del personal)

• Fuentes - Seleccione los dispositivos cuyos registros desea enviar a este flujo. Puede filtrar sus dispositivos disponibles por Fabricante y Modelo.

1. Haga clic en Guardar para aplicar la configuración

Para más detalles sobre la configuración del nodo, consulte Nodo Fuente de datos.

4

Paso 4: Agregar enriquecimiento de datos (Opcional)

1. Arrastre un Initiate Attribute al lienzo

2. Pase el cursor sobre el nodo para mostrar acciones rápidas, o haga doble clic en el nodo para abrir su panel de configuración

3. Agregue un(a) Nombre del nodo descriptivo(a) para especificar su propósito y los cálculos que realiza (por ejemplo, Temperatura °F a °C)

4. Defina su atributo:

   1. Nombre del atributo - Un nombre claro y descriptivo (por ejemplo, "speed_mph")

   2. Fórmula - La expresión de cálculo (por ejemplo, value('speed')/1.609 para convertir km/h a mph) 💡Nota: Los nombres de atributos pueden autocompletarse para garantizar una nomenclatura correcta. El autocompletado utiliza una sintaxis corta por defecto, que se refiere al último valor del atributo.

   3. Hora de generación - Cuándo se creó la entrada de datos en el dispositivo (valor predeterminado now())

   4. Hora del servidor - Cuándo se recibieron los datos en el servidor (valor predeterminado now())

5. Agregue atributos adicionales si es necesario haciendo clic en Agregar atributo 💡Nota: El botón Restablecer formulario descarta todos los atributos creados dentro de un nodo. Si desea eliminar un atributo en particular, haga clic en los tres puntos a la derecha de la fila del atributo y seleccione Eliminar.

6. Haga clic en Guardar para aplicar la configuración

7. Crear una conexión:

   1. Haga clic en el conector de salida del Data Source nodo

   2. Arrastre la transición al conector de entrada del Initiate Attribute nodo

Para más detalles sobre la configuración del nodo, consulte Nodo Iniciar Atributo.

Para más detalles sobre las acciones con atributos, consulte Gestión de atributos.

Para fórmulas de cálculo de ejemplo, consulte Ejemplos de cálculos.

5

Paso 5: Configurar la salida de datos

1. Arrastre un Punto final de salida al lienzo

2. Pase el cursor sobre el nodo para mostrar acciones rápidas, o haga doble clic en el nodo para abrir su panel de configuración

3. Seleccione Tipo de endpoint:

• Navixy endpoint - endpoint predeterminado para enviar datos procesados a la plataforma Navixy. Está preconfigurado y no permite cambios

• MQTT endpoint - endpoint para enviar datos a destinos de terceros, utilizando MQTT como protocolo de transporte. Requiere configuración manual descrita en pasos posteriores

Los endpoints creados dentro de la cuenta están disponibles como Preajustes. Puede seleccionar una configuración ya existente en lugar de configurarla desde cero. Navixy Output Endpoint está siempre disponible como preajuste.

1. Configure los siguientes ajustes:

   1. Nombre del endpoint - Introduzca un nombre descriptivo para especificar el destino al que se envían los datos

   2. Protocolo - Seleccione el protocolo de datos (solo "Navixy Generic Protocol (JSON)" está disponible por el momento)

   3. IP/Dominio - Introduzca la dirección de destino

   4. Puerto - Especifique el número de puerto (predeterminado: 1883 para MQTT estándar, 8883 para SSL)

   5. (opcional) Habilitar SSL - Active ON para conexiones seguras

   6. Versión de MQTT - Seleccione la versión apropiada (3.1.1 o 5.0)

   7. Client ID - Introduzca el identificador para su cliente a fin de garantizar que los datos sean aceptados por la parte receptora

   8. (opcional) Topics - Especifique los temas MQTT para la transmisión de datos

   9. QoS - Seleccione el nivel de Quality of Service para determinar la lógica de transmisión de datos (0, 1, o 2)

2. Si se requiere autenticación en el lado receptor, active Autenticación MQTT ON Los campos que aparecen se completan automáticamente con las credenciales de su cuenta de la plataforma

El Restablecer formulario descarta todos los atributos creados dentro de un nodo. Si desea eliminar un atributo en particular, haga clic en los tres puntos a la derecha de la fila del atributo y seleccione Eliminar.

1. Haga clic en Crear para aplicar la configuración

2. Conecte sus otros nodos a este nodo de salida en el orden necesario para finalizar la estructura del flujo

Cada flujo debe incluir un nodo Default Endpoint para asegurar que los datos se envían a la plataforma. Sin esta conexión, los datos del dispositivo no serán visibles en la interfaz de Navixy.

Para más detalles sobre la configuración del nodo, consulte Nodo Punto final de salida.

6

Paso 6: Guardar y activar su flujo

1. Verifique que todos los nodos estén correctamente conectados en su flujo

2. Haga clic en el Guardar flujo botón en el Nodes panel

¡Su flujo ahora está activo y procesando datos en tiempo real!

Validación del flujo

Para confirmar que su flujo funciona correctamente, utilice la herramienta Data Stream Analyzer :

1. Haga clic en el Analizador de datos botón en la barra de ajustes del flujo

2. Seleccione los dispositivos que desea monitorear de la lista desplegable

3. Observe los atributos de datos entrantes y sus valores

4. Utilice las opciones de filtrado para centrarse en parámetros específicos

5. Verifique que cualquier atributo calculado muestre los valores correctos

Para más detalles sobre el uso de la herramienta, consulte Data Stream Analyzer.

¡Felicidades! Su primer flujo de datos de IoT Logic está en funcionamiento.

Próximos pasos

Ahora que ha creado su primer flujo de IoT Logic, puede:

• Adaptar este ejemplo de inicio rápido a las necesidades de su negocio

• Crear transformaciones de datos más complejas con múltiples nodos Initiate Attribute

• Configurar destinos de salida adicionales para sus datos que pueden convertirse en perfiles reutilizables para configuraciones coherentes

• Gestionar flujos ya creados para ajustar el procesamiento de datos a cualquier cambio que enfrente

• Diseñar flujos avanzados para escenarios de negocio específicos utilizando diferentes combinaciones y configuraciones de nodos

Adaptando este ejemplo

Este ejemplo se puede adaptar a varios casos de uso de la industria modificando:

• Selección de dispositivos: Elija dispositivos relevantes para sus activos específicos

• Conversiones de unidades: Ajuste las fórmulas según sus unidades de medida estándar

• Métricas calculadas: Cree indicadores específicos de la industria según las necesidades de su negocio

• Configuración de salida: Conéctese a su plataforma de análisis o base de datos específica

El patrón fundamental de recopilar, transformar y reenviar se mantiene consistente en todas las industrias, lo que convierte a este en un modelo versátil para el procesamiento de datos de IoT.

Acceso a la API

La funcionalidad de IoT Logic también puede accederse programáticamente a través de la API de Navixy. Esto permite a los desarrolladores automatizar la creación, gestión y monitorización de flujos.

Por razones de seguridad, el acceso a la API requiere permisos adecuados. Póngase en contacto con el administrador de su cuenta para asegurarse de que dispone de los derechos de acceso necesarios.

Para la documentación completa de la API, parámetros, formatos de solicitud/respuesta y ejemplos de código, consulte la Documentación de la API de Navixy IoT Logic.

Preguntas frecuentes

¿Qué sucede con los dispositivos no asignados a un flujo personalizado?

Los dispositivos no asignados explícitamente a ningún flujo personalizado se gestionan automáticamente mediante el flujo predeterminado, que envía sus datos directamente a la plataforma Navixy.

¿Puedo usar el mismo dispositivo en múltiples flujos?

No, cada dispositivo solo puede asignarse a un flujo a la vez. Cuando se añade a un flujo personalizado, un dispositivo se elimina automáticamente del flujo predeterminado para evitar el procesamiento duplicado de datos.

¿Mi flujo seguirá funcionando si cierro sesión?

Sí, una vez activados, los flujos operan de forma independiente de su sesión de usuario. Mientras el flujo esté habilitado, procesará datos incluso cuando no haya iniciado sesión.

¿Cómo sé si mi flujo funciona correctamente?

Utilice el Data Stream Analyzer para monitorear la transmisión de datos en tiempo real. Esta herramienta muestra tanto los datos sin procesar del dispositivo como los atributos calculados, lo que le permite verificar que sus transformaciones funcionen según lo esperado.

¿Qué sucede si deshabilito un flujo?

Cuando deshabilita un flujo, los dispositivos asignados a ese flujo no transmitirán datos a ningún destino, incluida la plataforma Navixy. Los dispositivos aparecerán como desconectados en la interfaz de Navixy hasta que vuelva a habilitar el flujo.