> 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/initiate-attribute-node.md).

# Initialiser un Attribut

Créez de nouveaux attributs de données à partir de la télémétrie entrante à l'aide du langage d'expression Navixy. Renommez les paramètres, appliquez des formules et enrichissez les données avant de les transférer.

## Vue d'ensemble technique et fonctionnalités

{% columns %}
{% column %}
Dans IoT Logic, **Initialiser un Attribut** le nœud transforme les relevés des appareils en créant de nouveaux attributs de données à partir de la télémétrie entrante. Ce nœud vous permet de manipuler les données au moyen de formules mathématiques, de renommer des paramètres existants et d’effectuer des opérations au niveau des bits en utilisant le [langage d'expression Navixy](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Le nœud sert de composant clé dans un flux, ce qui vous permet d’enrichir les données avant de les envoyer à vos systèmes cibles.
{% endcolumn %}

{% column %}
![](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-7e96978455ec9e7da74b1a6f2224ad0d7fcf15e0%2Fiot-logic-initiate-attribute-tile.png?alt=media\&token=98a0e52b-69fd-4199-96dd-374a0e751abd)
{% endcolumn %}
{% endcolumns %}

**Initialiser un Attribut** Le nœud est configuré pour chaque flux dans l’interface utilisateur de la plateforme Navixy. Pour les options de syntaxe spécifiques et la référence détaillée du langage d’expression, consultez [langage d'expression Navixy](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) la documentation utilisateur.

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-65ef89cf366fb6c4e53d07f6aa05c617d0e3d1e1%2Fiot-logic-initiate-attribute-in-flow.png?alt=media" alt="Initiate attribute node in the flow workspace showing the node connected to other nodes in the flow"><figcaption></figcaption></figure>

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

**Initialiser un Attribut** Le nœud fonctionne dans l’architecture du flux en fournissant des capacités de transformation des données et en permettant :

* Le traitement des données de télémétrie brutes en indicateurs métier significatifs
* La création de champs calculés à partir de plusieurs valeurs de paramètres
* La conversion d’unités de mesure (par exemple, des kilomètres en miles)
* Le calcul des différences entre les relevés actuels et précédents
* La génération d’analyses temporelles sur le comportement des appareils

{% hint style="info" %}
Le nœud Initialiser un Attribut nécessite qu’au moins un **Source de données** nœud lui soit connecté. Aucun calcul ne sera effectué sans connexion de données d’entrée.
{% endhint %}

### Fonctionnalités du nœud

Le bloc **Initialiser un Attribut** Le nœud lui-même offre :

* **Transformation des attributs de données** : Créez des attributs entièrement nouveaux en appliquant des opérations mathématiques à ceux qui proviennent des sources de données
* **Conversion d’unités** : Convertissez des unités de mesure (par exemple, la vitesse de *km/h* à *mph* , ou la température de *°C* à *°F*)
* **Calculs basés sur le temps** : Comparez les relevés actuels avec les valeurs précédentes pour déterminer les variations
* **Manipulation du temps** : Personnalisez les horodatages correspondant au moment où l’attribut a été généré sur un appareil et au moment où il a été reçu par le serveur afin d’éviter les incohérences de l’heure et d’unifier les formats d’heure
* **Recherche de zone géographique** : Écrivez le nom de la zone géographique dans laquelle se trouve un appareil dans un attribut avec `geofenceName()` , une option payante. Voir [Fonctions de zone géographique](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/geofence-functions.md)

## Options de configuration

{% columns %}
{% column valign="middle" %}
**Initialiser un Attribut** Le nœud vous permet de définir comment les paramètres de l’appareil sont transformés en attributs, lesquels seront disponibles pour un traitement ultérieur dans votre flux de données.
{% endcolumn %}

{% column %}

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1d6dbc91c7863368a349129f700135f56c46e5cb%2FInitiate_Attribute_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 pour mettre en évidence le rôle du nœud. Utilisez un nom qui vous aide à identifier les calculs qui seront effectués dans ce nœud, il s’affichera dans le diagramme du flux pour une identification facile.
{% endstep %}

{% step %}

#### Définir le nom de l’attribut

Ajoutez un identifiant distinctif de l’attribut.

* Ce nom s’affichera dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md),
* Vous pouvez également utiliser ce nom pour créer des capteurs personnalisés dans le module. Pour ce faire, le [Suivi](https://navixy.com/docs/user/fr/guide/tracking.md) nœud contenant cet attribut doit être connecté à un **Initialiser un Attribut** nœud défini sur **Point de sortie** Point de sortie par Défaut **mode.** mode.
  {% endstep %}

{% step %}

#### Définir la formule

Ajoutez des expressions mathématiques pour calculer les valeurs des attributs.

* À utiliser `value('parameter_name' 0, 'valid')` format pour référencer les paramètres d’appareil existants.\
  **Remarque**. Cliquez ![image-20250605-115154.png](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3ae9e98cb2dff10c13a5b062c8b6c161b9b038df%2Fimage-20250605-115154.png?alt=media\&token=2de2cfe6-4d78-49fd-9179-f6fc96a7fd33) dans le **Formule** sur le champ pour ouvrir la liste des attributs disponibles et sélectionner celui dont vous avez besoin. Il sera ajouté automatiquement au champ dans un format prêt à l’emploi. Pour plus de détails sur le remplissage automatique des noms d’attributs, consultez [Remplissage automatique des noms d’attributs](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* Appliquez des opérations mathématiques basées sur [langage d'expressions Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) pour transformer les valeurs.
* Utilisez différentes valeurs d’index de profondeur pour accéder aux valeurs historiques (la valeur par défaut est 0).
* Gérez les valeurs qui pourraient être manquantes. Si une valeur nécessaire à la formule est absente, la formule ne produit rien et l’attribut n’a alors aucune valeur pour ce paquet. Voir [Valeurs manquantes dans les expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
  {% endstep %}

{% step %}

#### (facultatif) Ajoutez d’autres attributs

Cliquez sur **Ajouter un attribut** pour ouvrir une nouvelle boîte de dialogue de configuration d’attribut. Ici, vous pouvez créer un nouvel attribut de données si vous avez besoin d’effectuer plusieurs calculs au sein du même nœud.
{% endstep %}

{% step %}

#### Enregistrez la configuration du nœud

Cliquez sur **Appliquer les modifications** pour terminer la création du nœud.
{% endstep %}
{% endstepper %}

Voyons un exemple pratique de configuration des attributs :

{% columns %}
{% column valign="middle" %}
Cet exemple crée un attribut qui convertit la vitesse de kilomètres par heure en miles par heure en divisant le paramètre de vitesse CAN par 1,609.

Pour plus de détails sur les calculs des nouveaux attributs, consultez [Exemples de calcul](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).

Vous pouvez également trouver un exemple détaillé d’utilisation des attributs calculés dans un flux dans [exemple de configuration du flux → étapes 3 et 4](https://navixy.com/docs/user/fr/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}

{% column %}

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

## Options d’affichage

Les nouveaux attributs calculés dans le **Initialiser un Attribut** nœud peuvent être surveillés comme les attributs de données réels provenant des appareils dans **Analyseur de données (DSA)** et le **Suivi** module.

Pour plus d’informations sur les options d’affichage, consultez [Affichage des nouveaux attributs calculés sur la plateforme Navixy](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).

## Considérations relatives au flux de données

Après avoir configuré votre **Initialiser un Attribut** nœud, assurez-vous de :

1. Connecter le nœud à au moins un **Source de données** nœud comme entrée
2. Connecter la sortie à un **Point de sortie** nœud pour envoyer les données transformées

Dans le **Initialiser un Attribut** nœud, les valeurs des paramètres sont traitées selon vos expressions à chaque fois que l’appareil fournit des données. En sortie, vous obtiendrez :

* Tous les paramètres d’origine de l’appareil
* Tous les attributs calculés avec leurs valeurs
* Les valeurs de temps de génération et de temps serveur mises à jour comme configuré

Si vous utilisez le même nom pour un attribut calculé qu’un paramètre existant, l’attribut remplace le paramètre d’origine dans le paquet de données en sortie.

Un attribut dont la formule n’a pas pu être calculée n’a aucune valeur pour ce paquet. Rien ne le signale comme une erreur. Si l’attribut utilise le même nom qu’un paramètre de l’appareil, la valeur du paramètre d’origine reste à la place dans le paquet, de sorte que le paquet semble normal et que le calcul n’a simplement pas eu lieu. Voir [Valeurs manquantes dans les expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Questions fréquemment posées

#### Puis-je utiliser des attributs créés dans un nœud Initialiser un Attribut dans un autre ?

Oui. Utilisez le paramètre d’index dans la fonction value pour accéder aux valeurs historiques. Par exemple, `value('temperature', 1, 'valid')` fait référence à la valeur valide précédente du paramètre de température.

#### Comment puis-je effectuer des calculs impliquant le temps ?

Utilisez la `genTime()` et `srvTime()` fonctions pour travailler avec les horodatages. Vous pouvez calculer des différences de temps, ajouter des décalages temporels ou mettre en forme les horodatages pour l’affichage.

#### Que se passe-t-il si je supprime un attribut ?

L’attribut n’est plus calculé pour les données nouvellement reçues, mais les données historiques restent inchangées. L’attribut n’apparaît dans aucun nouveau paquet de données après sa suppression.

#### Puis-je utiliser des attributs créés dans un nœud Initialiser un Attribut dans un autre ?

Oui. Les attributs créés plus tôt dans le flux peuvent être référencés dans les **Initialiser un Attribut** nœuds suivants, ce qui permet des calculs en plusieurs étapes. Tous les attributs créés sont également disponibles à l’aide de la [fonction de remplissage automatique](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) pour garantir une dénomination correcte.

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-283b0e91f8050910026eb2295c18845b6d485b20%2Fiot-logic-initiate-attribute-chained.png?alt=media" alt="Example of a complete flow with two Initiate attribute nodes consecutively"><figcaption></figcaption></figure>

#### Comment éviter les fautes de frappe lors de la référence aux noms d’attributs dans les formules ?

Utilisez la fonction de remplissage automatique dans le champ Formule pour sélectionner parmi les attributs disponibles. Pour des instructions détaillées, consultez [Remplissage automatique des noms d’attributs](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).

#### Pourquoi l’un de mes attributs calculés est-il parfois manquant ?

La formule n’a pas pu être calculée pour ces paquets, le plus souvent parce qu’une valeur qu’elle lit était absente du paquet. L’attribut n’a alors aucune valeur, et aucune erreur n’est signalée. Voir [Valeurs manquantes dans les expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).


---

# 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/initiate-attribute-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.
