Fichier : Import standard des pointages bruts

View the English version

Objet de l'interface

L’interface permet d’importer les pointages bruts depuis un logiciel tiers vers Timesquare. 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.

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 plusieurs journées. Le fichier contient une ligne par pointage brut.

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 pointages.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux pointages_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, LibelléAAMMJJ.EXT, JJMMAAAALibellé.EXT, JJMMAALibellé.EXT, AAAAMMJJLibellé.EXT, AAMMJJLibellé.EXT, LibelléDDMMYYYY.EXT, LibelléDDMMYY.EXT, LibelléYYYYMMDD.EXT, LibelléYYMMDD.EXT, DDMMYYYYLibellé.EXT, DDMMYYLibellé.EXT, YYYYMMDDLibellé.EXT, YYMMDDLibellé.EXT, sont les dénominations retenues où :

• "Libellé" est une chaîne de caractères alphanumériques que je peux personnaliser
• "JJ" et "DD"correspondent au jour, "MM" correspond au mois, "AA", "AAAA", "YY" et "YYYY" correspondent à 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 pointages_JJMMAA.txt et les trois fichiers d'import se nomment pointages_040521.txt, pointages_050521.txt et pointages_060521.txt.

Exemple 2 : Le champ Libellé dans la configuration se nomme pointagesYYYYMMDD.001 et les trois fichiers d'import se nomment pointages20200504.001, pointages20200505.001 et pointages20200506.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.

• Si on a plusieurs fichiers avec la même date et des heures différentes, le système récupère le fichier le plus récent, en fonction de l'heure enregistrée dans le libellé du fichier.

• Si on a plusieurs fichiers avec des dates différentes, le système récupère le fichier dont la date est la plus récente.

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	Date de pointage	Date	JJ/MM/AAAA, JJMMAAAA (paramétrable)
02	Heure de pointage	Heure	HMM, HH:MM (paramétrable)
03	Personne concernée	Alphanumérique	Badge, matricule, matricule paie, champ divers
04	Type de pointage	Alphanumérique	1 pour Entrée 2 pour Sortie 5 pour Pause

Règles de gestion

Si le badge est sélectionné comme identifiant à utiliser, c’est le code interne qui est attendu dans le fichier d’import.

Le type de pointage est un champ facultatif. La colonne peut rester vide si cette information n’existe pas dans le système qui fournit le fichier à importer. Le type de pointage n’est pas utilisé lors de l’import.

Les pointages sont intégrés dans l'ordre dans lequel ils sont affichés dans le fichier, sur une même journée.

Les pointages après minuit ne tiennent pas compte de l’heure de changement de jour.

Exemple : J’ai une heure de changement de jour à 06h00. Le 08/03/2021, je pointe à 14h13, puis 17h56, puis 20h01 et enfin 00h02. Le fichier d’import associé est donc :

08/03/2021;14:13;MAT001;; 
08/03/2021;17:56;MAT001;; 
08/03/2021;20:01;MAT001;; 
09/03/2021;00:02;MAT001;;

Exemple de contenu

Exemple de fichier

13/02/2026;09:04;BRZ04;1;
13/02/2026;17:06;BRZ04;2;
13/02/2026;09:17;BRZ05;1;
13/02/2026;16:49;BRZ05;2;
13/02/2026;09:06;BRZ06;1;
13/02/2026;17:04;BRZ06;2;