Fichier : Import standard des valeurs de compteurs de reporting

View the English version

Objet de l'interface

L’interface permet d’importer les valeurs des différents compteurs de reporting calculés par un système tiers à une date donnée. Le principe est de mettre à disposition les informations attendues dans un fichier de type texte qui sera lu et interprété par l’interface de façon à mettre à jour la base de données. Il est possible d'importer des valeurs uniques, hebdomadaires ou périodiques.

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

Nom du fichier

Le nom du fichier est libre (libellé + extension) mais une fois défini dans le paramétrage de l’import, il ne doit plus changer. Il peut contenir des informations relatives à un ou plusieurs compteurs concernant une ou plusieurs personnes.

Exemples : Compteurs_A.txt, Compteurs_Timesquare.001, Compteurs.csv.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations est le point-virgule.

Description des lignes du fichier

Ordre	Nom du champ	Type	Remarques
01	Code du compteur	Alphanumérique	Sans espace ni caractère spécial
02	Matricule personne concernée	Alphanumérique	Sans espace ni caractère spécial
03	Date de valeur / Date de début	Date	JJ/MM/AAAA (jour, mois, année)
04	Valeur du compteur	Numérique	XXXXXXXXYY Pourra être interprété comme un nombre d’heures, un entier ou un réel selon la nature* du compteur.
05	Date de début	Date	JJ/MM/AAAA (jour, mois, année), date de début pour les compteurs périodiques et hebdomadaires, vide pour les autres compteurs
06	Date de fin	Date	JJ/MM/AAAA (jour, mois, année), date de fin pour les compteurs périodiques et hebdomadaires, vide pour les autres compteurs

Règles de gestion

* La nature du compteur est définie lors de la création de celui-ci dans Timesquare et selon le cas, XXXXXXXXYY sera interprété comme :

• Un nombre entier : YY toujours égal 00. 123 apparaît dans le fichier de la façon suivante 12300.
• Une valeur réelle : YY sont les deux décimales représentatives du compteur concerné. 526,98 apparaît dans le fichier de la façon suivante 52698.
• Un nombre d’heures : YY représente les minutes et XXXXXXXX les heures. 122h38 apparaît dans le fichier de la façon suivante 12238.

Pour les compteurs à valeur unique, la date de valeur est égale à la date de mise à jour du compteur.

Pour les compteurs à valeur hebdomadaire, la date de valeur doit être la date du premier jour de la semaine. La date de fin peut également servir comme date de fin dans le cas d'un compteur hebdomadaire se rapportant à une semaine partielle. Exemple : une valeur de DHR partielle.

Pour les compteurs à valeur périodique, on utilise les colonnes Date de début et Date de fin pour indiquer la période à laquelle la valeur se rapporte. Dans ce cas :

• Si la valeur à importer n’a aucune période commune avec les valeurs déjà présentes dans la 
  base de données, alors une nouvelle valeur est insérée dans la base de données.
• Si la valeur à importer est strictement identique à une valeur déjà présente dans la base de 
  données, alors une nouvelle valeur est insérée dans la base de données, elle annule et 
  remplace la cible existante.
• Si la valeur à importer est incluse dans une valeur déjà présente, alors une nouvelle valeur est 
  insérée dans la base de données. Elle annule et remplace la valeur existante.
• Si la valeur à importer a une période commune avec une ou plusieurs valeurs déjà présentes, 
  alors une nouvelle valeur est insérée dans la base de données. Elle annule et remplace les 
  valeurs existantes ayant une période commune.
• Si la valeur à importer recouvre entièrement une ou plusieurs valeurs déjà présentes sans être 
  identique à l’une des valeurs présentes, alors une nouvelle valeur est insérée dans la base de 
  données, elle annule et remplace les valeurs existantes ayant une période commune.

Pour les compteurs à valeur hebdomadaire, on utilise les colonnes Date de début et Date de fin pour indiquer la période à laquelle la valeur se rapporte. Cette période est notamment nécessaire afin de traiter le cas des semaines partielles de DHR, par exemple en début et fin de période d'annualisation. 

Dans ce cas :

• Si la valeur à importer n’a aucune période commune avec les valeurs déjà présentes dans la 
  base de données, alors une nouvelle valeur est insérée dans la base de données.
• Si la valeur à importer est strictement identique à une valeur déjà présente dans la base de 
  données, alors une nouvelle valeur est insérée dans la base de données, elle annule et 
  remplace la cible existante.
• Si la valeur à importer est incluse dans une valeur déjà présente, alors une nouvelle valeur est 
  insérée dans la base de données. Elle annule et remplace la valeur existante.
• Si la valeur à importer a une période commune avec une ou plusieurs valeurs déjà présentes, 
  alors une nouvelle valeur est insérée dans la base de données. Elle annule et remplace les 
  valeurs existantes ayant une période commune.
• Si la valeur à importer recouvre entièrement une ou plusieurs valeurs déjà présentes sans être 
  identique à l’une des valeurs présentes, alors une nouvelle valeur est insérée dans la base de 
  données, elle annule et remplace les valeurs existantes ayant une période commune.

Exemple de contenu

Exemple de fichier (compteur de reporting périodique)

BRZCPACQ26;BRZ01;01/01/2026;178200;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ02;01/01/2026;145600;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ03;01/01/2026;178200;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ04;01/01/2026;178200;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ05;01/01/2026;178200;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ06;01/01/2026;178200;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ07;01/01/2026;52000;01/01/2026;31/12/2026;
BRZCPACQ26;BRZ08;01/01/2026;178200;01/01/2026;31/12/2026;