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 10.1
modifié par Joséphine Ducruet
sur 2026/03/02 12:04
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 21.1
modifié par Joséphine Ducruet
sur 2026/03/02 14:20
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
... ... @@ -1,11 +3,17 @@
1 -**PAGE EN COURS DE REDACTION**
2 -
3 3  (% class="mark small" %)**Version 4.5.40 et ultérieures**
4 4  
5 5  |(% style="width:840px" %)(((
6 6  (% class="box" %)
7 7  (((
8 -
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.
9 9  )))
10 10  
11 11  (((
... ... @@ -99,10 +99,279 @@
99 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 100  )))
101 101  
102 - ​​​​​
103 -
104 104  [[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**.
105 105  )))
106 -)))|(% style="width:300px" %)
107 107  
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 +
108 108  
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
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