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 19.1
modifié par Joséphine Ducruet
sur 2026/03/02 14:05
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  (((
... ... @@ -112,6 +112,8 @@
112 112  * les **champs simples** (<field>),
113 113  * les **blocs duplicables** (<group_field>).
114 114  
123 +Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier.
124 +
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,217 @@
147 147  
148 148  == Personnaliser le modèle d'export ==
149 149  
160 +Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML.
150 150  
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 +1. (((
184 +Repérer la ligne correspondant au champ :
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 +1. (((
205 +Modifier :
206 +
207 +* name → nom informatique exact du champ,
208 +* label → intitulé de la colonne.
209 +)))
210 +1. Enregistrer.
211 +
212 +Une nouvelle colonne apparaîtra dans l’export.
213 +
214 +(% class="box warningmessage" %)
215 +(((
216 +**Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.**
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 +)))
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**
151 151  
152 152  )))
153 -)))|(% style="width:300px" %)
154 154  
367 +(% class="box" %)
368 +(((
369 +**Icônes principales**
370 +)))
371 +)))
372 +
155 155  
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