Aller au contenu

Code source wiki de Gérer les exports ETP

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