> 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/managing-attributes.md).

# Gestion des attributs

Créez, modifiez et supprimez des attributs dans le nœud Initialiser un Attribut. Utilisez le remplissage automatique pour construire rapidement des expressions de formule à partir des champs de télémétrie disponibles.

Le bloc **Initialiser un Attribut** Le nœud vous permet de créer, modifier et gérer des attributs de données tout au long de votre flux IoT Logic. Ce guide couvre les actions de base de gestion des attributs (création, modification, suppression) et les opérations essentielles, y compris la fonctionnalité de remplissage automatique pour la création de formules.

## Création d’attributs

Voici comment créer un nouvel attribut dans le nœud Initialiser un Attribut :

{% stepper %}
{% step %}

### Ajouter un nouvel attribut

Cliquez sur le **Ajouter un attribut** bouton
{% endstep %}

{% step %}

### Nommer l’attribut

Saisissez un nom pour votre attribut (par exemple, "Speed mph"). Ce nom s’affichera dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md) et servira de [nom de capteur personnalisé dans Navixy](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).
{% endstep %}

{% step %}

### Définir la formule

Définissez l’expression de valeur. Pour créer des formules plus rapidement, utilisez [le remplissage automatique](#autofill-attribute-names).

{% hint style="info" %}
La syntaxe courte est utilisée par défaut pour les noms d’attributs remplis automatiquement dans les formules, et vous pouvez également l’utiliser pour la saisie manuelle de formules. Lorsque vous faites référence uniquement à la dernière valeur valide d’un attribut, vous pouvez omettre la syntaxe complète de la fonction et les guillemets. Par exemple, la formule de conversion de température peut être écrite comme `value()` comme suit `temperature*1.8 + 32` au lieu de `value('temperature', 0, 'valid')*1.8 + 32`.
{% endhint %}
{% endstep %}

{% step %}

### Finaliser la configuration

Cliquez sur **Enregistrer** pour confirmer la configuration du nœud
{% endstep %}
{% endstepper %}

Le nouvel attribut est enregistré dans le nœud et le calcul configuré est appliqué immédiatement dans le flux.

### Paramètres temporels des attributs

Les paramètres temporels vous permettent de contrôler les horodatages associés à vos attributs :

* **Heure de génération**: Quand les données ont été créées
  * À utiliser `now()` pour définir l’heure actuelle en millisecondes
  * À utiliser `genTime('parameter_name', 0, 'valid')` pour utiliser l’heure de génération propre au paramètre
* **Heure du serveur**: Quand les données ont été reçues par IoT Logic
  * À utiliser `now()` pour définir l’heure actuelle en millisecondes
  * À utiliser `srvTime('parameter_name', 0, 'valid')` pour utiliser l’heure du serveur du paramètre
  * Ajoutez des décalages pour ajuster les fuseaux horaires (par exemple, `srvTime('can_speed', 0, 'valid') + 120000` ajoute 2 minutes)

{% hint style="info" %}
Les paramètres temporels sont importants pour l’analyse et la synchronisation des données. Une configuration temporelle appropriée garantit que vos données conservent leur intégrité chronologique tout au long du flux.
{% endhint %}

### Remplissage automatique des noms d’attributs

Lorsque vous créez des formules de calcul, vous devez référencer des noms d’attributs existants provenant de dispositifs physiques ou des attributs calculés d’autres nœuds. Pour simplifier ce processus et éviter les fautes de frappe, IoT Logic fournit une fonctionnalité de remplissage automatique pour les noms d’attributs.

Pour utiliser le remplissage automatique lors de la création de formules :

1. Cliquez sur ![image-20250605-130755.png](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-246f310d842a27356a230db8e06eb7dfa5d87a8a%2Fimage-20250605-130755.png?alt=media\&token=078e31dc-ae4d-4c00-9619-3bce091f728d) dans les **Formule** champ.
2. Sélectionnez l’attribut souhaité dans la liste affichée ; elle prend en charge la saisie manuelle de texte à des fins de recherche.
3. Cliquez sur le nom de l’attribut pour l’insérer dans votre formule.

L’attribut sélectionné est inséré automatiquement dans un format prêt à l’emploi, en utilisant la [syntaxe courte](#short-syntax) du langage d’expression IoT Logic de Navixy. Cela signifie que les entrées remplies automatiquement accèdent à la dernière valeur disponible de l’attribut sélectionné.

Vous pouvez modifier les paramètres selon vos besoins : changez le numéro d’index pour les valeurs historiques ou ajustez le drapeau de validité. Pour ce faire, vous devez définir la formule en utilisant explicitement la [syntaxe complète](#full-syntax) de manière explicite, à l’intérieur de `value()` fonction.

La liste est filtrée en fonction des sources de données de votre flux et correspond à ce qui est visible dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md).

{% hint style="info" %}
La liste de remplissage automatique n’affiche que les attributs qui remplissent simultanément **tous** les critères suivants :

* **Pris en charge par les appareils** - L’attribut doit être pris en charge par au moins un appareil actuellement ajouté à votre flux
* **Effectivement transmis** - L’appareil doit avoir envoyé des données réelles pour cet attribut (et non pas seulement le prendre en charge théoriquement)
* **Disponible dans le flux** - Cela inclut à la fois les paramètres de l’appareil et les attributs calculés provenant d’autres **Initialiser un Attribut** nœuds du même flux

**Exemple**: Si votre appareil prend en charge à la fois des capteurs de vitesse et de température, mais n’a transmis que des données de vitesse (peut-être en raison d’un capteur de température défectueux), la liste de remplissage automatique affichera l’attribut 'speed', mais pas 'temperature'. L’attribut de température n’apparaîtra que lorsque l’appareil enverra effectivement des relevés de température, même s’il le prend techniquement en charge.
{% endhint %}

#### Attributs indexés dans le remplissage automatique

Certains attributs de données contiennent plusieurs valeurs indexées au sein d’un seul attribut, comme des relevés provenant de plusieurs capteurs analogiques connectés à un appareil télématique principal. Pour utiliser ces attributs dans des calculs, vous devez préciser le numéro d’index exact correspondant au capteur ou à l’entrée spécifique que vous souhaitez référencer.

Par exemple, si vous devez travailler avec des relevés de tension provenant de la troisième entrée analogique de votre appareil, ces données passent par l’attribut `analog_2` (en utilisant une indexation à partir de zéro, où la première entrée a l’indice 0). Dans votre formule, cela apparaîtrait comme `value('analog_2', 0, 'valid')`.

Le remplissage automatique gère également ce cas pour vous :

* Les attributs indexés sont marqués par une icône dans la liste de remplissage automatique. ![image-20250606-123725.png](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-65afe9be52f6e729d0e1cc25714ef6f5dbd39294%2Fimage-20250606-123725.png?alt=media\&token=3cb340b7-1825-47d6-bdf3-6c767023721e) icône
* Ces entrées affichent la plage d’index disponible entre crochets, par exemple `analog_[1..4]` pour les attributs prenant en charge cinq valeurs indexées (indices 1 à 4).
* Lorsque vous sélectionnez un attribut indexé, le curseur se place automatiquement à la fin du nom de l’attribut à l’intérieur des guillemets, ce qui vous permet de saisir immédiatement le numéro d’index spécifique dont vous avez besoin.

## Langage d’expression

Toutes les formules dans IoT Logic suivent les spécifications de [langage d'expressions Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Vous trouverez ci-dessous un bref récapitulatif des deux options de syntaxe du langage. Le choix de la syntaxe dépend du cas particulier et est conçu pour être pratique :

* La syntaxe courte est facile à écrire et fonctionne le mieux lorsque vous n’avez besoin que des données les plus récentes.
* La syntaxe complète est légèrement plus complexe, mais offre davantage de contrôle sur la profondeur des données lorsque vous devez gérer des valeurs historiques.

{% hint style="success" %}
L’option de syntaxe n’affecte pas la formule elle-même ! Vous pouvez également combiner la syntaxe courte et la syntaxe complète dans la même formule.
{% endhint %}

Les formules peuvent également appeler les fonctions de zone géographique, qui lisent la position de l’appareil par rapport aux zones géographiques de votre compte. `geofenceName()` renvoie le nom de la zone géographique dans laquelle se trouve l’appareil, sous forme de texte, afin qu’il s’intègre directement à une valeur d’attribut. Voir [Fonctions de zone géographique](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/geofence-functions.md).

Les deux options de syntaxe peuvent lire une valeur qui n’existe pas. Une formule qui calcule ensuite avec cette valeur ne produit rien, et l’attribut est omis du paquet de données. Voir [Valeurs manquantes dans les expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

### Syntaxe courte

L’option de formule courte accède à la dernière valeur de l’attribut, sans vérifier la validité. Utilisez-la lorsque vous n’avez pas besoin de valeurs historiques dans une formule. La valeur lue peut être vide, et la plupart des opérateurs ne peuvent pas calculer avec une valeur vide.

{% hint style="info" %}
[Remplissage automatique ](#autofill-attribute-names)utilise toujours la syntaxe courte.
{% endhint %}

**Syntaxe :** `attribute_name`

**Valeurs par défaut :**

* Index : `0` (valeur actuelle)
* Validation : `'tous'` (inclut les valeurs nulles)

Par exemple, la forme courte `temperature` est équivalente à la formule complète `value('temperature', 0, 'all')`. Cela signifie que vous pouvez facilement créer des calculs sans ajouter explicitement les paramètres par défaut :

```jexl
temperature * 1.8 + 32
```

### Syntaxe complète

L’utilisation de la syntaxe complète de la formule vous permet d’accéder aux valeurs historiques ou au mode de validation explicite. Cela vous aide lorsque vous devez utiliser des valeurs non les plus récentes et gérer les valeurs nulles. Dans le cas de la syntaxe complète, vous devez définir la `value()` fonction.

**Fonction :** `value(attribute_name, index, validation)`

**Paramètres :**

<table><thead><tr><th width="152.54547119140625">Paramètre</th><th width="176.45452880859375">Plage/Valeurs</th><th>Description</th></tr></thead><tbody><tr><td><code>attribute_name</code></td><td>Tout attribut valide</td><td>Nom exact issu de la télémétrie de l’appareil (peut être <a href="#autofill-attribute-names">rempli automatiquement</a>)</td></tr><tr><td><code>index</code></td><td>0-11</td><td>Position historique : 0 = valeur actuelle, 1 = valeur précédente, 11 = valeur stockée la plus ancienne</td></tr><tr><td><code>validation</code></td><td><code>'tous'</code> ou <code>'valide'</code></td><td><code>'tous'</code>= inclut les valeurs nulles (indice exact), <code>'valide'</code>= exclut les valeurs nulles (n-ième relevé valide)</td></tr></tbody></table>

Navixy stocke 12 relevés par attribut pour chaque appareil et les conserve jusqu’à 30 jours après le message le plus récent provenant de cet appareil. Un appareil qui revient après plus de 30 jours de silence repart sans historique. Au premier message de retour, elle prend la valeur null. Pour vérifier l’historique actuellement disponible pour un appareil, ouvrez `value('temperature', 1, 'valid')` renvoie à null. Pour vérifier quel historique un appareil possède actuellement, ouvrez [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md).

**Exemples :**

* Tout relevé précédent

```jexl
value('temperature', 1, 'all')
```

* 5e relevé valide en remontant

```jexl
value('speed', 5, 'valid')
```

* Variation de température (syntaxes courte et complète utilisées dans la même formule)

```jexl
temperature - value('temperature', 1, 'all')
```

{% hint style="info" %}
Pour d’autres exemples de formules, voir [Exemples de calcul](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}

## Modification d’attributs existants

Pour modifier un attribut existant :

1. Ouvrez la fenêtre de configuration du nœud en survolant le nœud avec la souris pour afficher les actions rapides, ou en double-cliquant sur le nœud
2. Trouvez l’attribut que vous souhaitez modifier dans la liste des attributs
3. Apportez les modifications nécessaires dans les champs texte des propriétés de l’attribut : **Nom de l’attribut**, **Formule** ou paramètres temporels
4. Si vous devez modifier d’autres attributs dans ce nœud, répétez l’étape 3 pour eux
5. Cliquez sur **Enregistrer** pour appliquer vos modifications à la configuration du nœud

{% hint style="info" %}
Lorsque vous modifiez un attribut, les changements ne s’appliqueront qu’aux nouvelles données reçues après l’enregistrement. Les données historiques déjà collectées ne seront pas recalculées.
{% endhint %}

## Suppression d’attributs

Pour supprimer un attribut qui n’est plus nécessaire :

1. Ouvrez la fenêtre de configuration du nœud en survolant le nœud avec la souris pour afficher les actions rapides, ou en double-cliquant sur le nœud
2. Trouvez l’attribut que vous souhaitez supprimer et cliquez sur <img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-91fdf4a5f67bca3919ef3bde451fbd50678ef82e%2Fimage.png?alt=media" alt="" data-size="line">
3. Cliquez sur **Appliquer les modifications** pour confirmer la configuration du nœud

{% hint style="info" %}
Lorsque vous supprimez un attribut, il ne sera plus calculé pour les nouvelles données, mais les données historiques contenant cet attribut resteront inchangées dans la base de données.
{% endhint %}


---

# 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/managing-attributes.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.
