Fichier : Export standard du planning

View the English version

Objet de l'interface

L’interface permet d’extraire les plannings prévisionnels et réalisés (plages horaires, repos, absences, convocations et temps spécifiques) construits avec 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 logicielle 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

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 de plannings.

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, plg-ini.csv

Fichiers multiples (un fichier par mois)

Le nom du fichier doit suivre une syntaxe particulière incluant le mois des données proposées. La dénomination retenue est TexteMMAAAA.EXT où Texte est une chaîne de caractères alphanumériques qui sera fixe, MM correspond au mois, AAAA correspond à l’année 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 mois exporté.

Exemples : site1_022021.txt, réalisé022021.001, 022021.csv.

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. La dénomination retenue est TexteJJMM.EXT où Texte est une chaîne de caractères alphanumériques qui sera fixe, JJ correspond au jour, MM correspond au mois 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_1302.txt, réalisé1302.001, 1302.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

• Première ligne : La première ligne est une ligne d’en tête, elle contient la description des informations pour les lignes suivantes.
  Semaine;Date;Nom;Prénom;Matricule;Structure;Code;Type;Début;Fin;Durée;H/D;P/F;Dépl.;Libellé;Etat;Durée hebdo;Code externe 01;Code externe 02;Fuseau horaire;Code structure
  Code externe 01 et Code externe 02 sont des champs dont le libellé peut être personnalisé dans la Configuration
• Lignes suivantes : Les lignes suivantes du fichier ont une longueur variable.

Ordre	Informations	Type	Remarques	Présence
01	Numéro de semaine	Numérique		Obligatoire
02	Date	Date	Date du planning au format JJ/MM/AAAA	Obligatoire
03	Nom	Alphanumérique	Champ Nom de la fiche administrative.	Obligatoire
04	Prénom	Alphanumérique	Champ Prénom de la fiche administrative.	Obligatoire
05	Matricule / Matricule paie / Identifiant	Alphanumérique	Champs Matricule, Matricule Paie ou Identifiant de la fiche administrative en fonction du paramétrage défini au moment de l’export.	Obligatoire
06	Structure	Alphanumérique	Libellé de la structure d’appartenance.	Obligatoire
07	Code de l'activité	Alphanumérique	Code tâche, code absence, code convocation ou vide si pause.	Obligatoire
08	Type de l’activité	Alphanumérique	A : Absence, T : Travail sur place, TT : Télétravail, P : Pause, R : Repos, C : Convocation, I : Indisponibilité, H : Hors contrat, Férié fermé, Fermé	Obligatoire
09	Heure de début d’activité	HH:NN	HH:NN (heures et minutes). Heure de changement de jour du calendrier si jour de repos ou absence complète	Obligatoire
10	Heure de fin d’activité	HH:NN	HH:NN (heures et minutes). Heure de changement de jour du calendrier + 24h si jour de repos ou absence complète	Obligatoire
11	Durée d’activité	HH:NN	HH:NN (heures et minutes). 00:00 si jour de repos	Obligatoire
12	Habillage / Déshabillage	HH:NN	Temps spécifique, vide si non utilisé	Obligatoire
13	Préparation / Finalisation	HH:NN	Temps spécifique, vide si non utilisé	Obligatoire
14	Déplacement	HH:NN	Temps spécifique, vide si non utilisé	Obligatoire
15	Libellé de l'activité	Alphanumérique	Libellé tâche, absence ou convocation.	Obligatoire
16	Etat du planning	Caractère	F pour calculé, E pour étendu, V pour validé, sinon vide	Obligatoire
17	Durée hebdomadaire	HH:NN	Apparaît lorsque l’absence est valorisée à la semaine dans Timesquare	Obligatoire
18	Code externe 01	Alphanumérique	Code externe 01 lié à la tâche. Apparaît si l’option est cochée	Facultatif
19	Code externe 02	Alphanumérique	Code externe 02 lié à la tâche. Apparaît si l’option est cochée	Facultatif
20	Fuseau horaire	Alphanumérique	Apparaît si l’option est cochée. Exemple : (UTC+1) Bruxelles, Copenhague, Madrid, Paris	Facultatif
21	Code structure	Alphanumérique	Apparaît si l’option est cochée	Facultatif
22	Code externe d'affectation de contrat	Alphanumérique	Apparaît si l’option est cochée	Facultatif
23	Heure de début de plage	Alphanumérique	Apparaît si l’option est cochée. Affiche l'heure de début de la plage sur laquelle se trouve l'élément de planning (uniquement pour les tâches et les pauses)	Facultatif
24	Heure de fin de plage	Alphanumérique	Apparaît si l’option est cochée. Affiche l'heure de fin de la plage sur laquelle se trouve l'élément de planning (uniquement pour les tâches et les pauses)	Facultatif
25	Indicateur de modification	Alphanumérique	Apparaît si l’option est cochée. Cette option correspond à la case Informer le salarié liée à l'utilisation de Chronotime Workplace. Cette option est disponible uniquement si la carte Chronotime Workplace de la Marketplace est active. La colonne est renseignée avec les valeurs suivantes : Vide si nulle en base 0 si 0 en base 1 si 1 en base	Facultatif
26	Commentaire	Alphanumérique	Apparaît si l’option est cochée.	Facultatif

Règles de gestion

Pour l'heure de fin de l'activité, les heures après minuit sont indiquées avec des valeurs supérieures à 24h (exemple 25:50 pour 01:50 le lendemain) pour interpréter correctement la date du jour.

Si plusieurs tâches sont présentes dans une même plage de travail, les heures de début et de fin de plage apparaissent à l’identique sur chaque ligne générée pour chacune des tâches concernées.

Une convocation, une absence complète ou partielle, une indisponibilité, un repos, qu’ils soit inclus ou non dans une plage de travail ne génèrent pas d’heures de début et de fin de plage. Les colonnes Heure de début et Heure de fin de plage sont vides.

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. 

Exemple de contenu

Sans activation des heures de début et de fin de plage

Semaine;Date;Nom;Prénom;Matricule;Structure;Code;Type;Début;Fin;Durée;H/D;P
/F;Dépl.;Libellé;Etat;Durée Hebdo;
8;20/02/2021;FOLLETT;Ken;0001;01 Paris;AS;T;09:45;10:00;00:15;00:00;00:00;00:00;V;
8;20/02/2021;FOLLETT;Ken;0001;01 Paris;REU;C;10:00;10:30;00:30;;;;Réunion;V;
8;20/02/2021;FOLLETT;Ken;0001;01 Paris;AS;T;10:30;13:15;02:45;00:00;00:00;00:00;Appels Sortants;V;
8;21/02/2021;FOLLETT;Ken;0001;01 Paris;MAIL;T;06:00;08:45;02:45;00:00;00:00;00:00;Email;V;

Avec activation des heures de début et de fin de plage

8;19/02/2024;ORB;Olivier;ORB;Equipe TT;ORBAEA;T;12:45;15:45;03:00;00:00;00:00;00:00;Appels Entrants A;F;;12:45;15:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;ORBAEB;T;17:45;21:45;04:00;00:00;00:00;00:00;Appels Entrants B;F;;17:45;21:45
8;20/02/2024;ORB;Olivier;ORB;Equipe TT;ORBAEB;T;17:30;19:00;01:30;00:00;00:00;00:00;Appels Entrants B;F;;17:30;22:00
8;20/02/2024;ORB;Olivier;ORB;Equipe TT;ORBAEC;T;19:00;20:15;01:15;00:00;00:00;00:00;Appels Entrants C;F;;17:30;22:00
8;20/02/2024;ORB;Olivier;ORB;Equipe TT;ORBAEB;T;20:15;22:00;01:45;00:00;00:00;00:00;Appels Entrants B;F;;17:30;22:00
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;13:30;13:39;00:09;;;;;F;;12:45;15:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;13:58;14:03;00:05;;;;;F;;12:45;15:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;14:34;14:39;00:05;;;;;F;;12:45;15:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;15:09;15:14;00:05;;;;;F;;12:45;15:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;18:28;18:33;00:05;;;;;F;;17:45;21:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;19:00;19:12;00:12;;;;;F;;17:45;21:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;19:27;19:32;00:05;;;;;F;;17:45;21:45
8;19/02/2024;ORB;Olivier;ORB;Equipe TT;;P;20:54;20:59;00:05;;;;;F;;17:45;21:45
8;20/02/2024;ORB;Olivier;ORB;Equipe TT;ORBC01;C;12:00;13:00;01:00;;;;ORB C01;F;;;;
8;23/02/2024;ORB;Olivier;ORB;Equipe TT;ORBC03;C;10:00;13:00;01:00;;;;ORB C03;F;;;;
8;25/02/2024;ORB;Olivier;ORB;Equipe TT;I;I;18:00;21:00;03:00;;;;Indisponibilité;F;;;;
8;23/02/2024;ORB;Olivier;ORB;Equipe TT;ORBRCT;A;17:00;19:00;02:00;;;;05 Récupération;F;;;;
8;22/02/2024;ORB;Olivier;ORB;Equipe TT;ORBCP;A;01:00;25:00;07:00;;;;01 CP;F;;;;
8;21/02/2024;ORB;Olivier;ORB;Equipe TT;Repos;R;01:00;25:00;00:00;;;;Repos;F;;;;