Fichier : Export spécifique des plannings Gestil

Objet de l'interface

L’interface permet d’exporter les plannings prévisionnels (plages horaires et repos) construits avec Timesquare et de les mettre au format attendu par Gestil. Le fichier sera lu et interprété par Gestil de manière à mettre à jour les dossiers salariés dans la base de données. Le fichier contient les heures travailles du personnel par jour saisies dans Timesquare pour la période sélectionnée. Une ligne par personne et par plage de travail.

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

Nom du fichier

Le nom du fichier est libre.

Fichier unique

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

Exemples : Plannings.txt, Réalisé_Timesquare.001.

Fichiers multiples (un fichier par mois)

Le nom du fichier doit suivre une syntaxe particulière incluant la date des données proposées. LibelléMMAAAA.EXT est la dénomination retenue où "Libellé" est une chaîne de caractères alphanumériques et "EXT" une chaîne alphanumérique de trois caractères maximum.

Exemples : Plannings_062019.txt, Prévisionnel-Timesquare-062019.txt.

Fichiers multiples (un fichier par jour)

Le nom du fichier doit suivre une syntaxe particulière incluant le jour et le mois des données proposées. Il existe deux possibilités :

• TexteJJMMAAAA.EXT où Texte est une chaîne de caractères alphanumériques qui sera fixe, JJ correspond au jour, MM correspond au mois, AAAA correspond à l'année et EXT une chaîne alphanumérique de trois caractères maximum. Exemples : site1_13022025.txt, réalisé13022025.001, 13022025.csv.
• TexteYYYYMMDD.EXT où Texte est une chaîne de caractères alphanumériques qui sera fixe, YYYY correspond à l'année, MM correspond au mois, DD correspond au jour et EXT une chaîne alphanumérique de trois caractères maximum. Exemples : site1_20250213.txt, réalisé20250213.001, 20250213.csv.

Il est également possible d'ajouter l'heure dans le libellé du fichier : hhmmss où hh correspond aux heures, mm correspond aux minutes et ss correspond aux secondes. Exemple : plannings20250213-142105.csv

Avec ce formatage, et en fonction du filtrage de dates renseigné dans le paramétrage, l’export produit un fichier par jour exporté.

Format

Texte.

Séparateur entre deux informations

Le séparateur entre deux informations est le point-virgule (;) ou la tabulation (   ).

Description des lignes du fichier

Informations	Type	Taille	Format
Matricule du salarié	Alphanumérique	8	Complété par des 0 à gauche
Code société	Alphanumérique	3 max	Code à renseigner
Date	Date	10	AAAA/MM/JJ
Heure de début de plage	Heure	6	HH:MM
Heure de fin de plage	Heure	6	HH:MM

Règles de gestion

• JJ = Numéro de jour (01 – 31)
• MM = Numéro de mois (01 – 12)
• AA, AAAA = Année (2 et 4 chiffres)
• HH = Heures (00 – 24)
• NN = Minutes (00 – 59)

Le matricule permet d’identifier la personne concernée et doit être renseigné dans Timesquare. Si la longueur du matricule est inférieure à 8 caractères, il sera complété par des 0 à gauche jusqu’à atteindre 8 caractères.

Seules les plages de travail et les jours de repos sont exportés dans le fichier. Les journées non travaillées (repos, absence complète, etc.), les absences partielles ainsi que les indisponibilités n’apparaitront pas dans le fichier.

Si une absence, une tâche ou une convocation présente dans l'export est supprimée après la création de l'export, elle est également supprimée de l'export. Si l'absence, la tâche ou la convocation supprimée est la dernière de la configuration, elle n'est pas supprimée et un message d'erreur s'affiche au moment de l'exécution de l'export. 

Lorsqu’un planning est à cheval sur 00:00, on ajoute le signe + à la fin du champ Heure de fin. Par ailleurs, si l'heure de changement de jour définie dans Timesquare est supérieure à minuit :

• Lorsqu’une plage horaire HDébut - HFin est telle que Hdébut < minuit et HFIN <=HCJ alors on exporte une ligne avec un “+” après l’heure de fin (HDébut HFin+)
• Lorsqu’une plage horaire HDébut - HFin est telle que Hdébut >= minuit et HFIN <=HCJ alors on exporte une ligne avec un “+” après l’heure de début et l’heure de fin (HDébut+ HFin+)
• Lorsqu’une plage horaire HDébut - HFin telle que Hdébut < minuit et HFIN <=Minuit alors on exporte une ligne sans signe “+” (HDébut HFin)