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 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
À 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

Résumé

Détails

Propriétés de la Page
Titre
... ... @@ -1,1 +1,1 @@
1 -Gérer les exports ETP
1 +Gérer lesexports ETP
Contenu
... ... @@ -5,15 +5,7 @@
5 5  |(% style="width:840px" %)(((
6 6  (% class="box" %)
7 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.
8 +
17 17  )))
18 18  
19 19  (((
... ... @@ -63,323 +63,21 @@
63 63  1. Aller dans **Espace de travail → Administration**
64 64  1. Ouvrir le menu **Paramétrage**
65 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 183  1. (((
184 -Repérer la ligne correspondant au champ :
59 +Une arborescence s’affiche
185 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 204  1. (((
205 -Modifier :
206 -
207 -* name → nom informatique exact du champ,
208 -* label → intitulé de la colonne.
62 +Déplier le dossier **Modèles standards ETP** en cliquant sur le **+** à gauche.
209 209  )))
210 -1. Enregistrer.
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
211 211  
212 -Une nouvelle colonne apparaîtra dans l’export.
213 -
214 214  (% class="box warningmessage" %)
215 215  (((
216 -**Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.**
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…).
217 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 251  )))
73 +)))|(% style="width:300px" %)
252 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 -* [[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 -
385 385  
1753106171963-656.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -926 bytes
Contenu
1753106455706-977.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -1.0 KB
Contenu
1753108579445-945.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -768 bytes
Contenu
1772446851263-443.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -183.3 KB
Contenu
1772448040958-862.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -228.1 KB
Contenu
1772448143843-514.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -227.0 KB
Contenu
1772449241680-984.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -222.5 KB
Contenu
1772449421784-403.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -222.5 KB
Contenu
1772452988186-928.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -216.3 KB
Contenu
1772453138263-760.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -217.8 KB
Contenu
1772454434767-760.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -177.5 KB
Contenu
1772454482299-412.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -177.5 KB
Contenu
1772454528400-149.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -177.5 KB
Contenu
1772454571706-735.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -177.1 KB
Contenu
1772456037368-702.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -90.2 KB
Contenu
1772456112818-791.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -100.9 KB
Contenu
1772456183014-961.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -216.3 KB
Contenu
1772456234332-547.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -115.0 KB
Contenu
1772456297063-101.png
Auteur
... ... @@ -1,1 +1,0 @@
1 -XWiki.JDT
Taille
... ... @@ -1,1 +1,0 @@
1 -99.8 KB
Contenu