# 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

{% hint style="info" %}
El espacio de trabajo de IoT Logic está disponible solo para la cuenta **Propietarios** y no se muestra para los **Usuarios**regulares. Para más detalles sobre los roles de usuario, consulte [Usuarios y roles](https://www.navixy.com/docs/user/es/guide/account/users-and-roles).
{% endhint %}

## 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:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2FGAVD9gNxaRYpHDSAlOmf%2FIot%20Logic%20Demo%20Screencast.mp4?alt=media&token=94fd4cf6-bd45-4953-9263-52863288d9b9>" %}
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
{% endembed %}

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

{% stepper %}
{% step %}

### 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](https://www.navixy.com/docs/user/es/guide/account/iot-logic/workspace-and-default-flow).
{% endstep %}

{% step %}

### 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

3. 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](https://www.navixy.com/docs/user/es/guide/account/flow-management#creating-a-new-flow).

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}

{% step %}

### 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**.

4. Haga clic en **Guardar** para aplicar la configuración

Para más detalles sobre la configuración del nodo, consulte [Nodo Fuente de datos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/data-source-node).
{% endstep %}

{% step %}

### 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)\
      :bulb:**Nota**: Los nombres de atributos [pueden autocompletarse](https://www.navixy.com/docs/user/es/guide/account/flow-management/initiate-attribute-node/managing-attributes#autofill-attribute-names) 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**\
   :bulb:**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](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/initiate-attribute-node).

Para más detalles sobre las acciones con atributos, consulte [Gestión de atributos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/initiate-attribute-node/managing-attributes).

Para fórmulas de cálculo de ejemplo, consulte [Ejemplos de cálculos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/initiate-attribute-node/calculation-examples).
{% endstep %}

{% step %}

### 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

{% hint style="info" %}
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.
{% endhint %}

4. 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**)
5. 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

{% hint style="danger" %}
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**.
{% endhint %}

6. Haga clic en **Crear** para aplicar la configuración
7. Conecte sus otros nodos a este nodo de salida en el orden necesario para finalizar la estructura del flujo

{% hint style="info" %}
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.
{% endhint %}

Para más detalles sobre la configuración del nodo, consulte [Nodo Punto final de salida](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/output-endpoint-node).
{% endstep %}

{% step %}

### 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

{% hint style="success" %}
¡Su flujo ahora está activo y procesando datos en tiempo real!
{% endhint %}
{% endstep %}
{% endstepper %}

## 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](https://www.navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer).

{% hint style="success" %}
¡Felicidades! Su primer flujo de datos de IoT Logic está en funcionamiento.
{% endhint %}

## Próximos pasos

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

* [Adaptar este ejemplo de inicio rápido](#adapting-this-example) a las necesidades de su negocio
* Crear transformaciones de datos más complejas con múltiples [nodos Initiate Attribute](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/initiate-attribute-node)
* Configurar destinos de [salida adicionales](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/output-endpoint-node) para sus datos que pueden convertirse en perfiles reutilizables para configuraciones coherentes
* [Gestionar flujos ya creados](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management) para ajustar el procesamiento de datos a cualquier cambio que enfrente
* [Diseñar flujos avanzados](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/flow-configuration-example) 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.

{% hint style="info" %}
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.
{% endhint %}

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](https://app.gitbook.com/o/YVLWhgAwCZPoU5vlRsCs/s/tx3J5BxnWyPV0nP2xr0z/).

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