FTP : Envoi de données métriques

Infrastructure FTP

Hébergement du serveur

Le partenaire hébergera un serveur FTP/FTPS ou SFTP. Il transmettra les identifiants d’accès (Hôte, Identifiant, Mot de passe, Port) à Intent Technologies ( serviceclient@intent.tech ).

Un dossier spécifique sera créé sur le serveur et son nom communiqué à Intent Technologies. Intent viendra y récupérer les fichiers contenant les données pour les intégrer sur la plateforme.
Récapitulatif des informations à transmettre à Intent

Serveur FTP/SFTP
Hôte :
Identifiant :
Mot de passe :
Port :
Nom du dossier contenant les fichiers :

Fichier csv
Nom des colonnes (si différent de la proposition d’Intent)
streamRef = … 
date = … 
valeur = … 
sensorId = … 
Séparateur :
Format de date :

Création d'un flux de données metrics par FTP

La 1ère étape avant tout envoi de données est la création d’un flux de données, appelé stream. L’intégralité des informations pour créer un flux de données est disponible dans notre  documentation en ligne .
Ici, nous allons détailler la création des flux metrics par FTP

Création des flux de données

Afin de créer les flux de données, le partenaire complète un fichier de création de flux qu’il transmettra au service client ( serviceclient@intent.tech ) afin qu’il soit importé sur la plateforme.

Ce fichier type de création de flux est disponible auprès du service client.
Il contiendra les colonnes suivantes :
  • référence du flux (streamReference)
  • label du flux (label)
  • description (description)
  • type du flux (type)
  • unité (intent_unit)
  • assetReference (rattachement à un élément de patrimoine) (intent_assetReference)
  • activités mesurées (intent_activityKey)
  • type de données mesurées (intent_dataType)
  • fréquence (intent_frequency)
  • contrat (intent_contractReference)
  • informations complémentaires (tag libre)


https://slite.com/api/files/6xhSFYIY9/63_Da8mDV548GhOmwAw2l1zJXpfsRS-NyQFdmDU-59_PafpZiWkmvvSpVyHQKZ-U4ysF4fR5SK5FiqEBaaSLJhXoPI3dh3qN3kJqCS6BWdr_60Jo2jsKwAmaT-MQ5sulGTjlhwCV?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoia0M1c21RWElQQiIsImlhdCI6MTcyOTA5MjU3NSwiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJHUDFpRWdaVXNMbXd2OSIsImV4cCI6MTczMTY4NDU3NX0.98i6Ux9r0Hu01dxGf-2z36WBl_hQpkPUmT_FIIryDHU
La signification des différentes colonnes sont décrites  ici 

Envoi des données

La transmission des données se réalise par la mise à disposition d’un fichier .csv. Le fichier doit contenir à minima 4 colonnes.
Intent Technologies se basera sur ces 4 colonnes pour intégrer les données. Si des colonnes supplémentaires sont renseignées, elles ne gêneront pas l’import mais ne seront pas prises en compte.

Intent Technologies recommande le nommage des 4 colonnes de la façon suivante :
  • streamRef (référence du flux de données)
  • date (date de la mesure)
  • value (valeur mesurée)
  • sensorId (provenance de la donnée - identifiant du capteur)

Le champ sensorId est purement technique. Il ne sera pas affiché sur intentPlatform. 

Lors de la configuration du serveur, le partenaire devra transmettre à Intent Technologies les informations suivantes :
  • séparateur ( ; ou , )
  • format de la date (YYYY-MM-DDTHH:mm:ss ou DD/MM/YYYY HH:mm:ss ou autre)