> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/action-node.md).

# Action du traceur

Utilisez les nœuds d’action d’appareil dans IoT Logic pour envoyer des Commandes automatisées aux appareils GPS, telles que l’activation de sorties ou l’envoi de Commandes GPRS lorsqu’elles sont déclenchées par des flux de données.

## Vue d'ensemble technique et fonctionnalités

{% columns %}
{% column width="58.333333333333336%" %}
**Action du traceur** Les nœuds d'IoT Logic permettent le contrôle automatisé des appareils en exécutant des commandes spécifiques lorsqu'ils sont déclenchés par des flux de données entrants. Ces nœuds transforment la surveillance passive de la flotte en systèmes d'automatisation actifs, en effectuant des opérations critiques comme la commutation des sorties et l'envoi de commandes GPRS.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-27fd0fcd59006fe239613efa78b54104a09ef845%2Fiot-logic-action-node-tile.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Bien que les nœuds d'action sur l'appareil puissent recevoir des données de tout type de nœud, ils sont le plus souvent connectés à [Logique](/docs/user/fr/guide/account/iot-logic/nodes/logic-node.md) des nœuds qui évaluent des conditions et déclenchent des actions uniquement lorsque des critères précis sont remplis, comme des seuils de température, des mouvements non autorisés ou des incidents d'Eco Conduite.

{% hint style="info" %}
Le bloc **Action du traceur** Les nœuds sont configurés séparément pour chaque flux dans l'interface utilisateur de la plateforme Navixy. Chaque nœud peut contenir plusieurs actions qui s'exécutent séquentiellement lorsqu'elles sont déclenchées par des données entrantes.
{% endhint %}

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d9dcc9b57c4508e018fe783c48f11bd5eaa4d65%2Fiot-logic-action-node-in-flow.png?alt=media" alt=""><figcaption></figcaption></figure>

### Fonctionnement des nœuds d'action sur l'appareil

Lorsque les données atteignent un **Action du traceur** nœud, le système identifie quels appareils ont fourni les données entrantes et exécute les actions configurées uniquement pour ces appareils. Pour tous les détails sur la séquence d'exécution et le ciblage, consultez [Exécution des actions et ciblage](#action-execution-and-targeting) ci-dessous.

{% hint style="info" %}
**Exigence de connectivité de l'appareil**: Les actions sont envoyées uniquement aux appareils confirmés en ligne (ceux qui fournissent des données récentes), garantissant une remise fiable des commandes.
{% endhint %}

Chaque **Action du traceur** résultat de déclenchement du nœud apparaît dans [Analyseur de données](/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md) sous forme d'attribut nommé d'après l' **ID du nœud** (affiché dans la boîte de dialogue de configuration du nœud, par exemple `action_1a2b3c4d`). La valeur est `0` vide `1` lorsque le nœud n'a pas été déclenché et renseignée lorsqu'il l'a été, ce qui vous permet de confirmer l'exécution et de distinguer plusieurs nœuds d'action sur l'appareil au sein du même flux.

### Intégration à l’architecture du flux

**Action du traceur** Les nœuds fonctionnent comme des nœuds terminaux au sein de l'architecture du flux, recevant des déclencheurs des nœuds en amont sans transmettre de données plus loin. Les capacités d'automatisation s'intègrent au système plus large de gestion des appareils de Navixy via :

* **Automatisation conditionnelle**: Intégration avec [Logique](/docs/user/fr/guide/account/iot-logic/nodes/logic-node.md) des nœuds Logique permet de mettre en place des workflows sophistiqués dans lesquels les actions s'exécutent uniquement lorsque des conditions spécifiques sont validées
* **Contrôle des appareils en temps réel**: Les commandes sont transmises dans les secondes qui suivent la réception des déclencheurs, garantissant une réponse immédiate aux conditions critiques
* **Coordination à l'échelle de la flotte**: Lorsqu'elles sont connectées à plusieurs sources d'appareils, les actions peuvent coordonner des réponses sur des groupes entiers de véhicules simultanément
* **Respect des capacités des appareils**: Les limitations propres à chaque appareil sont respectées, les commandes non prises en charge étant reçues mais non exécutées

## Options de configuration

{% columns %}
{% column valign="middle" %}
Configurer un **Action du traceur** nœud détermine quelles commandes s'exécutent et, éventuellement, quels appareils supplémentaires reçoivent ces mêmes commandes.

La boîte de dialogue de configuration est organisée en deux onglets :

* **Standard**: définit quelles commandes exécuter. Fonctionne de manière indépendante, sans dépendre de l'onglet Avancé.
* **Avancé**: définit quels appareils supplémentaires reçoivent les mêmes commandes lorsque le nœud est déclenché. Facultatif.
  {% endcolumn %}

{% column %}

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3f77e43d4a2477ef91c54020c2a1d25dcee7371a%2Faction-node-edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Voyons quels éléments ce nœud utilise et ce que vous pouvez configurer lorsque vous travaillez avec lui :

### Étapes de configuration

{% stepper %}
{% step %}

#### Spécifiez le nom du nœud

Saisissez un nom descriptif qui identifie les actions automatisées que ce nœud exécutera

1. Utilisez des noms comme « Réponse d'urgence au refroidissement » ou « Actions d'alerte de Sécurité » pour plus de clarté
2. Ce nom apparaît dans le diagramme du flux pour une identification facile
   {% endstep %}

{% step %}

#### ID du nœud (généré automatiquement)

Sous le champ Nom, la boîte de dialogue affiche un **ID du nœud** (par exemple, `action_1a2b3c4d`). Ce champ est en lecture seule — vous ne pouvez ni le modifier ni en définir la valeur.

1. L'ID est généré automatiquement lors de la création du nœud et reste inchangé pendant toute la durée de vie du nœud
2. Utilisez-le pour distinguer les résultats de ce nœud de ceux des autres nœuds d'action sur l'appareil dans [Analyseur de données](/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md), où il apparaît comme un attribut affichant `0` (non déclenché) ou `1` (déclenché)
   {% endstep %}

{% step %}

#### Sélectionnez le type d'action

Dans le **Standard** dans l'onglet, choisissez le type de réponse automatisée dans le menu déroulant

1. **Commutation de sortie**: Contrôlez les sorties de l'appareil en les activant ou en les désactivant
2. **Envoyer une commande GPRS**: Transmettez des commandes personnalisées directement aux appareils
   {% endstep %}

{% step %}

#### Configurez les paramètres de l'action

Définissez les détails spécifiques en fonction du type d'action sélectionné :

<details>

<summary>Configuration de la commutation de sortie</summary>

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d9244e7ff7f15d31b6ad7f2f0c565102b4fd8856%2Faction-node-switch-output.png?alt=media" alt=""><figcaption></figcaption></figure>

Lors de la configuration des actions de commutation de sortie :

* **Numéro de sortie**: Sélectionnez la sortie de l'appareil à contrôler dans le menu déroulant
  * Les numéros de sortie disponibles dépendent des capacités propres à votre appareil
  * Consultez la documentation de votre appareil pour comprendre les fonctions de sortie
* **Interrupteur Marche/Arrêt**: Définissez si l'action active ou désactive la sortie
  * Utilisez le commutateur pour sélectionner l'état souhaité

</details>

<details>

<summary>Configuration de l'envoi de commande GPRS</summary>

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-fe1b0fa64db4572c41b21eaff3d76c7add2c5c03%2Faction-node-gprs.png?alt=media" alt=""><figcaption></figcaption></figure>

Lors de la configuration des actions Envoyer une commande GPRS :

* **Chaîne de commande**: Saisissez le texte exact de la commande à envoyer aux appareils
  * Les commandes doivent correspondre à la syntaxe de commande prise en charge par votre appareil
  * Consultez la documentation de l'appareil pour connaître les commandes disponibles et le formatage correct
  * Il n'y a aucune restriction de caractères dans le champ de saisie

</details>
{% endstep %}

{% step %}

#### Ajoutez des actions supplémentaires (facultatif)

Cliquez sur **Ajouter une action** pour créer plusieurs actions au sein du même nœud.

{% hint style="info" %}

* Les commandes d'action sont envoyées à la réception d'un paquet de données provenant de l'appareil, conformément à la configuration du flux
* Les commandes s'exécutent séquentiellement dans l'ordre où elles apparaissent dans la configuration
* Chaque action peut être d'un type différent (Commutation de sortie ou Envoyer une commande GPRS)
* Utilisez l'icône de la corbeille pour supprimer les actions inutiles
  {% endhint %}
  {% endstep %}

{% step %}

#### Configurez les mappages de destinataires (facultatif)

Ouvrez le **Avancé** l'onglet pour définir quels appareils supplémentaires reçoivent les mêmes commandes lorsque le nœud est déclenché.

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e918338f9aa10b70216ab071e7b77e77ae6202c8%2Faction-node-advanced-tab.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Utilisez la **Appareil source** menu déroulant pour sélectionner l'appareil dont les données entrantes déclenchent le nœud. Il doit s'agir d'un appareil présent dans le **nœud Source de données du flux**.
2. Utilisez la **Appareils cibles** menu déroulant pour sélectionner un ou plusieurs appareils qui recevront les mêmes commandes.
3. Cliquez sur **+ Mappage personnalisé** pour ajouter des paires source-cible supplémentaires si différents appareils sources doivent propager les commandes à différents ensembles d'appareils cibles.

{% hint style="info" %}
L'onglet Avancé est facultatif. Sans lui, le nœud se comporte exactement comme avant — les commandes ne s'exécutent que pour l'appareil déclencheur.
{% endhint %}
{% endstep %}

{% step %}

#### Enregistrer la configuration

Cliquez sur **Appliquer les modifications** pour enregistrer la configuration de votre nœud
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Remarque sur la compatibilité des appareils :** L'exécution des actions dépend des capacités de chaque appareil. Assurez-vous que vos appareils prennent en charge les sorties ou commandes spécifiques que vous configurez. Recherchez les commandes prises en charge dans les ressources du fabricant, comme la documentation de l'appareil. La liste des appareils pris en charge est disponible sur [Appareils intégrés à Navixy](https://www.navixy.com/devices/).
{% endhint %}

## Exécution des actions et ciblage

Le bloc **Action du traceur** Le nœud offre un contrôle précis sur le moment et l'endroit où les commandes sont exécutées, garantissant des réponses d'automatisation efficaces et ciblées.

### Séquence d'exécution

Lorsqu'il est déclenché, le **Action du traceur** nœud suit ce schéma d'exécution :

1. **Ciblage des appareils**: Les actions sont envoyées uniquement aux appareils qui ont fourni des données lors de l'événement de déclenchement actuel
   1. Cela garantit que les commandes atteignent uniquement les appareils spécifiques impliqués dans la condition
   2. Empêche l'envoi de commandes inutiles aux appareils de la flotte non concernés
2. **Traitement séquentiel**: Plusieurs actions au sein d'un nœud s'exécutent dans l'ordre configuré, de haut en bas
   1. Chaque action termine sa transmission avant que la suivante ne commence
   2. Le temps total d'exécution est généralement de quelques secondes après la réception du déclencheur
3. **Validation de l'appareil**: Chaque appareil traite les commandes reçues selon ses capacités
   1. Les commandes prises en charge s'exécutent immédiatement à la réception
   2. Les commandes non prises en charge sont reçues mais ignorées par l'appareil
   3. Les mécanismes de sécurité de l'appareil peuvent empêcher des commandes inappropriées (par exemple, l'arrêt du moteur en mouvement)

### Comportement de connexion

**Intégration des nœuds Logique**: Lorsqu'il est connecté à [Logique](/docs/user/fr/guide/account/iot-logic/nodes/logic-node.md) des nœuds, les actions s'exécutent uniquement pour les appareils pour lesquels la condition logique a été évaluée à vrai `true`. Cela fournit une automatisation conditionnelle précise.

**Connexions directes**: Lorsqu'il est connecté directement à d'autres types de nœuds (Source de données, Initialiser un Attribut), les actions s'exécutent pour tous les appareils du flux de données à chaque réception de données.

## Questions fréquemment posées

#### Comment savoir si mes actions ont été exécutées avec succès ?

Vérifiez [Analyseur de données](/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md): sélectionnez l'appareil déclencheur et recherchez l'attribut correspondant à l'ID de ce nœud. Voir [Fonctionnement des nœuds d'action sur l'appareil](#how-device-action-nodes-work) pour plus de détails.

Les commandes sont envoyées aux appareils confirmés en ligne (ceux qui fournissent des données récentes), sans délai d'exécution entre le déclenchement et la remise. Cela élimine la possibilité que l'appareil passe hors-ligne entre le déclenchement et l'exécution.

#### Puis-je connecter plusieurs nœuds au même nœud d'action sur l'appareil ?

Oui. Les nœuds d'action sur l'appareil peuvent recevoir des déclencheurs de plusieurs nœuds en amont, mais sachez que les actions s'exécuteront pour tout appareil qui déclenche l'un des nœuds connectés. Lorsque vous concevez des flux complexes, tenez compte de l'effet cumulé de plusieurs sources de déclenchement afin de vous assurer que les actions ne s'exécutent que dans les scénarios prévus. Pour confirmer que le nœud ne se déclenche que dans les scénarios souhaités, surveillez son attribut ID du nœud dans [Analyseur de données](/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md): il affiche `1` vrai à chaque déclenchement et `0` faux sinon.

#### Que se passe-t-il si je connecte directement un nœud d'action sur l'appareil à une Source de données ?

Le nœud d'action sur l'appareil exécutera ses actions configurées chaque fois qu'un appareil de la Source de données enverra des données. Cela crée une exécution continue des actions plutôt que des réponses conditionnelles. Pour la plupart des cas d'utilisation, connecter des nœuds d'action sur l'appareil à [Logique](/docs/user/fr/guide/account/iot-logic/nodes/logic-node.md) des nœuds Logique offre un meilleur contrôle sur le moment où les actions doivent s'exécuter.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/action-node.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
