Fichier : Import standard des valeurs d'une donnée stockée

View the English version

Objet de l'interface

L’interface permet d’importer des valeurs de données stockées quel que soit leur type de manière automatique ou manuelle. Le principe est de mettre à disposition les informations attendues dans un fichier de type texte de format unique quelle que soit la donnée (1/4 heure, jour, mois, etc.) qui sera lue et interprétée par l’interface de façon à mettre à jour la base de données.

En savoir plus sur le paramétrage de cet import.

Nom du fichier

Le fichier peut être nommé de deux façons selon que le système tiers le mettant à disposition génère un fichier différent pour chaque jour ou un fichier unique contenant une ou plusieurs journées d’historique.

Fichier unique

Le nom du fichier d'import est libre (libellé + extension) mais une fois défini dans le paramétrage de l’import, il ne doit plus changer.

Exemple 1 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux fluxentrants.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux historique_Timesquare.001.

Fichiers multiples

Les noms des fichiers d'import doivent suivre une syntaxe particulière incluant la date des données proposées. Le champ Libellé du fichier doit expliciter la nomenclature choisie. Ainsi, LibelléJJMMAAAA.EXT, LibelléJJMMAA.EXT, LibelléAAAAMMJJ.EXT ou LibelléAAMMJJ.EXT sont les dénominations retenues où :

• "Libellé" est une chaîne de caractères alphanumériques que je peux personnaliser
• "JJ" correspond au jour, "MM" correspond au mois, "AA" et "AAAA" correspond à l'année, qui peut être indifféremment renseignée sur 2 ou 4 caractères
• "EXT" une chaîne alphanumérique de trois caractères au maximum que je peux personnaliser

Exemple 1 : Le champ Libellé dans la configuration se nomme site1_JJMMAA.txt et les trois fichiers d'import se nomment site1_040520.txt, site1_050520.txt et site1_060520.txt.

Exemple 2 : Le champ Libellé dans la configuration se nomme fluxsiteAAAAMMJJ.001 et les trois fichiers d'import se nomment fluxsite20200504.001, fluxsite20200505.001 et fluxsite20200506.001.

Exemple 3 : Le champ Libellé dans la configuration se nomme AAMMJJ.txt et les trois fichiers d'import se nomment 040520.txt, 050520.txt et 060520.txt.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations peut être le point-virgule, la virgule, la barre verticale ou la tabulation.

Description des lignes du fichier

Ordre	Nom du champ	Type	Remarques
01	Identifiant de la donnée	Alphanumérique	Code de la donnée stockée maximum 12 caractères
02	Date du jour	Date	JJ/MM/AAAA
03	Début tranche horaire	Heure	HH:NN (heures, minutes) peut être vide dans le cas de données de type jour, semaine ou mois
04	Fin tranche horaire	Heure	HH:NN (heures, minutes) peut être vide dans le cas de données de type jour, semaine ou mois
05	Valeur	Alphanumérique

Règles de gestion

• Lors que le mode de saisie de la donnée stockée à alimenter est jour, semaine ou mois, Début tranche horaire et Fin tranche horaire sont vides.
• Mode de saisie jour : la valeur est affectée à la date du jour.
• Mode de saisie semaine : la valeur est affectée au mois correspondant à la date du jour.
• Si le mode de saisie de la donnée est égal à Fin tranche horaire moins Début tranche horaire ou si le mode de saisie est créneau, alors la valeur est affectée à la tranche horaire importée pour la date importée.

Exemple de contenu

A133;25/03/2019;09:00;09:15;5
A133;25/03/2019;09:15;09:30;8
A133;25/03/2019;09:30;09:45;13
A133;25/03/2019;09:45;10:00;18
A133;25/03/2019;10:00;10:15;20
458;24/03/2019;10:00;12:00;25
458;24/03/2019;12:00;15:00;35
458;24/03/2019;15:00;20:00;65
458;25/03/2019;10:00;12:15;33
458;25/03/2019;13:00;15:30;42
458;25/03/2019;15:30;20:00;58
525;21/03/2019;;;578,33
525;22/03/2019;;;345,18
525;23/03/2019;;;478,58
525;24/03/2019;;;625,4
525;25/03/2019;;;333,9
MET;21/03/2019;;;Soleil
MET;22/03/2019;;;Pluie
MET;23/03/2019;;;Pluie
MET;24/03/2019;;;Nuageux
MET;25/03/2019;;;Nuageux