Aller au contenu

Code source wiki de Gérer lesexports ETP

Version 13.1 par Joséphine Ducruet le 2026/03/02 13:09
Afficher les derniers auteurs
1 **PAGE EN COURS DE REDACTION**
2
3 (% class="mark small" %)**Version 4.5.40 et ultérieures**
4
5 |(% style="width:840px" %)(((
6 (% class="box" %)
7 (((
8
9 )))
10
11 (((
12 = Pourquoi créer et gérer des exports ETP personnalisés dans Flora ? =
13
14
15 Des **exports ETP standards** sont fournis par défaut dans Flora. Ils couvrent un large éventail de besoins courants et permettent d’extraire rapidement des données issues des différentes tables vers des formats exploitables (Excel, CSV…).
16
17 Toutefois, ces exports ne correspondent pas toujours précisément aux pratiques, aux méthodes de pilotage ou aux exigences spécifiques de chaque institution.
18
19 C’est pourquoi les **administrateurs fonctionnels** peuvent créer et gérer leurs propres modèles d’exports ETP, afin de répondre à des besoins ciblés.
20
21 Ils peuvent notamment :
22
23 * choisir les **champs exportés**
24 * modifier le **nom des colonnes**
25 * définir l’**ordre des colonnes**
26 * créer des **exports dédiés** à un usage particulier
27
28 Cette personnalisation permet d’**obtenir des documents parfaitement alignés avec les usages internes **et les contraintes de chaque institution.
29
30 (% class="box" %)
31 (((
32 Les exports ETP personnalisés sont **conservés lors des montées de version** et apparaissent exactement comme les exports standards du point de vue des utilisateurs.
33 )))
34
35 = Paramétrer un nouvel export ETP =
36
37 == Avant de commencer ==
38
39 Le paramétrage d’un export ETP ne se fait jamais « à partir de zéro ».
40
41 Pour garantir la cohérence technique du fichier et éviter toute erreur de structure, il est indispensable de **dupliquer un modèle d’export déjà existant** (généralement un modèle standard fourni par Flora).
42
43 Ce modèle servira de base de travail :
44
45 * il contient déjà la structure XML correcte,
46 * il est rattaché à la bonne source et à la bonne table,
47 * il respecte les règles de syntaxe attendues par Flora.
48
49 La personnalisation consiste ensuite à **adapter ce modèle dupliqué** (ajout, suppression, renommage ou déplacement de champs), sans jamais modifier directement un modèle standard.
50
51 == Dupliquer un modèle standard ==
52
53 === Accéder aux modèles standards ===
54
55 1. Aller dans **Espace de travail → Administration**
56 1. Ouvrir le menu **Paramétrage**
57 1. Cliquer sur **Modèles (exports & impr.)**
58 1. Une arborescence s'affiche
59 1. Déplier le dossier **Modèles standards ETP** en cliquant sur le + à gauche
60 1. Déplier le dossier **musee **(même principe, via le **+**).
61 1. La liste des modèles disponibles s’affiche alors à l’écran
62 1. Repérer un modèle à dupliquer
63
64 (% class="box warningmessage" %)
65 (((
66 Vérifiez que le modèle sélectionné s’applique à **la même table** que celle sur laquelle vous souhaitez créer votre export (ex. : MUS_BIEN, MUS_ORIGINE, MUS_EVENEMENT…).
67 )))
68
69 [[Accès aux modèles standards d'exports ETP>>image:1772446851263-443.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
70
71
72 === Dupliquer le modèle ===
73
74 1. **Cliquer sur le modèle** pour le sélectionner
75 1. Cliquer sur l’icône **ciseaux** afin de le copier
76 1. Dans l’arborescence, ouvrir le dossier **Mes modèles**.
77 1. Se positionner sur ce dossier.
78 1. Cliquer sur l’icône **Dupliquer** pour coller le modèle dans //Mes modèles//.
79
80 [[Copier le modèle standard>>image:1772448040958-862.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
81
82
83 [[Dupliquer le modèle dans le dossier Mes modèles>>image:1772448143843-514.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
84
85
86 === Renommer le nouveau modèle ===
87
88 Après duplication, il est indispensable de **renommer le nouveau modèle** afin de l’identifier clairement comme un export personnalisé.
89
90 Pour cela :
91
92 1. Cliquer sur le modèle copié dans le dossier **Mes modèles** pour le sélectionner
93 1. Cliquer sur l’icône **Renommer** (icône crayon)
94 1. Saisir un nouveau nom
95 1. Cliquer sur Ok
96
97 (% class="box warningmessage" %)
98 (((
99 Le nom doit obligatoirement commencer par **S_** afin d’indiquer qu’il s’agit d’un modèle **Spécifique** (personnalisé) et non d’un modèle standard fourni par Flora.
100 )))
101
102 [[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
103
104
105 == Comprendre la structure du fichier de configuration ==
106
107 Le modèle d’export ETP repose sur un **fichier de configuration structuré en XML**.
108 Chaque ligne du fichier correspond à un élément exporté dans le fichier final (Excel ou CSV).
109
110 Il existe deux grandes structures :
111
112 * les **champs simples** (<field>),
113 * les **blocs duplicables** (<group_field>).
114
115 === Les champs simples : une colonne ~= un champ ===
116
117 Ils sont paramétrés dans le modèle via une balise <field>.
118
119 [[Un champ simple dans le fichier de configuration>>image:1772452988186-928.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
120
121
122 **Décomposition **:
123
124 * **name**
125 Correspond au **nom informatique du champ** dans la base Flora. C’est ce nom qui permet au système d’aller chercher la donnée.
126 * **label**
127 Correspond à l’**intitulé de la colonne dans le fichier exporté**. C’est ce texte qui apparaîtra en en-tête dans Excel.
128
129 === Les blocs duplicables : plusieurs champs regroupés dans une seule colonne ===
130
131 Certains blocs de champs dans Flora sont **répétables** (ex. : autres numéros, matières, auteurs…).
132 Ils sont paramétrés dans le modèle via une balise <group_field>.
133
134 [[Un bloc duplicable dans le fichier de configuration>>image:1772453138263-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
135
136
137 **Décomposition :**
138
139 * **group_field name**
140 Nom informatique du bloc exporté.
141 * **label**
142 Intitulé de la colonne dans l’export.
143 * Les <field name> internes
144 Champs regroupés à l’intérieur du bloc.
145
146 Un <group_field> génère **une seule colonne dans l’export**, même si plusieurs champs internes sont concaténés.
147
148 == Personnaliser le modèle d'export ==
149
150
151
152 )))
153 )))|(% style="width:300px" %)
154
155