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 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
À la version 11.1
modifié par Joséphine Ducruet
sur 2026/03/02 12:04
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
... ... @@ -1,17 +1,11 @@
1 +**PAGE EN COURS DE REDACTION**
2 +
1 1  (% class="mark small" %)**Version 4.5.40 et ultérieures**
2 2  
3 3  |(% style="width:840px" %)(((
4 4  (% class="box" %)
5 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.
8 +
15 15  )))
16 16  
17 17  (((
... ... @@ -107,277 +107,8 @@
107 107  
108 108  [[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
109 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**.
104 +
175 175  )))
106 +)))|(% style="width:300px" %)
176 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 383  
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
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