Fichier : Export des plannings PeopleNet

Objet de l'interface

L’interface permet d’extraire les plannings prévisionnels et réalisés 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 PeopleNet de Cegid. 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 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.

Elle peut également être Texte1AAAAMMJJ.EXT ou bien Texte1AAAAMMJJTexte2hhmmss.EXT où Texte1 et Texte2 sont des chaînes de caractères alphanumériques qui seront fixes, JJ correspond au jour, MM correspond au mois, AAAA correspond à l’année, hh correspond à l'heure, mm correspond aux minutes, ss correspond aux secondes 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, planning20250325.csv, planning20250325_123423.csv.

Format

Texte. Encodage ANSI.

Séparateur entre deux informations

Le séparateur entre deux informations est le point-virgule (;).

Description des lignes du fichier

Ordre	Donnée	Type	Remarques
01	Organisation	Alphanumérique	Constante paramétrable
02	Matricule PeopleNet	Alphanumérique	Matricule, matricule paie, etc. (paramétrable)
03	Date du jour	Date	JJ/MM/AAAA
04	Code cycle de travail	N/A	Vide
05	Code semaine	N/A	Vide
06	Code calendrier	N/A	Vide
07	Type de jour	Alphanumérique	Code modèle horaire quotidien ou constante paramétrable selon le type de contrat et la nature de la journée rencontrée

Règles de gestion

Règles de gestion pour alimenter le type de jour

Lorsqu'un modèle horaire est présent dans le planning, il peut être issu d'une programmation de modèles, de la bibliothèque de modèles horaires ou encore d'une affectation manuelle depuis les plannings. Dans tous ces cas, il est possible de récupérer le code du modèle horaire.

En fonction du paramétrage, j'exporte pour chaque journée le code du modèle horaire quotidien correspondant à la journée ou bien pour chaque jour le code de modèle horaire hebdomadaire utilisé.

En revanche, le lien peut être rompu entre le planning et le modèle horaire si le planning est modifié manuellement, par import ou par Web Service. Dans ce cas, selon le contenu de la journée, la ligne s'alimente comme suit :

• Repos : La colonne #7 s'alimente avec le code spécifique défini pour un repos dans la configuration selon que le contrat de la personne concernée est un forfait jours ou non. 
• Absences complètes : Les absences complètes ne sont pas concernées par l’export, rien n’est envoyé vers PeopleNet.
• Absences partielles sans autre élément de planning : Les absences partielles ne sont pas concernées par l’export, rien n’est envoyé vers PeopleNet.
• Absences partielles avec au moins une tâche : Les absences partielles ne sont pas concernées par l’export, rien n’est envoyé vers PeopleNet même si une plage de travail est également présente.
• Jour fermé : La colonne #7 s'alimente avec le code spécifique défini pour un jour fermé dans la configuration selon que le contrat de la personne concernée est un forfait jours ou non.
• Jour férié fermé : La colonne #7 s'alimente avec le code spécifique défini pour un jour férié fermé dans la configuration selon que le contrat de la personne concernée est un forfait jours ou non.
• Une ou plusieurs plages de travail (forfait jours) : La colonne #7 s'alimente avec le code spécifique défini pour un jour travaillé ou un jour férié travaillé dans la configuration selon de type de jour rencontré dans le calendrier. Remarque : le code utilisé pour les jours travaillés et le code utilisé pour les jours fériés travaillés sont différents et doivent être renseignés comme tels dans la configuration de l’interface.  
• Une ou plusieurs plages de travail (autres contrats) :
  • Si un lien existe avec un modèle horaire, la colonne #7 s'alimente avec le code du modèle horaire.
  • Si aucun lien n’existe avec un modèle horaire, on parcourt les modèles horaires existants et on récupère le code du modèle correspondant (s’il en existe un). Le contrôle de la correspondance se faire uniquement sur les heures de début et fin de plage. Les tâches ne sont pas prises en compte. La recherche se fait parmi les modèles horaires disponibles, à savoir ceux directement
    liés à la personne en cours de traitement et ceux hérités des niveaux de structure supérieurs. Dès lors qu’une correspondance est trouvée entre le planning de la personne et un modèle horaire existant, la recherche est interrompue et la colonne #7 s'alimente avec le code du modèle horaire identifié. Si aucune correspondance n’est trouvée parmi les modèles horaires existants, la colonne #7 s'alimente avec le code défini lorsqu’aucun modèle horaire n’est rencontré dans la configuration. 

Lorsque l’on rencontre un planning pour une personne dont le champ utilisé comme clé de liaison est vide, ce planning est ignoré et ne génère pas de ligne dans le fichier d’export. Par conséquent, la colonne #02 du fichier de résultat ne peut pas être vide.

Exemple de contenu

LV;MAT001;24/12/2024;;;;STKMID1
LV;MAT002;24/12/2024;;;;VMOUV
LV;MAT003;24/12/2024;;;;JTFJ
LV;MAT001;25/12/2024;;;;JFNT
LV;MAT002;25/12/2024;;;;JFNT
LV;MAT003;25/12/2024;;;;JFNTFJ
LV;MAT001;26/12/2024;;;;REPOS
LV;MAT002;26/12/2024;;;;REPOS
LV;MAT003;26/12/2024;;;;REPOSFJ
LV ;MAT004 ;26/12/2024;;;;35/7MID1