Objet de l'interface
L’interface permet d’importer les valeurs d'un compteur (tel que le nombre de CP acquis, les jours de nuit ou encore les heures complémentaires) ou bien d'alimenter la valeur initiale d'un compteur pour un cycle en particulier.
Pour rappel, la valeur initiale permet d’ajouter une valeur au compteur en début du cycle sélectionné. Elle permet de reporter des valeurs d'un cycle sur le suivant. La valeur initiale peut être négative. Si j'importe une valeur initiale pour un compteur hebdomadaire en semaine X, le champ Report du compteur s'alimente avec cette valeur initiale sur la semaine X. Il faut alors lancer un calcul de compteur pour actualiser sa valeur sur ce cycle (report + valeur actuelle).
Cette interface est particulièrement recommandée au moment de l'implémentation du module Gestion des Temps d'une base afin d'alimenter les compteurs avec des valeurs au moment de l'initialisation. En phase de production, il peut servir à corriger des valeurs de compteurs erronées en fin de cycle.
Important : en cas d'import d'une valeur de compteur sur un cycle, ce compteur n'est plus recalculé pour le cycle en question, quel que soit le paramétrage défini. Il faudra attendre le cycle suivant pour que le compteur soit à nouveau re-calculé par Timesquare.
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.
En savoir plus sur le paramétrage de cet import.
Nom du fichier
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. Il peut contenir des informations relatives à un ou plusieurs compteurs concernant une ou plusieurs personnes.
Exemples : Compteurs_A.txt, Compteurs_Timesquare.001, Compteurs.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
| Ordre | Nom du champ | Type | Remarques |
|---|---|---|---|
| 01 | Code du compteur | Alphanumérique | Sans espace ni caractère spécial. Ce code est associé à un compteur de paie dans le paramétrage de l'import. |
| 02 | Matricule personne concernée | Alphanumérique | Sans espace ni caractère spécial |
| 03 | Date de dernière mise à jour | Date | JJ/MM/AAAA (jour, mois, année) |
| 04 | Valeur du compteur | Numérique | XXXXXXXXYY pourra être interprété comme un nombre d’heures ou un réel * |
Règles de gestion
* La valeur du compteur XXXXXXXXYY est, selon le cas, interprétée comme :
- Une valeur réelle : dans ce cas, YY sont les deux décimales représentatives du compteur concerné. 526,98 apparaît dans le fichier de la façon suivante 52698.
- Un nombre d’heures : dans ce cas, YY représente les minutes et XXXXXXXX les heures. 122h38 apparaît dans le fichier de la façon suivante 12238.
La date de dernière mise à jour permet de déterminer à quel cycle la valeur doit être associée. Il ne peut y avoir qu’une valeur par cycle annuel. Chaque import pour un cycle écrase la valeur précédemment importée.
Si le cycle n'existe pas, il est créé au moment de l'import.
Exemple 1 : le 11/10/2021, j’exécute l’import du compteur CP acquis. La ligne importée est la suivante :
CPacq;MPA100;10/10/2021;625
Le compteur CPacq correspond au compteur CP acquis, qui est sur le cycle Année comptable. Lors de l’import, la date du 10/10/2021 permet de vérifier si le cycle de l’année comptable 2020-2021 existe. S’il existe, la valeur du compteur CPacq pour le cycle 2021-2021 pour la personne dont l'identifiant est MPA100 sera 6,25 en date du 10/10/2021.
Exemple 2 : le 12/11/2021, j’exécute l’import du compteur CP acquis. La ligne importée est la suivante :
CPacq;MPA100;10/11/2021;833
Le compteur CPacq correspond au compteur CP acquis, qui est sur le cycle Année comptable. Lors de l’import, la date du 10/11/2021 permet de vérifier si le cycle de l’année comptable 2020-2021 existe. S’il existe, la valeur du compteur CPacq pour le cycle 2021-2021 pour la personne dont l'identifiant est MPA100 sera 8,33 en date du 10/11/2021. La valeur du mois d’octobre de l'exemple 1 est écrasée par la valeur du mois de novembre de l'exemple 2.
Exemple de contenu
CPAcq(ACV);BRZ01;01/01/2026;2500
CPAcq(ACV);BRZ04;01/01/2026;2500
CPAcq(ACV);BRZ05;01/01/2026;2500
CPAcq(ACV);BRZ08;01/01/2026;2500
CPAcq(ACV);BRZ12;01/01/2026;2500
CPAcq(ACV);BRZ13;01/01/2026;2500
CPAcq(ACV);BRZ14;01/01/2026;2500
CPAcq(ACV);BRZ17;01/01/2026;2500
CPAcq(ACV);BRZ18;01/01/2026;2500
CPAcq(ACV);BRZ30;01/01/2026;2500
CPAcq(ACV);BRZ31;01/01/2026;2500
CPAcq(ACV);BRZ02;01/01/2026;2500
CPAcq(ACV);BRZ03;01/01/2026;2500
CPAcq(ACV);BRZ06;01/01/2026;2500
CPAcq(ACV);BRZ07;01/01/2026;2500
CPAcq(ACV);BRZ10;01/01/2026;2500
CPAcq(ACV);BRZ11;01/01/2026;2500
CPAcq(ACV);BRZ15;01/01/2026;2500
CPAcq(ACV);BRZ19;01/01/2026;2500
CPAcq(ACV);BRZ22;01/01/2026;2500
CPAcq(ACV);BRZ23;01/01/2026;2500
CPAcq(ACV);BRZ25;01/01/2026;2500
CPAcq(ACV);BRZ26;01/01/2026;2500
CPAcq(ACV);BRZ27;01/01/2026;2500
CPAcq(ACV);BRZ28;01/01/2026;2500
CPAcq(ACV);BRZ29;01/01/2026;2500
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.