Générer un motif de feuille de temps (test)

Répète une semaine de départ sur une année entière, afin de valider une règle de règlement avant la mise en production — pour un collaborateur, une unité organisationnelle ou tout le monde. La tâche peut aussi approuver les périodes qu’elle génère, pour vérifier une configuration complète de bout en bout. Espaces de travail de test uniquement.

Pourquoi cette tâche existe

Un espace de travail configuré en septembre n’a qu’une seule période d’approbation : septembre. Il n’y a ni T1 ni T2, donc aucune chaîne de règlement à examiner — et les périodes ne peuvent jamais être créées rétroactivement, car chacune s’ouvre sur le solde de clôture de la précédente.

Cette tâche prend le chemin inverse. Saisissez une semaine représentative — à la date de début de l’espace de travail ou n’importe quelle semaine ultérieure — et laissez la tâche la répéter vers l’avant à partir de là. Chaque période créée est la plus récente, donc la chaîne se construit dans l’ordre où elle serait réellement apparue.

Avant de l’exécuter

1. Configurez les règles à valider — la politique de règlement, les comptes de banque de temps, les conditions d’emploi avec l’approbation des feuilles de temps activée.
2. Assurez-vous que le calendrier des jours fériés couvre les mois que vous allez générer. Les jours qu’il ne couvre pas sont générés comme des jours ouvrés ordinaires.
3. Donnez au collaborateur une cible de remplissage automatique — une activité par défaut ou une répartition en pourcentage dans sa liste d’activités. Activer le remplissage automatique dans la politique de temps de travail ne suffit pas : sans cible, la tâche s’arrête au lieu de remplir une année de jours vides.
4. En tant que ce collaborateur, saisissez votre semaine représentative via la feuille de temps habituelle. De vraies saisies sur de vraies activités. Commencez-la à la date de début de l’espace de travail — ou où vous voulez, en indiquant à la tâche où avec Date de début du motif.

Donnez du relief à la semaine. Une semaine strictement à la norme produit un écart nul à chaque période : aucun plafond ne se déclenche et rien n’est perdu — l’année générée ne prouverait rien. Enregistrez au-dessus de la norme certaines semaines et en dessous pour d’autres.

Le motif

Le motif est ce que vous avez saisi, pas quelque chose que vous configurez. La tâche lit des blocs de sept jours à partir de la date de début du motif et les répète vers l’avant. Laissez cette date vide et elle commence là où commence l’espace de travail — ou là où commence le contrat du collaborateur si c’est plus tard, car rien ne peut être saisi avant l’une ou l’autre :

Une « semaine » désigne ici sept jours à partir de la date de début, et non lundi à dimanche : cela fonctionne quel que soit le jour où commence votre espace de travail. L’alignement des jours est conservé : un mardi du motif tombe toujours un mardi.

Paramètres

Choisissez exactement un paramètre parmi Collaborateur, Unité organisationnelle et Tous les collaborateurs. Chaque collaborateur est traité séparément — avec son propre motif, ses propres conditions d’emploi et ses propres périodes. Pour une unité ou tous les collaborateurs, un collaborateur qui ne peut pas être traité (pas de conditions d’emploi avec approbation des feuilles de temps, fenêtre du motif vide…) est ignoré et listé avec la raison, et les autres sont traités ; pour un seul collaborateur, l’exécution s’arrête à la place.

Ce que la tâche fait de chaque jour

Jour après jour sur la plage générée :

1. Un jour férié n’est pas touché.
2. Un jour portant une absence ou un congé n’est pas touché — des congés planifiés au mois 7 sortent intacts de l’exécution.
3. Un jour portant déjà du temps de travail est laissé tel quel, sauf si vous avez coché Écraser.
4. Sinon le jour correspondant du motif est recopié : saisies et pointages, aux mêmes heures.
5. Un jour laissé vide par le motif reçoit sa norme attendue. Un week-end ou un jour férié a une norme de zéro, ces jours restent donc vides.

Ensuite, la tâche calcule les primes et les heures supplémentaires sur chaque jour des périodes couvertes — les jours recopiés comme ceux qui existaient déjà, par exemple des saisies apportées par un import, qui sinon ne sont calculées qu’au traitement nocturne. Enfin, pour chaque période d’approbation couverte, elle crée la période et l’amène à prête.

La soumission et l’approbation restent les vôtres, sauf si vous activez Approuver automatiquement les relevés — parcourir vous-même les périodes est souvent tout l’intérêt de l’exercice : observez le solde s’enchaîner de la clôture de chaque période à l’ouverture de la suivante. Avec l’approbation automatique, la tâche soumet et approuve chaque période dans l’ordre, de sorte que le règlement s’exécute et que la période suivante s’ouvre sur le solde réglé. Elle s’arrête à une période qui ne peut pas être soumise (une violation bloquante, ou une période antérieure encore ouverte) et indique laquelle.

Lire le résultat de l’exécution

Avec plusieurs collaborateurs, les compteurs sont des totaux pour l’ensemble.

Comparez days_skipped.holiday aux jours fériés attendus dans l’année générée. Zéro sur douze mois signifie que le calendrier des jours fériés ne va pas jusque-là.

Tester une configuration complète

Pour vérifier qu’une configuration calcule les bons chiffres, apportez des collaborateurs de test avec une période complète de saisies — par un import ou en les saisissant — et exécutez la tâche avec :

• Tous les collaborateurs (ou l’unité que vous testez),
• Date de début du motif sur le premier jour de la période, et Semaines du motif couvrant l’essentiel de celle-ci,
• Mois à 0, pour que rien ne soit répété au-delà des saisies que vous avez apportées,
• Approuver automatiquement les relevés activé.

La tâche calcule les primes, approuve les périodes et exécute le règlement : les relevés affichent alors les soldes définitifs, prêts à être comparés à ce que disent les règles. L’équipe d’implémentation l’exécute depuis un script avec la clé API de l’espace de travail.

Réexécuter la tâche

Une deuxième exécution avec les mêmes paramètres ne change rien : les jours portant déjà des données sont ignorés, et les périodes existantes ne sont pas recréées. Pour remodeler l’année, modifiez la semaine du motif et relancez avec Écraser activé.

Dépannage