# Nó de ação

## Visão técnica geral e capacidades

{% columns %}
{% column width="50%" %}
**Ação** os nós no IoT Logic permitem controle automatizado de dispositivos executando comandos específicos quando acionados por fluxos de dados recebidos. Esses nós transformam o monitoramento passivo da frota em sistemas de automação ativos, realizando operações críticas como comutação de saídas e transmissão de comandos GPRS.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2540041085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-62eee42a7c87bfb2f3aef6e4291ae244ae441f35%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Embora os nós de Ação possam receber dados de qualquer tipo de nó, eles são mais comumente conectados a [nós de Lógica](https://www.navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management/logic-node) que avaliam condições e acionam ações somente quando critérios específicos são atendidos, como limites de temperatura, movimento não autorizado ou incidentes de direção agressiva.

{% hint style="info" %}
Os **Ação** nós são configurados separadamente para cada fluxo na interface da plataforma Navixy. Cada nó pode conter várias ações que são executadas sequencialmente quando acionadas por dados recebidos.
{% endhint %}

<figure><img src="https://2540041085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5149b87d6add69ddfb2e27fe720ef9fa71218a4b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Como os nós de Ação funcionam

Quando dados chegam a um **Ação** nó, o sistema executa as ações configuradas para os dispositivos que forneceram os dados recebidos. O processo de execução segue as seguintes etapas:

* **Identificação do dispositivo**: O nó identifica quais dispositivos específicos enviaram os dados que acionaram a ação
* **Execução sequencial**: Todas as ações configuradas dentro do nó são executadas na ordem em que aparecem (de cima para baixo)
* **Transmissão do comando**: As ações são enviadas apenas aos dispositivos identificados, garantindo respostas direcionadas
* **Processamento pelo dispositivo**: Dispositivos individuais recebem e processam os comandos de acordo com suas capacidades

Esse mecanismo de direcionamento garante que as ações sejam executadas apenas para dispositivos relevantes. Quando conectado a [nós de Lógica](https://www.navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management/logic-node), as ações são acionadas somente para os dispositivos que fizeram com que a condição lógica fosse avaliada como verdadeira, proporcionando controle preciso de automação.

## Integração na arquitetura do fluxo

**Ação** os nós funcionam como nós terminais dentro da arquitetura do fluxo, recebendo gatilhos de nós a montante sem encaminhar dados adiante. As capacidades de automação se integram ao sistema mais amplo de gerenciamento de dispositivos da Navixy através de:

* **Automação condicional**: A integração com [nós de Lógica](https://www.navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management/logic-node) permite fluxos IF-THEN sofisticados em que as ações são executadas somente quando condições específicas são validadas
* **Controle de dispositivo em tempo real**: Os comandos são transmitidos em segundos após o recebimento dos gatilhos, garantindo resposta imediata a condições críticas
* **Coordenação em toda a frota**: Quando conectado a múltiplas fontes de dispositivos, as ações podem coordenar respostas em grupos inteiros de veículos simultaneamente
* **Respeito às capacidades do dispositivo**: As limitações individuais dos dispositivos são respeitadas, com comandos não suportados sendo recebidos mas não executados

{% hint style="info" %}
**Requisito de conectividade do dispositivo**: As ações são enviadas apenas para dispositivos confirmados online (aqueles que forneceram dados recentemente), garantindo entrega confiável dos comandos. No raro caso de um dispositivo ficar offline imediatamente após enviar dados, ou se múltiplos comandos estiverem pendentes, as ações são enfileiradas e executadas assim que o dispositivo estiver disponível novamente.
{% endhint %}

## Opções de configuração

Configurar um **Ação** nó determina quais respostas automatizadas serão executadas quando o nó receber gatilhos de nós de processamento a montante.

<figure><img src="https://2540041085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3edf7c33f62a13048061b06c2092818e88a18212%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vejamos quais elementos este nó utiliza e o que você pode configurar ao trabalhar com ele:

### Etapas de configuração

{% stepper %}
{% step %}
**Especificar nome do nó**

Insira um nome descritivo que identifique as ações automatizadas que este nó executará

1. Use nomes como "Resposta de Resfriamento de Emergência" ou "Ações de Alerta de Segurança" para maior clareza
2. Esse nome aparece no diagrama de fluxo para identificação fácil
   {% endstep %}

{% step %}
**Selecionar tipo de Ação**

Escolha o tipo de resposta automatizada no menu suspenso

1. **Alternar Saída**: Controle saídas do dispositivo alternando-as entre ligado e desligado
2. **Enviar Comando GPRS**: Transmita comandos personalizados diretamente para os dispositivos
   {% endstep %}

{% step %}
**Configurar parâmetros da ação**

Configure os detalhes específicos com base no tipo de ação selecionado:

<details>

<summary>Configuração de Alternar Saída</summary>

<figure><img src="https://2540041085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-8b6690390e3542595bbabce1e2b3a3b955e7a5d1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Ao configurar ações de Alternar Saída:

* **Número da saída**: Selecione qual saída do dispositivo controlar no menu suspenso
  * Os números de saída disponíveis dependem das capacidades específicas do seu dispositivo
  * Consulte a documentação do seu dispositivo para entender as funções das saídas
* **Alternar Liga/Desliga**: Defina se a ação alterna a saída para LIGAR ou DESLIGAR
  * Use o interruptor para selecionar o estado desejado

</details>

<details>

<summary>Configuração de Enviar Comando GPRS</summary>

<figure><img src="https://2540041085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-7dc8633627afb6c27d2bb957714c439561b04300%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Ao configurar ações de Comando GPRS:

* **String de comando**: Insira o texto exato do comando a ser enviado aos dispositivos
  * Os comandos devem corresponder à sintaxe de comando suportada pelo seu dispositivo
  * Consulte a documentação do dispositivo para comandos disponíveis e formatação adequada
  * Não há restrições de caracteres no campo de entrada

{% hint style="danger" %}
A execução da ação depende das capacidades individuais do dispositivo. Certifique-se de que seus dispositivos suportam os comandos específicos que você está configurando. Informações sobre os comandos suportados por um dispositivo específico estão disponíveis em recursos do fabricante, como a documentação do dispositivo.
{% endhint %}

</details>
{% endstep %}

{% step %}
**Adicionar ações adicionais (opcional)**

Clique **ADICIONAR AÇÃO** para criar várias ações dentro do mesmo nó

* As ações são executadas sequencialmente na ordem em que aparecem na configuração
* Cada ação pode ser de um tipo diferente (Alternar Saída ou Comando GPRS)
* Use o ícone de lixeira para remover ações desnecessárias
  {% endstep %}

{% step %}
**Salvar configuração**

Clique **APLICAR** para salvar a configuração do seu nó

* Use **CANCELAR** para descartar as alterações
* Use **REINICIAR FORMULÁRIO** para limpar todas as ações configuradas e começar novamente
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
**Observação sobre compatibilidade de dispositivos:** A execução da ação depende das capacidades individuais do dispositivo. Certifique-se de que seus dispositivos suportam as saídas ou comandos específicos que você está configurando. Procure por comandos suportados em recursos do fabricante, como a documentação do dispositivo. A lista de dispositivos suportados está disponível em [Navixy dispositivos integrados](https://www.navixy.com/devices/).
{% endhint %}

## Execução e direcionamento de Ação

O nó de Ação fornece controle preciso sobre quando e onde os comandos são executados, garantindo respostas de automação eficientes e direcionadas.

### Sequência de execução

Quando acionado, o nó de Ação segue este padrão de execução:

1. **Direcionamento do dispositivo**: As ações são enviadas apenas para dispositivos que forneceram dados no evento de gatilho atual
   1. Isso garante que os comandos alcancem apenas os dispositivos específicos envolvidos na condição
   2. Evita comandos desnecessários para dispositivos não afetados na frota
2. **Processamento sequencial**: Múltiplas ações dentro de um nó executam na ordem configurada, de cima para baixo
   1. Cada ação conclui a transmissão antes que a próxima ação comece
   2. O tempo total de execução normalmente ocorre dentro de segundos após o recebimento do gatilho
3. **Validação do dispositivo**: Dispositivos individuais processam os comandos recebidos de acordo com suas capacidades
   1. Comandos suportados são executados imediatamente após o recebimento
   2. Comandos não suportados são recebidos, mas ignorados pelo dispositivo
   3. Mecanismos de segurança do dispositivo podem impedir comandos inadequados (por exemplo, desligamento do motor enquanto em movimento)

### Comportamento de conexão

**Integração com nós de Lógica**: Quando conectado a [nós de Lógica](https://www.navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management/logic-node), as ações são executadas apenas para dispositivos onde a condição lógica foi avaliada como `verdadeira`. Isso fornece automação condicional precisa.

**Conexões diretas**: Quando conectado diretamente a outros tipos de nó (Fonte de Dados, Iniciar Atributo), as ações são executadas para todos os dispositivos no fluxo de dados cada vez que os dados são recebidos.

## Perguntas frequentes

#### Como sei se minhas ações foram executadas com sucesso?

Atualmente, o feedback de execução de ações é limitado. Os comandos são enviados para dispositivos confirmados online (aqueles que forneceram dados recentemente) sem intervalo de tempo de execução, o que elimina a possibilidade do dispositivo ficar offline entre o gatilho e a execução. Você pode monitorar o comportamento do dispositivo durante a fase de teste ou usar fluxos de teste separados para verificar os resultados das ações em um ambiente controlado.

#### Posso conectar vários nós ao mesmo nó de Ação?

Sim. Os nós de Ação podem receber gatilhos de múltiplos nós a montante, mas esteja ciente de que as ações serão executadas para qualquer dispositivo que acionar qualquer nó conectado. Ao projetar fluxos complexos, considere o efeito cumulativo de múltiplas fontes de gatilho para garantir que as ações sejam executadas apenas nos cenários pretendidos.

#### O que acontece se eu conectar um nó de Ação diretamente a uma Fonte de Dados?

O nó de Ação irá executar suas ações configuradas toda vez que qualquer dispositivo na Fonte de Dados enviar dados. Isso cria execução contínua de ações em vez de respostas condicionais. Para a maioria dos casos de uso, conectar nós de Ação a [nós de Lógica](https://www.navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management/logic-node) fornece melhor controle sobre quando as ações devem ser executadas.
