Fichier : Export standard des absences - Initial

View the English version

Objet de l'interface

L’interface permet d’extraire les absences issues du planning initial disponibles dans Timesquare^® de manière à mettre à disposition les informations attendues dans un fichier de type texte qui pourra être lu et interprété par une solution tierce. Cet export peut être réalisé à la demande ou de manière automatique.

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

Nom du fichier

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 : Absence_A.txt, Absences_Timesquare.001, Absence.csv.

Fichiers multiples (un fichier par jour)

Le fichier peut être nommé de plusieurs façons selon que Timesquare génère un fichier différent pour chaque jour ou un fichier unique contenant une ou plusieurs journées d’absence.

Le nom du fichier doit suivre une syntaxe particulière incluant le jour et le mois des données proposées. La dénomination retenue est TexteAAAAMMJJ.EXT où :

• Texte est une chaîne de caractères alphanumériques qui est fixe
• AAAA correspond à l'année
• MM correspond au mois
• JJ correspond au jour
• EXT une chaîne alphanumérique de trois caractères maximum

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

Exemples : absence_20250202.txt, absence20250202.001, 20250202.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

Nom du champ	Format	Remarques
Identifiant du salarié	Alphanumérique	Matricule, matricule paie, identifiant du salarié sélectionné dans le paramétrage
Code du motif d’absence	Alphanumérique	Code événement paramétré dans l'export
Date de début de l’absence	Date	JJ/MM/AAAA
Date de fin de l’absence	Date	JJ/MM/AAAA
Valorisation heure	Numérique	HHhNN (heures et minutes).
Valorisation jour	Numérique	Format 0.0

Règles de gestion

En cas d’absence partielle, la colonne Valorisation heure s’alimente avec le nombre d’heures d’absence. Exemple : 03h00. La valorisation jour s’alimente avec le nombre de jours, par exemple pour une absence partielle de 3h, la colonne Valorisation jour s’alimente avec "0.5".

En cas d’absence complète, la colonne Valorisation heure s’alimente avec la durée quotidienne d’absence.

Si une absence 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 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. 

Si l'option Exclure les repos et jours fériés de la période d'absence exportée n'est pas cochée, la période d'absence comprend les éventuels repos et/ou jours fermés adjacents à la période d'absence effective saisie dans Timesquare.

Exemple : 

Dans l'exemple ci-dessus :

• si l'option Exclure les repos et jours fériés de la période d'absence exportée est cochée, la ligne s'exporte comme suit :
  MAT001;CP;04/04/2025;05/04/2025;14h30;2.0
• si l'option Exclure les repos et jours fériés de la période d'absence exportée n'est pas cochée, la ligne s'exporte comme suit :
  MAT001;CP;03/04/2025;06/04/2025;14h30;2.0

Exemple de contenu

MAT001;MAL;14/07/2021;15/07/2021;00h00;1.0
MAT002;RTT;12/07/2021;14/07/2021;03h00;0.5
MAT003;CP;12/07/2021;12/07/2021;00h00;1.0