Fichier : Import spécifique des durées hebdomadaires annualisées (DHA)

Objet de l'interface

L’interface permet d’importer la durée hebdomadaire annualisée prévisionnelle calculée à partir d'un système tiers vers 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.

Cette durée hebdomadaire peut ensuite être visualisée dans les résultats d'annualisation et utilisée dans le cadre d'un calcul de planification. Pour le bon fonctionnement de l’import, il faut qu’une ou plusieurs listes de calcul d’annualisation aient été créées au préalable. En effet, la présence d'une liste d'annualisation dont l'année de la date de début correspond à l'année de la période de calcul d'annualisation présente dans le fichier d'import garantit la présence des informations nécessaires à l'insertion des valeurs hebdomadaires.

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

Nom du fichier

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

Exemple 1 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux DHA.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux dha_Timesquare.001

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

Le fichier peut comporter une ligne d'en-tête.

#	Champ	Type	Remarque
01	Année de la période du calcul d'annualisation	Numérique	Sur 4 caractères AAAA
02	Champ technique	Alphanumérique	Ignoré lors de l'import, peut être vide
03	Identifiant personne	Alphanumérique	Matricule, matricule paie ou identifiant Timesquare
04	Valeur DHA 1er intervalle	Numérique	Positive, zéro ou vide
05	Valeur DHA 2ème intervalle	Numérique	Positive, zéro ou vide
...
54	Valeur DHA 51ème intervalle	Numérique	Positive, zéro ou vide
55	Valeur DHA 52ème intervalle	Numérique	Positive, zéro ou vide
56	Valeur DHA 53ème intervalle	Numérique	Positive, zéro ou vide

Règles de gestion

• L’année lue (colonne #01 du fichier) est l’année de la date du premier jour de la période du calcul d’annualisation.
  Exemple : une partie des effectifs a une période d’annualisation qui s’étend du 01/01 au 31/12 de la même année. Dans ce cas, l’année lue sera celle de toutes les dates de la période d’annualisation. Une autre partie des effectifs a une période d’annualisation qui s’étend du 01/06/AA au 31/05/AA+1. Dans ce dernier cas, l’année lue sera celle des dates de la moitié de la période d’annualisation.
• Les colonnes #04 à #56 sont lues et permettent l’insertion d’autant de valeurs de DHA que de
  valeurs rencontrées positives ou égale à zéro. Une colonne vide ne conduit pas à l’insertion d’une valeur de DHA dans la base de données.
• La colonne #04 du fichier permet d’alimenter la semaine 1 de la période d’annualisation, la colonne #05 permet d’alimenter la semaine 2 de la période d’annualisation, …, la colonne #N permet d’alimenter la semaine N-3 de la période d’annualisation pour N pouvant aller jusqu’à 56.
  Note : La première semaine de l’année ne correspond pas forcément à la semaine 1 de la période d’annualisation. Exemple : En 2027, la première semaine de l’année est la semaine du 04/01/2027 au 10/01/2027. Alors que la semaine 1 de la période d’annualisation est la semaine partielle du 01/01/2027 au 03/01/2027.
• Une période d'annualisation peut démarrer n'importe quel jour de l'année. Exemple : dans le cas d'une annualisation de mai 2024 à fin avril 2025, la première semaine est S14 de 2024. 
• Pour rappel : Un calcul d’annualisation est configuré sur une période allant de JJ/MM/AA à JJ’/MM’/AA’ pour laquelle le moteur d’annualisation va déterminer les valeurs de durées hebdomadaires de chacune des semaines qui constituent cette période. Toutefois, la première et la dernière semaine de la période peuvent être particulières dans la mesure où elles peuvent être partielles si JJ/MM/AA ne correspond pas au premier jour d’une semaine ou si JJ’/MM’/AA’ ne correspond pas au dernier jour d’une semaine. Il faut donc traiter ces deux semaines avec des règles particulières pour alimenter les début et fin de période.
• Exemple : le premier jour de la semaine est le lundi et le dernier jour de la semaine est le dimanche.
  
  • Début de la période correspondant à la DHA à insérer
    • La date de début associée à la 1ère valeur est égale à la date de début de la liste de calcul
      d’annualisation à savoir JJ/MM/AA que ce soit un lundi ou non.
    • La date de début associée à la 2ème valeur est égale à la date du lundi qui est égal ou qui
      précède JJ/MM/AA à laquelle on ajoute 7.
    • La date de début associée à la Ne valeur est égale à la date du lundi qui est égal ou qui
      précède JJ/MM/AA à laquelle on ajoute 7x(N-1).
  • Fin de la période correspondant à la DHA à insérer
    • La date de fin associée à la 1ère valeur est égale à la date du 1er dimanche qui suit la
      JJ/MM/AA.
    • La date de fin associée à la 2ème valeur est égale à la date du 2ème dimanche qui suit JJ/MM/AA et qui précède JJ’/MM’/AA’.
    • La date de fin associée à la Nème valeur est égale à la date du Ne dimanche suit JJ/MM/AA.
    • La date de fin associée à la dernière valeur est égale à JJ’/MM’/AA’ que ce soit un dimanche ou non.
• Si l’import d’un même fichier est exécuté à plusieurs reprises, les nouvelles valeurs annulent et
  remplacent les valeurs existantes.
• Si la période du calcul d’annualisation concerné est inférieure à 12 mois, on intègre uniquement
  les premières colonnes rencontrées dans le fichier d’import correspondant au nombre de semaines contenues dans le calcul d’annualisation.
• L'option Lorsque deux listes débutent la même année, alimenter celle dont la période débute en me permet d'identifier la liste d'annualisation à alimenter notamment si deux listes débutent la même année pour le même groupe de personnes. Ce cas peut se présenter lorsqu’une période d’annualisation commence en janvier de l’année N et que la suivante commence en décembre de cette même année N. Exemple :  Annualisation 2024 du 01/01/2024 au 29/12/2024 et Annualisation 2025 du 30/12/2024 au 29/12/2025. Lorsque l'option est activée, je sélectionne le mois de début de période de la liste d’annualisation à alimenter. Dans l'exemple précédent, ce serait le mois de décembre par défaut.

Exemple de contenu

TP_ANNEE;TP_SECTEUR;TP_MATRICULE;TP_01;TP_02;TP_03;TP_04;TP_05;TP_06;TP_07;TP_08;TP_09;TP_10;TP_11;TP_12;TP_13;TP_14;TP_15;TP_16;TP_17;TP_18;TP_19;TP_20;TP_21;TP_22;TP_23;TP_24;TP_25;TP_26;TP_27;TP_28;TP_29;TP_30;TP_31;TP_32;TP_33;TP_34;TP_35;TP_36;TP_37;TP_38;TP_39;TP_40;TP_41;TP_42;TP_43;TP_44;TP_45;TP_46;TP_47;TP_48;TP_49;TP_50;TP_51;TP_52;TP_53
2025;;BRZ25;3400;3300;3400;3300;3500;3400;3300;3000;3700;3800;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500;3500