Passerelle CSV multicolonne

Avatar
Carla Fité

Dans cet article, vous allez découvrir comment fonctionne la passerelle CSV multicolonne, disponible sur la plateforme EMS.

Contenu de cet article :

Qu’est-ce qu’une passerelle CSV multicolonne ?

La passerelle CSV multicolonne permet d’insérer des données sur la plateforme à l’aide de fichiers au format CSV multicolonne, en organisant les données de chaque jour dans des colonnes. Cette passerelle vous permet d’adapter et de mapper vos fichiers de données multicolonnes de manière personnalisée, comme expliqué ici. Ces fichiers peuvent être insérés via la passerelle CSV multicolonne par e-mail, FTP ou SFTP. 

 

Enregistrer une passerelle CSV multicolonne dans EMS

Pour enregistrer cette passerelle, suivez ces étapes et sélectionnez la passerelle CSV multicolonne (FTP ou e-mail).
 

Dans les paramètres de la passerelle, choisissez un nom et sélectionnez votre fuseau horaire. Les passerelles multicolonnes FTP et e-mail afficheront les informations de connexion correspondantes, qui fonctionnent exactement comme leurs équivalents génériques FTP et e-mail. Utilisez les informations de connexion affichées pour envoyer vos données.

 

Captura_de_pantalla_2021-01-05_a_las_12.51.44.png

 

Dans la configuration de la passerelle, renseignez les champs suivants :

  • Nom : choisissez le nom de la passerelle.
  • Fuseau horaire : sélectionnez le fuseau horaire correspondant.
  • Mode d’insertion : discret ou cumulé. Pour plus d’informations, consultez cette section.
  • Format de date : local ou UTC.
  • Colonne de date : indiquez le caractère de la colonne du fichier csv où la date, c’est-à-dire le jour, est indiquée.
  • Colonne du compteur : indiquez le caractère de la colonne du fichier csv où le nom du compteur est indiqué.

  • Colonne des unités ou du paramètre : indiquez le caractère de la colonne du fichier csv où l’identifiant du paramètre est indiqué. Si vous ne disposez d’aucune colonne contenant les paramètres, sélectionnez « None » et, dans le champ Paramètre par défaut, sélectionnez le paramètre souhaité, tel que l’énergie active (402), l’énergie du gaz (420) ou l’eau (901), et bien d’autres à venir ! Pour plus d’informations sur les identifiants des paramètres, cliquez ici. 

    - Veuillez noter que sélectionner Gaz entraînera l’utilisation du paramètre Énergie du gaz (420) par la plateforme.



                          
     

  • Première colonne de données : indiquez le caractère de la colonne du fichier csv où commencent les données. 
  • Première ligne de données : indiquez le numéro de la ligne du fichier csv où commencent les données.

Remarque :  Si vous sélectionnez « None » dans le champ Paramètre par défaut, notre plateforme sélectionnera l’énergie active (402) par défaut. Veillez donc à sélectionner le paramètre souhaité. 

Découvrez comment configurer le fichier CSV dans cette section avec un exemple. 

 

Insérer des données via une passerelle CSV multicolonne

Mode d’insertion

3 modes sont disponibles :

  • Valeurs de type intervalle de temps (données discrètes) : dans ce mode, la passerelle insérera la consommation de chaque période telle qu’elle est indiquée dans le fichier CSV envoyé.*
  • Valeurs de type intervalle de temps : dans ce mode, la passerelle cumule les données de consommation pour chaque jour et insère la mesure cumulée sur la plateforme, en supposant qu’elle est réinitialisée à 0 chaque jour à 00:00. (ex. : consommation électrique de 15 min, consommation d’eau de 30 min).
  • Valeurs instantanées/cumulées : pour les données importées avec des valeurs cumulées (ex. : consommation électrique de 15 min ajoutée au fil du temps et insérée de cette manière). 

    Les paramètres dont le type de nature est « instantané » (tels que la température, la puissance, etc.) seront uniquement insérés avec le mode d’insertion « valeurs instantanées/cumulées, insérer telles quelles »

                   

* Remarque :

Si vous envoyez des données horaires avec le mode d’insertion discrète, la passerelle calculera et insérera les valeurs à une fréquence de 30 min en divisant la valeur horaire par 2.

Exemple : Imaginez que vous avez une valeur horaire de 10 kWh à 01:00, ce qui signifie que votre consommation entre 01:00 et 02:00 est de 10 kWh. L’analyseur CSV multicolonne divisera cette valeur par 2 (l’interpolera) et l’insérera dans DEXMA :
- 5 kWh à 01:30
- 5 kWh à 02:00

Ce processus est effectué afin que vous puissiez attribuer un coût à vos appareils, car une fréquence de 30 min est requise.

 

À garder à l’esprit

Veuillez noter que cette passerelle traite uniquement les variables continues. Il est donc impossible d’insérer des données de variables non continues, telles que la puissance. Si vous souhaitez insérer des variables discrètes, nous vous recommandons soit de manipuler les valeurs de la variable afin qu’elle devienne continue (en insérant par exemple l’énergie au lieu de la puissance à l’aide de moyennes horaires), soit d’utiliser une autre passerelle.

 

Préparer un fichier CSV multicolonne 

Format du fichier

Le fichier doit être au format CSV séparé par des virgules.

 

Fréquences disponibles

La passerelle accepte les fichiers contenant des données toutes les 15 min, 30 min ou toutes les heures. Elle nécessite donc exactement 24, 48 ou 96 colonnes pour les relevés, respectivement.

 

Champs du fichier

Le fichier doit contenir les champs suivants afin que les informations CSV correspondent à la configuration de la passerelle.

  • Nom du compteur : indiquez les noms des compteurs dans une colonne.
  • Date : indiquez la date, au format J/M/A, du jour auquel correspondent les données de chaque ligne. (Ex. : 21/02/2021 ou 21/02/21).
  • Identifiant du paramètre : indiquez la clé ou l’identifiant du paramètre des données que vous insérez. Découvrez comment indiquer le paramètre ici.
  • Lignes et colonnes de données : les relevés de données de chaque jour sont ajoutés par ligne. Cela signifie qu’une journée de données correspond à une ligne. Dans cette ligne, vous devez indiquer dans trois des colonnes le nom du compteur, l’identifiant du paramètre et la date. Les données occuperont les 24, 48 ou 96 colonnes suivantes, selon la fréquence des données. Le format des données doit être un nombre utilisant « . » ou « , » comme séparateur décimal.

 

Spécification des paramètres

Plusieurs options permettent d’indiquer le paramètre inséré. Tout d’abord, pour insérer n’importe quel type de paramètre disponible sur la plateforme, vous devez indiquer son identifiant (ID), disponible dans cette liste.

L’indication de l’ID du paramètre de l’énergie active est facultative. Si vous n’utilisez aucune colonne pour l’indiquer dans la configuration du fichier CSV, sélectionnez l’option None dans l’option Colonne des unités ou des paramètres de la configuration de la passerelle. 

Si le paramètre à insérer est l’énergie réactive ou l’énergie réactive capacitive, les clés suivantes peuvent également être utilisées comme ID du paramètre :

  • LAG : énergie réactive (paramètre 404)
  • LEAD : énergie réactive capacitive (paramètre 408)
 

Exemple

Voici un exemple illustrant la configuration de la passerelle à partir du fichier CSV. Vous trouverez ci-dessous un exemple de fichier CSV :

 

Captura_de_pantalla_2021-01-08_a_las_8.15.55.png
 
Les champs de la passerelle sont renseignés pour correspondre aux informations du fichier CSV.
 

Dans l’exemple de fichier :

  • Nom du compteur : colonne A (compteur 1, compteur 2)
  • Date : colonne C (01/11/2020...)
  • Identifiant du paramètre : colonne B (402, énergie active)
  • Première colonne de données : colonne D
  • Première ligne contenant des données : ligne 2

Le nombre de colonnes contenant des données est de 24 ; la fréquence des données est donc horaire. 

 
 
 
 
 

Articles dans cette section