Aller au contenu

Code source wiki de Gérer les exports ETP

Version 19.1 par Joséphine Ducruet le 2026/03/02 14:05
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 Les exports ETP constituent un outil central d’extraction de données dans Flora.
9 Ils permettent de produire des fichiers structurés (Excel ou CSV) à partir des différentes tables de l’application en sélectionnant précisément les champs à exporter.
10
11 La gestion des exports ETP repose sur deux niveaux :
12
13 * **le paramétrage du modèle d’export** (structure des champs, ordre des colonnes, intitulés),
14 * **la déclaration du modèle** pour le rendre disponible aux utilisateurs selon des droits d’accès définis.
15
16 Cette organisation permet aux administrateurs fonctionnels de créer des exports parfaitement adaptés aux besoins de leur institution.
17 )))
18
19 (((
20 = Pourquoi créer et gérer des exports ETP personnalisés dans Flora ? =
21
22
23 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…).
24
25 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.
26
27 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.
28
29 Ils peuvent notamment :
30
31 * choisir les **champs exportés**
32 * modifier le **nom des colonnes**
33 * définir l’**ordre des colonnes**
34 * créer des **exports dédiés** à un usage particulier
35
36 Cette personnalisation permet d’**obtenir des documents parfaitement alignés avec les usages internes **et les contraintes de chaque institution.
37
38 (% class="box" %)
39 (((
40 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.
41 )))
42
43 = Paramétrer un nouvel export ETP =
44
45 == Avant de commencer ==
46
47 Le paramétrage d’un export ETP ne se fait jamais « à partir de zéro ».
48
49 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).
50
51 Ce modèle servira de base de travail :
52
53 * il contient déjà la structure XML correcte,
54 * il est rattaché à la bonne source et à la bonne table,
55 * il respecte les règles de syntaxe attendues par Flora.
56
57 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.
58
59 == Dupliquer un modèle standard ==
60
61 === Accéder aux modèles standards ===
62
63 1. Aller dans **Espace de travail → Administration**
64 1. Ouvrir le menu **Paramétrage**
65 1. Cliquer sur **Modèles (exports & impr.)**
66 1. Une arborescence s'affiche
67 1. Déplier le dossier **Modèles standards ETP** en cliquant sur le + à gauche
68 1. Déplier le dossier **musee **(même principe, via le **+**).
69 1. La liste des modèles disponibles s’affiche alors à l’écran
70 1. Repérer un modèle à dupliquer
71
72 (% class="box warningmessage" %)
73 (((
74 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…).
75 )))
76
77 [[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"]]
78
79
80 === Dupliquer le modèle ===
81
82 1. **Cliquer sur le modèle** pour le sélectionner
83 1. Cliquer sur l’icône **ciseaux** afin de le copier
84 1. Dans l’arborescence, ouvrir le dossier **Mes modèles**.
85 1. Se positionner sur ce dossier.
86 1. Cliquer sur l’icône **Dupliquer** pour coller le modèle dans //Mes modèles//.
87
88 [[Copier le modèle standard>>image:1772448040958-862.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
89
90
91 [[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"]]
92
93
94 === Renommer le nouveau modèle ===
95
96 Après duplication, il est indispensable de **renommer le nouveau modèle** afin de l’identifier clairement comme un export personnalisé.
97
98 Pour cela :
99
100 1. Cliquer sur le modèle copié dans le dossier **Mes modèles** pour le sélectionner
101 1. Cliquer sur l’icône **Renommer** (icône crayon)
102 1. Saisir un nouveau nom
103 1. Cliquer sur Ok
104
105 (% class="box warningmessage" %)
106 (((
107 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.
108 )))
109
110 [[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
111
112
113 == Comprendre la structure du fichier de configuration ==
114
115 Le modèle d’export ETP repose sur un **fichier de configuration structuré en XML**.
116 Chaque ligne du fichier correspond à un élément exporté dans le fichier final (Excel ou CSV).
117
118 Il existe deux grandes structures :
119
120 * les **champs simples** (<field>),
121 * les **blocs duplicables** (<group_field>).
122
123 Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier.
124
125 === Les champs simples : une colonne ~= un champ ===
126
127 Ils sont paramétrés dans le modèle via une balise <field>.
128
129 [[Un champ simple dans le fichier de configuration>>image:1772452988186-928.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
130
131
132 **Décomposition **:
133
134 * **name**
135 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.
136 * **label**
137 Correspond à l’**intitulé de la colonne dans le fichier exporté**. C’est ce texte qui apparaîtra en en-tête dans Excel.
138
139 === Les blocs duplicables : plusieurs champs regroupés dans une seule colonne ===
140
141 Certains blocs de champs dans Flora sont **répétables** (ex. : autres numéros, matières, auteurs…).
142 Ils sont paramétrés dans le modèle via une balise <group_field>.
143
144 [[Un bloc duplicable dans le fichier de configuration>>image:1772453138263-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
145
146
147 **Décomposition :**
148
149 * **group_field name**
150 Nom informatique du bloc exporté.
151 * **label**
152 Intitulé de la colonne dans l’export.
153 * Les <field name> internes
154 Champs regroupés à l’intérieur du bloc.
155
156 Un <group_field> génère **une seule colonne dans l’export**, même si plusieurs champs internes sont concaténés.
157
158 == Personnaliser le modèle d'export ==
159
160 Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML.
161
162 La personnalisation consiste à intervenir sur les balises :
163
164 * <field> pour les champs simples
165 * <group_field> pour les blocs répétables
166
167 Chaque modification impacte directement la structure du fichier exporté.
168
169 (% class="box successmessage" %)
170 (((
171 **Bonnes pratiques :**
172
173 * Le **nom informatique (name)** doit correspondre exactement au champ existant dans la table concernée.
174 * Les **apostrophes sont interdites dans les labels**.
175 * Ne pas modifier la structure générale des balises.
176 * Toujours travailler sur un modèle dupliqué situé dans **Mes modèles**.
177 )))
178
179 === Retirer une colonne de l'export ===
180
181 Si vous ne souhaitez plus faire apparaître un champ dans le fichier exporté :
182
183 1. (((
184 Repérer la ligne correspondant au champ :
185 )))
186 1. Supprimer entièrement la ligne.
187 1. Enregistrer le modèle.
188
189 La colonne correspondante disparaîtra du fichier exporté.
190
191 Si le champ se trouve dans un <group_field>, vous pouvez :
192
193 * supprimer uniquement le champ concerné,
194 * ou supprimer l’ensemble du bloc si vous ne souhaitez plus exporter ce regroupement.
195
196 [[Suppression d'une ligne>>image:1772454434767-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
197
198 === Intégrer un nouveau champ dans le modèle ===
199
200 Pour ajouter une nouvelle colonne :
201
202 1. Copier une ligne <field> existante.
203 1. La coller à l’endroit souhaité dans le fichier.
204 1. (((
205 Modifier :
206
207 * name → nom informatique exact du champ,
208 * label → intitulé de la colonne.
209 )))
210 1. Enregistrer.
211
212 Une nouvelle colonne apparaîtra dans l’export.
213
214 (% class="box warningmessage" %)
215 (((
216 **Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.**
217 )))
218
219 [[Ajout d'une ligne <field~>>>image:1772454482299-412.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
220
221 === Réorganiser la position des colonnes ===
222
223 L’ordre des balises dans le fichier XML détermine l’ordre des colonnes dans l’export.
224
225 Pour modifier cet ordre :
226
227 1. Sélectionner la ligne du champ concerné.
228 1. La déplacer à l’endroit souhaité dans la structure.
229 1. Enregistrer le modèle.
230
231 La colonne sera repositionnée dans le fichier exporté.
232
233 [[Déplacer une ligne <field~>>>image:1772454528400-149.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
234
235 === Modifier l’intitulé d’une colonne exportée ===
236
237 L’en-tête visible dans le fichier correspond à l’attribut label.
238
239 Pour modifier l’intitulé :
240
241 1. Modifier uniquement le texte du label.
242 1. Enregistrer le modèle.
243
244 Seul le titre de la colonne change. La donnée extraite reste identique.
245
246 (% class="box warningmessage" %)
247 (((
248 **Attention :
249 Les apostrophes sont interdites dans les labels.**
250 Ne pas modifier l’attribut name, sauf si vous souhaitez changer le champ exporté.
251 )))
252
253 [[Modification d'un label>>image:1772454571706-735.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
254
255
256 == Déclarer le modèle d'export ==
257
258 La personnalisation du fichier XML ne suffit pas : pour que l’export apparaisse dans la liste des exports disponibles pour les utilisateurs, il est nécessaire de **le déclarer dans la table des modèles**.
259
260 Cette étape permet d’associer :
261
262 * le fichier paramétré,
263 * une source et une table,
264 * un nom visible par les utilisateurs,
265 * des droits d’accès.
266
267 === Rechercher les modèles d'exports ETP ===
268
269 Pour accéder à la table des modèles :
270
271 1. Aller dans **Espace de travail → Administration**
272 1. Ouvrir le menu **Données**
273 1. Cliquer sur **Recherche**
274
275 Dans l’écran de recherche :
276
277 1. Choisir la **source : Données système**
278 1. Choisir la **table : Modèle de publication**
279 1. (((
280 Lancer une recherche avec :
281
282 * **Index : Catégorie**
283 * **Critère : Export tabulé**
284 )))
285
286 Lancer la recherche.
287
288 Vous arrivez sur la liste des exports ETP déjà déclarés dans le système.
289
290 [[Recherche dans la source Données système et sur la table Modèle de publicaiton>>image:1772456037368-702.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
291
292 [[Recherche sur la catégorie Export tabulé>>image:1772456112818-791.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
293
294 === Dupliquer un modèle existant ===
295
296 Pour créer la déclaration de votre nouvel export :
297
298 1. Ouvrir la notice d’un modèle existant //(de préférence le même type que celui que vous avez dupliqué au début)//
299 1. Cliquer sur l’icône **Dupliquer**
300
301 Une nouvelle notice est créée à partir du modèle sélectionné.
302
303 [[Liste des notices des modèles d'export>>image:1772456183014-961.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
304
305 [[Dupliquer une notice>>image:1772456234332-547.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
306
307 === Renseigner la notice dupliquée ===
308
309 Compléter soigneusement les champs suivants en choisissant la **grille de saisie //Export ETP//** :
310
311 * **Nom du modèle**
312 ** Doit obligatoirement commencer par **S_**
313 ** Sert d’identifiant technique
314
315
316
317 * **Libellé du rapport**
318 ** Correspond au nom visible par les utilisateurs
319 ** C’est ce libellé qui apparaîtra dans la liste des exports disponibles
320
321
322
323 * **Source et table d’application**
324 ** la **source** (Musée, Default, Archive…),
325 ** la **table** concernée (ex. MUS_BIEN).
326
327 (% class="box warningmessage" %)
328 (((
329 Elles doivent correspondre exactement à la table utilisée dans le fichier paramétré.
330 )))
331
332 * **Droits d’accès**
333 ** Sélectionner les **rôles** autorisés à utiliser cet export.
334 ** Seuls les utilisateurs rattachés à ces rôles verront le modèle dans la liste.
335
336
337
338 * **Modèle de fusion**
339
340 1. Cliquer sur l’icône **dossier** située à droite du champ.
341 1. Parcourir l’arborescence.
342 1. Sélectionner le modèle XML personnalisé précédemment paramétré (dans //Mes modèles//).
343
344 Cela permet d’associer la notice déclarative au fichier de paramétrage.Enregistrer
345
346
347 Puis** enregistrer** la notice.
348
349 L’export est désormais déclaré et disponible pour les utilisateurs autorisés.
350
351 [[Notice dupliquée à renseigner>>image:1772456297063-101.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
352 )))
353 )))|(% style="width:300px" %)(((
354 (% class="box" %)
355 (((
356 **Sommaire**
357
358 {{toc depth="2" numbered="true"/}}
359 )))
360
361 (% class="box" %)
362 (((
363 **Aller plus loin**
364
365 )))
366
367 (% class="box" %)
368 (((
369 **Icônes principales**
370 )))
371 )))
372
373