Fichier : Export spécifique des plannings Oracle

Objet de l'interface

L’interface permet d’extraire les plannings prévisionnels et réalisés (plages horaires, repos, absences, convocations et temps spécifiques) 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 Oracle. 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 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

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations est la virgule (,).

Description des lignes du fichier

• Première ligne : La première ligne est une ligne d’en tête, elle contient les informations suivantes :
  Accounts,M08,Point-of-View,Data Load Cube Name
  La seconde correspond au mois concernant les données Mxx (xx varie de 01 à 12).
• Lignes suivantes : Les lignes suivantes du fichier ont une longueur variable.

Ordre	Donnée	Format	Remarques
01	Code tâche	Alphanumérique	Il peut s'agir du code ou du code externe de la tâche en fonction du paramétrage
02	Durée / nombre	Numérique	Valeur réelle comportant deux décimales maximum
03	Scénario	Alphanumérique	Constante = Reel_SAI
04	Partenaire	Alphanumérique	Constante = PAR_NA
05	Version	Alphanumérique	Constante = Finale
06	Année	Alphanumérique	FYXX pour l'année 20XX
07	Opérateur	Alphanumérique	OPE_CDI pour les ressources en CDI OPE_CDD pour les ressources en CDD OPE_INTERIM pour les ressources Intérimaires Type contrat de Timesquare
08	Code Agence	Alphanumérique	Extrait du code de structure d’affectation des personnes concernées auquel on ajoute un préfixe paramétré
09	Fréquence	Alphanumérique	Constante = MTD
10	Cube	Alphanumérique	Constante = CDG_OPS

Règles de gestion

• Un caractère " est inséré après le séparateur qui suit la colonne #02.
• Un caractère " est inséré avant le séparateur qui précède la colonne #10.
• La durée renseignée en colonne #02 s’exprime en heures et centièmes d’heure.
• Le code agence correspond (au 02/05/2024) aux 6 premiers caractères des codes structures
  d'affectation des opérateurs concernés par l’export. Il pourra être complété lors de l’export par un
  préfixe défini dans la configuration de l’interface.
• Les chaînes de caractères composées des 6 premiers caractères des codes structures de
  toutes les structures et sous-structures qui constituent une agence (dans Timesquare)
  devront être les mêmes.
• Les chaînes des caractères qui alimentent les colonnes #03, #04, #05, #09 et #10 des lignes
  à partir de la deuxième seront paramétrables dans la configuration de l’export afin de tenir compte
  d’éventuelles modifications dans le futur.
• La colonne #06 représente l’année du mois de plannings qui est exporté. Exemple : FY24 pour 2024, FY25 pour 2025.
• La colonne #07 représente le regroupement par typologie d’opérateurs.
• Le choix des structures à exporter ainsi que celui de la période permettent de déterminer la liste des
  personnes pour lesquelles il faut lire les plannings et cumuler les heures de tâches parmi celles qui ont été sélectionnées dans la configuration.
• Pour une personne donnée, on récupère les affectations de structures et de contrats pour le mois défini pour l’export.
• L’affectation de structure permet de déterminer l’agence d’appartenance (on extrait les 3 premiers
  caractères du code de la structure).
• L’affectation de contrat indique le type de contrat qui permet de déterminer le code opérateur en utilisant la table de correspondance renseignée dans la configuration de l’interface.
• Connaissant ainsi pour chaque personne son agence, et son code opérateur de regroupement, on peut alors cumuler les heures des tâches référencées dans la configuration pour le mois à exporter et compléter la colonne #02 (durée).

Si une absence, une tâche ou une convocation présente dans l'export est supprimée après la création de l'export, elle est également supprimée de l'export. Si l'absence, la tâche ou la convocation supprimée est la dernière de la configuration, elle n'est pas supprimée et un message d'erreur s'affiche au moment de l'exécution de l'export. 

Exemple de contenu

Accounts,M08,Point-of-View,Data Load Cube Name
O_Manut_Snt,0,"Reel_SAI,PAR_NA,Finale,FY23,OPE_CDI,ENT_211294,MTD",CDG_OPS