Aller au contenu

Modifications pour le document Gérer les exports ETP

Modifié par Joséphine Ducruet le 2026/03/02 14:20
Depuis la version 5.1
modifié par Joséphine Ducruet
sur 2026/03/02 11:15
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 20.1
modifié par Joséphine Ducruet
sur 2026/03/02 14:10
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Titre
... ... @@ -1,1 +1,1 @@
1 -Gérer lesexports ETP
1 +Gérer les exports ETP
Contenu
... ... @@ -5,7 +5,15 @@
5 5  |(% style="width:840px" %)(((
6 6  (% class="box" %)
7 7  (((
8 -
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.
9 9  )))
10 10  
11 11  (((
... ... @@ -55,21 +55,323 @@
55 55  1. Aller dans **Espace de travail → Administration**
56 56  1. Ouvrir le menu **Paramétrage**
57 57  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 +
58 58  1. (((
59 -Une arborescence s’affiche
184 +Repérer la ligne correspondant au champ :
60 60  )))
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.
61 61  1. (((
62 -Déplier le dossier **Modèles standards ETP** en cliquant sur le **+** à gauche.
205 +Modifier :
206 +
207 +* name → nom informatique exact du champ,
208 +* label → intitulé de la colonne.
63 63  )))
64 -1. Puis,déplier également le dossier **musee **(même principe, via le **+**).
65 -1. La liste des modèles disponibles s’affiche alors à l’écran
66 -1. Repérer un modèle à dupliquer
210 +1. Enregistrer.
67 67  
212 +Une nouvelle colonne apparaîtra dans l’export.
213 +
68 68  (% class="box warningmessage" %)
69 69  (((
70 -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…).
216 +**Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.**
71 71  )))
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é.
72 72  )))
73 -)))|(% style="width:300px" %)
74 74  
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 +* [[Générer des documents>>doc:1_Fonctionnalités.Communiquer les données .Générer des documents.WebHome]]
366 +* [[Comprendre les sources et les tables dans Flora>>doc:2_Administration.Administration fonctionnelle.Présentation des sources et des tables.WebHome]]
367 +)))
368 +
369 +(% class="box" %)
370 +(((
371 +**Icônes principales**
372 +
373 +* [[image:1753106455706-977.png]] : Copier
374 +
375 +
376 +
377 +* [[image:1753108579445-945.png]] : Dupliquer
378 +
379 +
380 +
381 +* [[image:1753106171963-656.png]] : Renommer
382 +)))
383 +)))
384 +
75 75  
1753106171963-656.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +926 bytes
Contenu
1753106455706-977.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +1.0 KB
Contenu
1753108579445-945.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +768 bytes
Contenu
1772446851263-443.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +183.3 KB
Contenu
1772448040958-862.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +228.1 KB
Contenu
1772448143843-514.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +227.0 KB
Contenu
1772449241680-984.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +222.5 KB
Contenu
1772449421784-403.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +222.5 KB
Contenu
1772452988186-928.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +216.3 KB
Contenu
1772453138263-760.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +217.8 KB
Contenu
1772454434767-760.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +177.5 KB
Contenu
1772454482299-412.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +177.5 KB
Contenu
1772454528400-149.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +177.5 KB
Contenu
1772454571706-735.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +177.1 KB
Contenu
1772456037368-702.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +90.2 KB
Contenu
1772456112818-791.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +100.9 KB
Contenu
1772456183014-961.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +216.3 KB
Contenu
1772456234332-547.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +115.0 KB
Contenu
1772456297063-101.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +99.8 KB
Contenu