> 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 capacités
{% columns %}
{% column %}
Dans IoT Logic, **Initialiser un Attribut** le nœud transforme les relevés de l'appareil en créant de nouveaux attributs de données basés sur 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 du bit à l'aide du [langage d'expressions Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Le nœud constitue un élément clé d'un flux, vous permettant d'enrichir les données avant de les envoyer à vos systèmes cibles.
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
**Initialiser un Attribut** Le nœud est configuré pour chaque flux dans l'interface utilisateur de la plateforme Navixy. Pour connaître les options de syntaxe spécifiques et la référence détaillée du langage d'expression, voir [langage d'expressions Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) dans la documentation utilisateur.
### Intégration à l'architecture du flux
**Initialiser un Attribut** Le nœud fonctionne au sein de l'architecture du flux en offrant des capacités de transformation des données et en permettant :
* Transformation des données brutes de télémétrie en indicateurs métier pertinents
* Création de champs calculés à partir des valeurs de plusieurs paramètres
* Conversion d'unités de mesure (par exemple, des kilomètres en miles)
* Calcul des différences entre les relevés actuels et précédents
* Génération d'analyses temporelles sur le comportement de l'appareil
{% hint style="info" %}
Le nœud Initialiser un Attribut requiert au moins un **Source de données** nœud y soit connecté. Aucun calcul ne sera effectué sans connexions de données d'entrée.
{% endhint %}
### Capacités du nœud
Le **Initialiser un Attribut** Le nœud, à lui seul, offre :
* **Transformation des attributs de données**: Créez des attributs entièrement nouveaux en appliquant des opérations mathématiques à ceux provenant des sources de données
* **Conversion d'unités**: Convertissez des unités de mesure (par exemple, la vitesse de *km/h* en *mph*, ou la température de *°C* en *°F*)
* **Calculs basés sur le temps**: Comparez les relevés actuels aux valeurs précédentes afin de déterminer les changements
* **Manipulation du temps**: Personnalisez les horodatages correspondant au moment où l'attribut a été généré sur un appareil et à celui où il a été reçu par le serveur afin d'éviter des incohérences d'heure et d'unifier les formats de temps
* **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](/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, qui seront disponibles pour un traitement ultérieur dans votre flux de données.
{% endcolumn %}
{% column %}
{% 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 la finalité du nœud. Utilisez un nom qui vous aide à identifier les calculs qui seront effectués dans ce nœud ; il sera affiché dans le diagramme du flux pour en faciliter l'identification.
{% endstep %}
{% step %}
#### Définir le nom de l'attribut
Ajoutez un identifiant distinctif de l'attribut.
* Ce nom sera affiché dans [Analyseur de données](/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 [Suivi](/docs/user/fr/guide/tracking.md) module. Pour ce faire, le **Initialiser un Attribut** nœud contenant cet attribut doit être connecté à un **Point de sortie** nœud défini en mode **Point de sortie par Défaut** .
{% endstep %}
{% step %}
#### Définir la formule
Ajoutez des expressions mathématiques pour calculer les valeurs des attributs.
* Utilisez `value('parameter_name' 0, 'valid')` pour faire référence aux paramètres existants de l'appareil.\
**Remarque**. Cliquez  à l’intérieur du **Formule** 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, voir [Remplissage automatique des noms d'attributs](/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 [le langage d'expression Navixy IoT Logic](/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 susceptibles d'être manquantes. Si une valeur nécessaire à la formule est manquante, la formule ne produit rien, et l'attribut n'a alors aucune valeur pour ce paquet. Voir [Valeurs manquantes dans les expressions](/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
{% endstep %}
{% step %}
#### (facultatif) Ajouter d'autres attributs
Cliquez sur **Ajouter un attribut** pour ouvrir une nouvelle boîte de dialogue de configuration d'attribut. Vous pouvez y créer un nouvel attribut de données si vous avez besoin d'effectuer plusieurs calculs dans le même nœud.
{% endstep %}
{% step %}
#### Enregistrez la configuration du nœud
Cliquez sur **Appliquez les modifications** pour terminer la création du nœud.
{% endstep %}
{% endstepper %}
Examinons un exemple pratique de configuration des attributs :
{% columns %}
{% column valign="middle" %}
Cet exemple crée un attribut qui convertit la vitesse des kilomètres 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, voir [Exemples de calcul](/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](/docs/user/fr/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
## Options d'affichage
Les nouveaux attributs calculés dans **Initialiser un Attribut** le 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, voir [Affichage de nouveaux attributs calculés sur la plateforme Navixy](/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. Connectez le nœud à au moins un **Source de données** nœud en entrée
2. Connectez 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 recevrez :
* Tous les paramètres d'origine de l'appareil
* Tous les attributs calculés avec leurs valeurs
* Les valeurs mises à jour de l'heure de génération et de l'heure du serveur, selon la configuration
Si vous utilisez le même nom pour un attribut calculé que pour un paramètre existant, l'attribut remplace le paramètre d'origine dans le paquet de données de 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 d'appareil, la valeur du paramètre d'origine reste dans le paquet à la place, de sorte que le paquet semble normal et que le calcul n'a tout simplement pas eu lieu. Voir [Valeurs manquantes dans les expressions](/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
## Foire aux questions
#### Puis-je faire référence à des valeurs qui ne sont pas les plus récentes dans mes calculs ?
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 effectuer des calculs impliquant le temps ?
Utilisez l’ `genTime()` et `srvTime()` fonctions pour travailler avec les horodatages. Vous pouvez calculer des différences de temps, ajouter des décalages temporels ou formater 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 plus 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 nœud ?
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 d'effectuer des calculs en plusieurs étapes. Tous les attributs créés sont également disponibles à l'aide de la [fonction de remplissage automatique](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) afin de garantir une dénomination correcte.
#### Comment éviter les fautes de frappe lorsque vous faites 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, voir [Remplissage automatique des noms d'attributs](/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](/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=&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.
