Fichier : Import standard de paramètres de calcul

View the English version

Objet de l'interface

L’interface permet d’importer des paramètres de calcul depuis un logiciel tiers vers Timesquare. Ceux-ci sont regroupés dans une fiche de paramètres de calcul par personne. 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 de Timesquare.

Ces paramètres permettent de définir pour chaque personne les bornes de début et de fin de journée possibles (PJ01), le jour travaillé (PJ02), les durées quotidiennes minimum et maximum pour des jours avec ou sans coupure (PJ04).

La fiche de paramètres crée reste valable jusqu’à modification par l’import de nouveaux paramètres.

Ces éléments sont importés dans Timesquare pour créer des fiches de paramètres de calculs qui peuvent être utilisées lors du calcul des plannings.

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

Nom du fichier

Fichier unique

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

Exemples : Param_A.txt, Param_Timesquare.001, Param.csv..

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 ou LibelléAAMMJJ.EXT sont les dénominations retenues où : 

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

Exemple 2 : Le champ Libellé dans la configuration se nomme paramAAAAMMJJ.001 et les trois fichiers d'import se nomment param20220104.001, param20220105.001 et param20220106.001. 

Exemple 3 : Le champ Libellé dans la configuration se nomme AAMMJJ.txt et les trois fichiers d'import se nomment 040122.txt, 050122.txt et 060122.txt.

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

	Champ	Type	Remarque
01	Identifiant personne concernée	Alphanumérique	Matricule, Matricule paie ou identifiant de Timesquare selon la configuration
02	Début de période d’application	Date	JJ/MM/AAAA
03	Fin de période d’application	Date	JJ/MM/AAAA
04	Jour travaillé 01	Numérique	Vide pour non renseigné 0 pour autorisé  1 pour interdit 2 pour obligatoire
05	Jour travaillé 02	Numérique	Idem #04
06	Jour travaillé 03	Numérique	Idem #04
07	Jour travaillé 04	Numérique	Idem #04
08	Jour travaillé 05	Numérique	Idem #04
09	Jour travaillé 06	Numérique	Idem #04
10	Jour travaillé 07	Numérique	Idem #04
11	Jour férié travaillé	Numérique	Idem #04
12	Heure de début jour 01	Heure	HH:NN
13	Heure de fin jour 01	Heure	HH:NN
14	Heure de début jour 02	Heure	HH:NN
15	Heure de fin jour 02	Heure	HH:NN
16	Heure de début jour 03	Heure	HH:NN
17	Heure de fin jour 03	Heure	HH:NN
18	Heure de début jour 04	Heure	HH:NN
19	Heure de fin jour 04	Heure	HH:NN
20	Heure de début jour 05	Heure	HH:NN
21	Heure de fin jour 05	Heure	HH:NN
22	Heure de début jour 06	Heure	HH:NN
23	Heure de fin jour 06	Heure	HH:NN
24	Heure de début jour 07	Heure	HH:NN
25	Heure de fin jour 07	Heure	HH:NN
26	Heure de début jour férié	Heure	HH:NN
27	Heure de fin jour férié	Heure	HH:NN
28	Durée quotidienne minimum jour 01 (Sans Coupure)	Durée	HH:NN
29	Durée quotidienne maximum jour 01 (Sans Coupure)	Durée	HH:NN
30	Durée quotidienne minimum jour 02 (Sans Coupure)	Durée	HH:NN
31	Durée quotidienne maximum jour 02 (Sans Coupure)	Durée	HH:NN
32	Durée quotidienne minimum jour 03 (Sans Coupure)	Durée	HH:NN
33	Durée quotidienne maximum jour 03 (Sans Coupure)	Durée	HH:NN
34	Durée quotidienne minimum jour 04 (Sans Coupure)	Durée	HH:NN
35	Durée quotidienne maximum jour 04 (Sans Coupure)	Durée	HH:NN
36	Durée quotidienne minimum jour 05 (Sans Coupure)	Durée	HH:NN
37	Durée quotidienne maximum jour 05 (Sans Coupure)	Durée	HH:NN
38	Durée quotidienne minimum jour 06 (Sans Coupure)	Durée	HH:NN
39	Durée quotidienne maximum jour 06 (Sans Coupure)	Durée	HH:NN
40	Durée quotidienne minimum jour 07 (Sans Coupure)	Durée	HH:NN
41	Durée quotidienne maximum jour 07 (Sans Coupure)	Durée	HH:NN
42	Durée quotidienne minimum jour JF (Sans Coupure)	Durée	HH:NN
43	Durée quotidienne maximum jour JF (Sans Coupure)	Durée	HH:NN
44	Durée quotidienne minimum jour 01 (Avec Coupure)	Durée	HH:NN
45	Durée quotidienne maximum jour 01 (Avec Coupure)	Durée	HH:NN
46	Durée quotidienne minimum jour 02 (Avec Coupure)	Durée	HH:NN
47	Durée quotidienne maximum jour 02 (Avec Coupure)	Durée	HH:NN
48	Durée quotidienne minimum jour 03 (Avec Coupure)	Durée	HH:NN
49	Durée quotidienne maximum jour 03 (Avec Coupure)	Durée	HH:NN
50	Durée quotidienne minimum jour 04 (Avec Coupure)	Durée	HH:NN
51	Durée quotidienne maximum jour 04 (Avec Coupure)	Durée	HH:NN
52	Durée quotidienne minimum jour 05 (Avec Coupure)	Durée	HH:NN
53	Durée quotidienne maximum jour 05 (Avec Coupure)	Durée	HH:NN
54	Durée quotidienne minimum jour 06 (Avec Coupure)	Durée	HH:NN
55	Durée quotidienne maximum jour 06 (Avec Coupure)	Durée	HH:NN
56	Durée quotidienne minimum jour 07 (Avec Coupure)	Durée	HH:NN
57	Durée quotidienne maximum jour 07 (Avec Coupure)	Durée	HH:NN
58	Durée quotidienne minimum jour JF (Avec Coupure)	Durée	HH:NN
59	Durée quotidienne maximum jour JF (Avec Coupure)	Durée	HH:NN

Détail du fichier

Lorsque l’import est exécuté, chaque ligne du fichier est lue et une fiche de paramètres de calcul est créée pour chaque ligne traitée si la condition suivante est remplie :

Le matricule ou matricule paie ou identifiant (colonne #01 du fichier) lu existe dans Timesquare.

Lors de la création de la fiche suite à l’import, on récupère les éléments suivants :

• Intitulé de la fiche : C’est le résultat de la concaténation du préfixe défini dans la configuration de l’interface et du nom de la personne concernée.
• Période d’application : On utilise les dates présentes dans les colonnes #02 et #03 pour alimenter la période d’application de la fiche de paramètres de calcul.
• Etat : « Actif » après la création sauf exception décrite plus bas.
• Périodicité : Les valeurs sont 1 et quotidienne.
• Durée : Toujours : 1.
• Evénement : Pas de filtre donc « Tous ».
• Contrat : Pas de filtre donc « Tous les contrats ».
• Groupes : Pas de filtre donc « Tous les groupes ».
• Description : Le champ est renseigné avec la chaine de caractères « Créée par un import standard ».
• Groupe PJ02 (Jour travaillé) : Les champs sont renseignés avec les valeurs des colonnes #04 à #11.
• Groupe PJ01 (Heure de début et fin de journée) : Les champs sont renseignés avec les valeurs des colonnes #12 à #27
• Groupe PJ04 (Durée quotidienne minimum et maximum avec ou sans coupure) : Les champs sont renseignés avec les valeurs des colonnes #28 à #59
• Différencier une fiche de paramètres importée :
  • Lors de la création d’une fiche d’import, cette fiche sera tagguée comme « importée » dans la base de données. Cela permettra de la différencier des fiches de paramètres renseignées manuellement et ainsi de les soumettre à un droit spécifique.
  • Une fiche de paramètres importée peut ne pas être modifiable en fonction des droits associés à l’utilisateur. Si l’utilisateur ne dispose pas du droit « Modifier une fiche de paramètres importée par personne » mais qu’il dispose du droit « Modifier une fiche de paramètres par personne », il ne pourra pas modifier les fiches importées.
  • Une fiche de paramètres importée est traitée par la compilation de la même manière que les autres fiches de paramètres de calcul.
  • Une fiche de paramètres importée peut être copiée / collée au même titre que les autres.
• Import d’une fiche de paramètres alors qu’une fiche importée existe déjà. Une personne a déjà une fiche de paramètres renseignée liée à un premier import. Dans ce cas, lors du deuxième import, le système détecte la présente d’une fiche de paramètres tagguée comme « importée » dans la base de données. Trois cas peuvent se présenter :
  • Les dates de début et de fin de la fiche existante et de la fiche importée sont identiques. La fiche déjà présente est rendue « Inactive ».
  • Les périodes d’application de la fiche existante et de la fiche importée ont une partie commune. Une nouvelle fiche est créée.
  • Les périodes d’application de la fiche existante et de la fiche importée ne se recoupent pas. Une nouvelle fiche est créée.

Remarque : ces règles de gestions ne s’appliquent qu’aux fiches « importées », les fiches créées depuis l’IHM ou issues d’une demande d’aménagement de plannings ne sont pas concernées.

Exemple de contenu

ID;DPA;FPA;JT1;JT2;JT3;JT4;JT5;JT6;JT7;JFT;HDJ01;HFJ01;HDJ02;HFJ02;HDJ03;HFJ03;HDJ04;HFJ0;HDJ0;HFJ04;HDJ05;HFJ05;HDJ06;HFJ06;HDJ07;HFJ07;HDJF;HFJF;DQMin01SC;DQMax01SC;DQMin02SC;DQMax02SC;DQMin03SC;DQMax03SC;DQMin04SC;DQMax04SC;DQMin05SC;DQMax05SC;DQMin06SC;DQMax06SC;DQMin07SC;DQMax07SC;DQMinJFSC;DQMaxJFSC;DQMin01AC;DQMax01AC;DQMin02AC;DQMax02AC;DQMin03AC;DQMax03AC;DQMin04AC;DQMax04AC;DQMin05AC;DQMax05AC;DQMin06AC;DQMax06AC;DQMin07AC;DQMax07AC;DQMinJFAC;DQMaxJFAC

ORB01;08/01/2024;31/08/2024;0;0;1;;;2;1;1;10:00;15:00;;;;;;;;;;;;;;;;;;;;;;;06:00;08:00;;;;;;;;;;;;;;;06:00;08:00;;;;