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 13.1
modifié par Joséphine Ducruet
sur 2026/03/02 13:09
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  (((
... ... @@ -112,6 +112,8 @@
112 112  * les **champs simples** (<field>),
113 113  * les **blocs duplicables** (<group_field>).
114 114  
121 +Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier.
122 +
115 115  === Les champs simples : une colonne ~= un champ ===
116 116  
117 117  Ils sont paramétrés dans le modèle via une balise <field>.
... ... @@ -147,9 +147,229 @@
147 147  
148 148  == Personnaliser le modèle d'export ==
149 149  
158 +Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML.
150 150  
151 -
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**.
152 152  )))
153 -)))|(% style="width:300px" %)
154 154  
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 +
155 155  
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
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