Cette fonctionnalité vous permet de modifier les équipements et les propriétés en masse (par exemple, ajouter tous les niveaux de batterie des équipements LoRaWAN) en une seule opération, sans passer par l'interface de la console à l'aide de fichiers xlsx.
Comment procéder ?
Ce module est accessible via l'onglet Configuration de la console > Actions > Modification groupée de la configuration :
Sélectionnez le type de données à exporter en fonction du contenu à mettre à jour. Vous avez le choix entre :
- Équipement
- Propriétés des équipements
- Propriétés redirigées
Cliquez ensuite sur « Exporter le fichier ».
Notez que tous les équipements/propriétés de la Box sont exportés. Pour modifier des éléments spécifiques, vous devrez utiliser les fonctions de filtre et de recherche d'Excel.
1) Exporter le contenu du fichier
Une fois les fichiers exportés, ils sont disponibles dans le répertoire de téléchargement standard. Vous pouvez y accéder via l'Explorateur de fichiers système. Leurs noms respectent la convention suivante :
Equipements | Propriétés | Propriétés redirigées (passerelle) |
export-bulk-equipment.xlsx | export-bulk-properties.xlsx | export-bulk-redirected-properties.xlsx |
Une fois téléchargés, vous pouvez les ouvrir avec Excel et y apporter les modifications souhaitées. Attention toutefois aux restrictions suivantes :
|
1.1) Fichier Équipement (export-bulk-equipment.xlsx)
Ce fichier contient deux feuilles de calcul : « Lisez-moi » et « Équipement ».
Vous ne devez modifier que la feuille Équipements.
Voici les colonnes du fichier Équipement. La première colonne Equipment Id est très importante et ne doit pas être modifiée. Elle servira de référence lors de l'importation.
Vous pouvez modifier toutes les colonnes marquées comme RW (Lecture/Écriture).
R | Certaines colonnes sont en lecture seule, ce qui signifie qu'elles sont présentes dans l'exportation à titre informatif uniquement et que si vous modifiez la valeur dans le fichier, elle ne sera pas prise en compte lors de l'importation. |
RW | D'autres colonnes (lecture écriture) peuvent être modifiées pour changer votre configuration. |
Pour supprimer des équipements en masse, retournez dans la console, sélectionnez-en plusieurs et choisissez l'option « Supprimer » sous « Actions ». La suppression de lignes dans le fichier Excel ne supprimera pas l'équipement. |
Voici les informations détaillées sur chaque colonne :
Nom de la colonne | Description | Type de valeur | Valeur éditable | Exemple |
Equipment ID | Identifiant unique de l'équipement dans la base de données. Ne pas modifier cette valeur. | ID alphanumérique | Non | Nv3tDsx4J7F2e4cb |
Equipment Name | Nom de l'équipement | Texte | Oui | Mon capteur LoRaWAN |
Equipment Description | Description de l'équipement | Texte | Oui | Compteur électrique du premier étage |
Equipment Protocol | Description du protocole | Texte | Non | LORAWAN_V1_0 |
Equipment Synchronized | Indique si l'équipement est synchronisé avec la box. |
- CURRENT si l'équipement est synchronisé avec la Box. - DRAFT sinon. |
Non | CURRENT |
Equipment Group | Nom du groupe auquel appartient l'équipement. S'il n'existe pas, un nouveau groupe sera créé. | Texte | Oui | 1er étage |
DevEUI | Device ID. Seulement pour équipements LoRaWAN | Valeur 64-bit hexadécimal | Oui | 1122AABBCCDDEEFF |
AppEUI | Application ID. Seulement pour équipements LoRaWAN | Valeur 64-bit hexadécimal | Oui | 1122AABBCCDDEEFF |
Application Key | Root key de l'équipement. Seulement pour équipements LoRaWAN | Valeur 128-bit hexadécimal | Oui |
1122AABBCCDDEEFF 1122AABBCCDDEEFF |
1.2) Propriétés de l'équipement (export-bulk-properties.xlsx)
Ce fichier contient trois feuilles de calcul : Lisez-moi, Propriétés et UNITS.
Seule la feuille de calcul Propriétés doit être modifiée.
La feuille de calcul UNITS ne doit pas être modifiée ; elle contient une bibliothèque pour le champ Property Unit (feuille de calcul Propriétés).
La feuille de calcul Propriétés contient les colonnes ci-dessous. La première colonne Property Id est très importante et ne doit pas être modifiée. Elle servira de référence lors de l'importation.
Vous pouvez modifier toutes les colonnes marquées RW.
Voici les informations détaillées sur chaque colonne :
Nom de la colonne | Description | Type de valeur | Valeur éditable | Exemple |
Property ID | Identifiant unique de la propriété dans la base de données. Ne pas modifier cette valeur. | ID alphanumérique | Non | Nv3tDsx4J7F2e4cb |
Property Equipment | Nom de l'équipement auquel appartient la propriété | Texte | Non | My LoRaWAN sensor |
Property Name | Nom de la propriété | Texte | Oui | Consommation |
Property Description | Description de la propriété | Texte | Oui | Suit la quantité totale d'énergie électrique consommée |
Property Slug | URL-friendly identifier | Texte | Oui | nv3tdsx4j7f2e4cb-frame-counter-rb97effckf |
Property Access Type | Indique si la propriété est accessible en lecture et/ou en écriture, ou si elle est locale (non envoyée vers le cloud). Vous pouvez choisir la valeur appropriée à l'aide de la liste déroulante de la cellule. |
Liste déroulante : - REMOTE_READ_ONLY - REMOTE_WRITE_ONLY - REMOTE_READ_WRITE - LOCAL |
Oui | REMOTE_READ_ONLY |
Property Interval |
Nombre de secondes entre deux lectures de données. Ce paramètre est utilisé par la Box lors de la lecture des données de l'équipement. La valeur minimale est de 600s pour les propriétés à distance et de 60s pour les propriétés locales. |
Entier | Oui | 600 |
Property Unit |
Unité d'ingénierie de la propriété. Choisissez la valeur correcte à l'aide de la liste déroulante de la cellule. |
Liste déroulante | Oui | kWH |
Property Scaling A | Si une mise à l'échelle est appliquée à cette propriété, la valeur a de la formule : a*x + b | Décimal | Oui | 0.1 |
Property Scaling B | Si une mise à l'échelle est appliquée à cette propriété, la valeur b de la formule : a*x + b | Décimal | Oui | 5 |
Redirect to | Si la propriété redirige vers une passerelle, nom de la propriété redirigée | Texte | Non | Redirected property name |
Property Synchronized | Indique si la propriété est synchronisée avec la Box. |
- CURRENT si l'équipement est synchronisé avec la Box - DRAFT sinon. |
Non | DRAFT |
Property Activation Status |
Indique si la propriété est activée ou non. Choisissez la valeur correcte dans la liste déroulante de la cellule. Utilisez ce champ pour supprimer ou désactiver plusieurs propriétés simultanément de votre configuration. |
Liste déroulante : - ENABLE - DISABLE |
Oui | ENABLE |
equipmentCodecId | Informations internes. Ne pas modifier cette valeur. | Non | ||
propertyCodecId | Informations internes. Ne pas modifier cette valeur. | Non | ||
equipmentId | Informations internes. Ne pas modifier cette valeur. | Non |
1.3) Propriétés redirigées (passerelle) (export-bulk-redirected-properties.xlsx)
Ce fichier contient quatre feuilles de calcul : Readme, Propriétés redirigées, UNITS et BACnetObjectTypes.
Vous ne devez modifier que la feuille de calcul Propriétés redirigées
Les feuilles de calcul UNITS et BACnetObjectTypes ne doivent pas être modifiées ; elles contiennent des bibliothèques pour la feuille de calcul Propriétés redirigées.
La feuille de calcul Propriétés redirigées contient les colonnes ci-dessous. La première colonne Redirected property Id est très importante et ne doit pas être modifiée. Elle servira de référence lors du processus d'importation.
Vous pouvez modifier toutes les colonnes marquées RW.
Voici les informations détaillées sur chaque colonne :
Nom de la colonne | Description | Type de valeur | Valeur éditable | Exemple |
Redirected property ID |
Identifiant unique de la propriété redirigée dans la base de données. Ne pas modifier cette valeur. |
ID alphanumérique | Non | Nv3tDsx4J7F2e4cb |
Redirected property Gateway | Nom de la passerelle à laquelle appartient la propriété | Texte | Non | MQTT Broker |
Redirected property Name | Nom de la propriété redirigée | Texte | Oui | Capteur température |
Redirected property Description | Description de la propriété redirigée | Texte | Oui | Point de données de la dernière température lue |
Redirected property Slug | URL-friendly identifier. Différent du slug MQTT, voir ci-dessous. | Texte | Oui | sgs2wiyjzk-wtgybegnvj1nvjpg-sensor-temperature |
Redirected property Access Type | Indique si la propriété redirigée est en lecture et/ou en écriture, ou si elle est locale (non envoyée vers le cloud). Vous pouvez choisir la valeur appropriée à l'aide de la liste déroulante de la cellule. |
Liste déroulante - REMOTE_READ_ONLY - REMOTE_WRITE_ONLY - REMOTE_READ_WRITE - LOCAL |
Oui | REMOTE_READ_ONLY |
Redirected property From | Nom de la propriété à partir de laquelle il est redirigé | texte | Non | Capteur de température (mon équipement) |
Redirected property To | Nom de la propriété vers laquelle il est redirigé | texte | Non | Température cible |
Redirected property Unit | Unité d'ingénierie de la propriété. Choisissez la valeur correcte à l'aide de la liste déroulante de la cellule. | Liste déroulante | Oui | °C |
Redirected property Synchronized | Indique si la propriété est synchronisée avec la Box. |
- CURRENT si l'équipement est synchronisé avec la Box - DRAFT sinon. |
Non | DRAFT |
Redirected property Register Address | Adresse du registre de la propriété. Uniquement pour les passerelles Modbus. | Entier | Oui | 66 |
Redirected property Register Type | Type de registre à utiliser. Uniquement pour les passerelles Modbus. Choisissez la valeur correcte dans la liste déroulante de la cellule. |
Liste déroulante - INPUT_DISCRETE - INPUT_REGISTER - HOLDING_REGISTER - COIL |
Oui | INPUT_REGISTER |
Redirected property Data Format |
Format des données. Uniquement pour les passerelles Modbus. Choisissez la valeur correcte dans la liste déroulante de la cellule. |
Liste déroulante | Oui | int32_abcd |
Redirected property Raw Register | Raw register à utiliser Uniquement pour les passerelles Modbus. | Entier | Oui | 60 |
Redirected property Object Type |
Type d'objet. Uniquement pour les passerelles BACnet. Choisissez la valeur correcte dans la liste déroulante de la cellule. |
Liste déroulante | Oui | OBJ_INTEGER_VALUE |
Redirected property Object Instance | ID d'instance de l'objet. Uniquement pour les passerelles BACnet. | Entier | Oui | 2 |
Redirected property MQTT Slug | Slug utilisé comme identifiant de la valeur de la propriété sur MQTT. Uniquement pour les passerelles MQTT. | Texte | Oui | adeunis-arf8275a-comfort-humidity-3hq11strs1 |
2) Réimporter les données
Une fois les données modifiées selon vos souhaits (étape 2 de l'interface), vous pouvez réimporter le fichier .xlsx.
Retournez à la console et passez à l'étape 3. Vous pouvez glisser-déposer votre fichier dans la zone grise ou choisir un fichier avec le bouton dédié, puis naviguer dans l'explorateur de fichiers.
3) Exemples
3.1) Déplacer des équipements vers un nouveau groupe « Deuxième étage »
La première étape consiste à exporter le fichier via le bouton « Équipement », puis à modifier le groupe d'équipements dans le fichier xlsx :
Enregistrez et réimportez le fichier :
Les équipements ont été déplacés au deuxième étage comme demandé :
N'oubliez pas de sauvegarder la configuration :
3.2) Ajout de la propriété Batterie à tous les capteurs LoRaWAN
La première étape consiste à exporter le fichier via le bouton « Propriétés des équipements », puis à modifier l'état d'activation de la propriété (colonne = Property Activation Status) ( DISABLE-> ENABLE) dans le fichier xlsx :
Enregistrez et réimportez le fichier.
Les propriétés Niveau de batterie sont activées dans la configuration de la console pour tous les équipements modifiés dans le fichier xlsx.
Si vous avez besoin d'informations supplémentaires, veuillez nous contacter ici.