Fichier : Export spécifique des absences Chronogestor

Objet de l'interface

L’interface permet d’extraire les absences prévisionnelles et réalisées 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 la solution Chronogestor. 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

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.

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 nom du fichier doit suivre une syntaxe particulière incluant le jour/mois/année des données proposées. La dénomination retenue est TexteAAAAMMJJ.EXT où Texte est une chaîne de caractères alphanumériques qui sera fixe, AAAA correspond à l’année, MM correspond au mois, JJ correspond au jour et 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 : site1_20210213.txt, abs20210213.001, 20210213.csv.

Format

Texte. Encodage ANSI.

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 Chronogestor	Numérique
Motif d’absence	Alphanumérique
Date de début de l’absence	Date	JJMMAAAA Date de début d’une période d’absences de même nature de Timesquare (mêmes motifs, mêmes unités)
Date de fin de l’absence	Date	JJMMAAAA Date de fin d’une période d’absences de même nature de Timesquare (mêmes motifs, mêmes unités). Identique à la date de début s’il s’agit d’une absence en jour ou en heures qui n’est présente que sur une seule journée.
Unité de début de l’absence	Alphanumérique	J : jour, M : matin, S : soir, H : heures
Unité de fin de l’absence	Alphanumérique	J : jour, M : matin, S : soir, H : heures
Durée de l’absence	Numérique	HHNN (heures et minutes). Si absence en jour, matin ou soir, envoyer 0. Ne doit jamais être reçu vide. Mettre 0 par défaut.
Heure de début de l’absence	Numérique	HHNN (heures et minutes). Si absence en jour, matin ou soir, envoyer 0. Ne doit jamais être reçu vide. Mettre 0 par défaut.
Heure de fin de l’absence	Numérique	HHNN (heures et minutes). Si absence en jour, matin ou soir, envoyer 0. Ne doit jamais être reçu vide. Mettre 0 par défaut.
		Laisser à blanc
		Laisser à blanc
		Laisser à blanc

Règles de gestion

• La liste des absences reçues est triée suivant le matricule puis la date de début de l’absence.
• Les codes absences sont transcodées par Timesquare (si motif différent de motif ChronoGestor).
• Les unités reçues sont une des unités ci-dessous :
  • "J" : journée entière
  • "M" : l’absence couvre la matinée et se termine à "midi" pour la journée
  • "S" : l’absence couvre l’après-midi et débute à "midi" pour la journée concernée
  • "H" : Il est possible de recevoir des absences en heures
• Les colonnes Unité de début et Unité de fin de l’absence prennent la valeur "J" lorsqu’une absence complète au sens Timesquare est rencontrée. Dans ce cas :
  • La colonne Durée de l’absence est vide
  • La colonne Heure de début est vide
  • La colonne Heure de fin est vide
• Les colonnes Unité de début et Unité de fin de l’absence prennent la valeur "M" lorsqu’une absence partielle au sens Timesquare est rencontrée et que ses heures de début et de fin correspondent au paramétrage d’une absence matin dans les spécificités de l’interface. Dans ce cas :
  • La colonne Durée de l’absence est vide
  • La colonne Heure de début est vide
  • La colonne Heure de fin est vide
• Les colonnes Unité de début et Unité de fin de l’absence prennent la valeur "S" lorsqu’une absence partielle au sens Timesquare est rencontrée et que ses heures de début et de fin correspondent au paramétrage d’une absence après-midi dans les spécificités de l’interface. Dans ce cas :
  • La colonne Durée de l’absence est vide
  • La colonne Heure de début est vide
  • La colonne Heure de fin est vide
• Les colonnes Unité de début et Unité de fin de l’absence prennent la valeur "H" lorsqu’une absence partielle au sens Timesquare est rencontrée et que ses heures de début et de fin ne correspondent ni au paramétrage d’une absence matin ni à celui d’une absence après-midi dans les spécificités de l’interface. Dans ce cas :
  • La colonne Durée de l’absence égale durée de l’absence partielle de Timesquare
  • La colonne Heure de début égale heure début de l’absence partielle de Timesquare
  • La colonne Heure de fin égale heure de fin de l’absence partielle de Timesquare

Les 3 dernières colonnes sont vides.

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. 

Exemple de contenu

HD-126;RECUP;08042021;08042021;S;S;;;;;;
HD-126;HDCP;09042021;10042021;J;J;;;;;;
HD-126;RECUP;12042021;12042021;M;M;;;;;;
HD-126;ARTT;13042021;16042021;J;J;;;;;;
HD-126;RECUP;19042021;19042021;H;H;0445;0900;1345;1;;