Fichier : Import standard des modèles horaires

View the English version

Objet de l'interface

L’interface permet d’importer les modèles horaires 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.

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.

Exemples : ModeleHoraire_A.txt, ModHor_Timesquare.001, ModHor.csv.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations peut être le point-virgule, la virgule, la tabulation ou la barre
verticale.

Description des lignes du fichier

#	Désignation	Type	Remarque
01	Code du modèle	Alphanumérique	12 caractères maximum
02	Libellé du modèle	Alphanumérique	38 caractères maximum
03	Code structure	Alphanumérique	Vide si personne concernée
04	Matricule personne	Alphanumérique	Vide si structure concernée
05	Actif	Numérique	0 pour Non 1 pour Oui
06	Code Calendrier	Alphanumérique
07	Type de modèle	Numérique	1 pour Quotidien 7 pour Hebdomadaire n pour Périodique de n jours  ( n >1 et n <> 7)
08	Disponible pour la Bibliothèque	Numérique	0 pour Non 1 pour Oui
09	Disponible pour les plannings	Numérique	0 pour Non 1 pour Oui
10	Numéro de jour du modèle	Numérique	1 pour quotidien 1 à 7 pour hebdomadaire 1 à n pour périodique
11	Nature plage 1	Numérique	0 pour plage fixe 1 pour plage variable Vide si pas de plage
12	Télétravail plage 1	Numérique	0 pour site fixe 1 pour site variable 2 pour télétravail fixe 3 pour télétravail variable Vide si pas de plage
13	Nature plage 2	Numérique	0 pour plage fixe 1 pour plage variable Vide si pas de plage
14	Télétravail plage 2	Numérique	0 pour site fixe 1 pour site variable 2 pour télétravail fixe 3 pour télétravail variable Vide si pas de plage
15	Nature activité 1	Alphanumérique	T pour tâche R pour Repos AC pour absence complète AP pour absence partielle
16	Heure de début activité 1	Heure	HH:NN (heures, minutes)
17	Heure de fin activité 1	Heure	HH:NN (heures, minutes)
18	Code de l’activité 1	Alphanumérique	Code de la tâche Code de l’absence Vide si repos Vide ou "N/A" pour tâche non affectée
19	Propriété activité 1	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
20	Nature activité 2	Alphanumérique	T pour tâche AP pour absence partielle
21	Heure de début activité 2	Heure	HH:NN (heures, minutes)
22	Heure de fin activité 2	Heure	HH:NN (heures, minutes)
23	Code de l’activité 2	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
24	Propriété activité 2	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
25	Nature activité 3	Alphanumérique	T pour tâche AP pour absence partielle
26	Heure de début activité 3	Heure	HH:NN (heures, minutes)
27	Heure de fin activité 3	Heure	HH:NN (heures, minutes)
28	Code de l’activité 3	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
29	Propriété activité 3	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
30	Nature activité 4	Alphanumérique	T pour tâche AP pour absence partielle
31	Heure de début activité 4	Heure	HH:NN (heures, minutes)
32	Heure de fin activité 4	Heure	HH:NN (heures, minutes)
33	Code de l’activité 4	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
34	Propriété activité 4	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
35	Nature activité 5	Alphanumérique	T pour tâche AP pour absence partielle
36	Heure de début activité 5	Heure	HH:NN (heures, minutes)
37	Heure de fin activité 5	Heure	HH:NN (heures, minutes)
38	Code de l’activité 5	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
39	Propriété activité 5	Numérique	0 pour tâche fixe 1 pour tâche variable Vide ou "N/A" pour repos ou absence
40	Nature activité 6	Alphanumérique	T pour tâche AP pour absence partielle
41	Heure de début activité 6	Heure	HH:NN (heures, minutes)
42	Heure de fin activité 6	Heure	HH:NN (heures, minutes)
43	Code de l’activité 6	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
44	Propriété activité 6	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
45	Nature activité 7	Alphanumérique	T pour tâche AP pour absence partielle
46	Heure de début activité 7	Heure	HH:NN (heures, minutes)
47	Heure de fin activité 7	Heure	HH:NN (heures, minutes)
48	Code de l’activité 7	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
49	Propriété activité 7	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
50	Nature activité 8	Alphanumérique	T pour tâche AP pour absence partielle
51	Heure de début activité 8	Heure	HH:NN (heures, minutes)
52	Heure de fin activité 8	Heure	HH:NN (heures, minutes)
53	Code de l’activité 8	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
54	Propriété activité 8	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
55	Nature activité 9	Alphanumérique	T pour tâche AP pour absence partielle
56	Heure de début activité 9	Heure	HH:NN (heures, minutes)
57	Heure de fin activité 9	Heure	HH:NN (heures, minutes)
58	Code de l’activité 9	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
59	Propriété activité 9	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
60	Nature activité 10	Alphanumérique	T pour tâche AP pour absence partielle
61	Heure de début activité 10	Heure	HH:NN (heures, minutes)
62	Heure de fin activité 10	Heure	HH:NN (heures, minutes)
63	Code de l’activité 10	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
64	Propriété activité 10	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
65	Nature activité 11	Alphanumérique	T pour tâche AP pour absence partielle
66	Heure de début activité 11	Heure	HH:NN (heures, minutes)
67	Heure de fin activité 11	Heure	HH:NN (heures, minutes)
68	Code de l’activité 11	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
69	Propriété activité 11	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
70	Nature activité 12	Alphanumérique	T pour tâche AP pour absence partielle
71	Heure de début activité 12	Heure	HH:NN (heures, minutes)
72	Heure de fin activité 12	Heure	HH:NN (heures, minutes)
73	Code de l’activité 12	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
74	Propriété activité 12	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence
75	Nature activité 13	Alphanumérique	T pour tâche AP pour absence partielle
76	Heure de début activité 13	Heure	HH:NN (heures, minutes)
77	Heure de fin activité 13	Heure	HH:NN (heures, minutes)
78	Code de l’activité 13	Alphanumérique	Code de la tâche Code de l’absence Vide ou "N/A" pour tâche non affectée
79	Propriété activité 13	Numérique	0 pour tâche fixe 1 pour tâche variable Vide pour repos ou absence

Règles de gestion

• Si le modèle horaire concerne une personne, le matricule est obligatoire et le code structure doit être vide. Si le modèle horaire concerne une structure, le code structure est obligatoire et le matricule doit être vide. 
• Le nombre maximum de tâches autorisées dans un modèle est de 13.
• Les champs 20 à 79 sont facultatifs.
• Les champs 01 à 09 sont utiles à la création du modèle et au renseignement des informations disponibles dans le panel de création du modèle. 
  Les modèles importés ne peuvent pas être des modèles à bornes variables, ils sont donc créés en base de sorte que le champ "BORNES_VARIABLES" de la table "Modele_horaire" prenne la valeur 0.
• Le champ 10 permet d’indiquer le numéro du jour modèle concerné par les champs 11 à 79. 
  Remarque : Il doit prendre la valeur 1 pour un modèle quotidien, 7 pour un modèle hebdomadaire ou n avec n>1 et différent de 7 pour un modèle périodique.
• Lors de la création d’un modèle hebdomadaire ou périodique, il y a autant de lignes que de jours modèles non vides pour le modèle et pour chacune de ces lignes, les champs 01 à 09 sont renseignés de manière identique.
• Lors de la création d'un modèle, le champ 03 ou 04 doit être renseigné. 
• Lors d’une modification, seul le code du modèle #01 et les champs à modifier sont obligatoires parmi les champs 01 à 09. Dans ce cas, les champs 03 ou 04 doivent être vides.
• Les champs 11 à 15 permettent de définir les caractéristiques fixe ou télétravaillée des plages du jour modèle concerné.
• Les tâches sont toute considérées comme fixes.
• Les champs 16 à 79 comportent les informations à insérer en tant que :
  • Jour de repos
  • Jour d’absence
  • Absence partielle
  • Tâche
• Attention aux codes tâches, absences ou calendrier, il faut s’assurer qu’ils sont tous disponibles au niveau de création du modèle horaire.
  • Calendrier non disponible : le modèle ne peut pas être créé
  • Code tâche non disponible : tâche non affectée
  • Code absence non disponible : le jour modèle planning ne peut pas être créé, la ligne est rejetée
• L’import annule et remplace le jour modèle planning existant. 
  Les plages de travail, d’absences partielles, les journées d’absences complètes ou de repos sont remplacées par les données qui sont importées.
• Une plage de travail ou une plage d’absence partielle doit nécessairement commencer et finir à un horaire multiple de la granularité de planification pour être importée.
• Pour saisir un repos, il est nécessaire de saisir l'heure de changement de jour en heure de début et l'heure de changement de jour en heure de fin.

Exemple de contenu

QS001;Quotidien_Structure;STRLYON;;1;CALLYON;1;1;0;1;0;0;0;0;T;10:15;15:15;T01;0;T;17:00;21:00;T01;0 
QP001;Quotidien_Personne;;LYON;1;CALLYON;1;1;1;1;0;0;;;T;08:00;13:00;T02;0 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;1;0;1;0;1;T;08:00;11:00;;;T;12:30;15:30 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;2;0;0;0;0;T;08:00;11:00;;;T;12:30;15:30 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;3;;;;;R 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;4;0;0;0;0;T;08:15;11:15;;;T;12:45;15:45 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;5;0;0;0;0;T;08:00;11:00;;;T;12:30;15:30 
HS002;Hebdomadaire_Structure;STRLYON;;1;CALLYON;7;1;1;6;0;0;0;0;T;08:00;11:00;;;T;12:30;15:30 
PS001;Périodique_Structure;STRLYON;;1;CALLYON;3;1;1;1;0;0;0;0;T;10:00;12:00;T01;1;12:00;13:00;T02;1;13:00;17:00;T01;1 
PS001;Périodique_Structure;STRLYON;;1;CALLYON;3;1;1;2;R 
PS001;Périodique_Structure;STRLYON;;1;CALLYON;3;1;1;3;R