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 4.1
modifié par Joséphine Ducruet
sur 2026/03/02 10:46
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 15.1
modifié par Joséphine Ducruet
sur 2026/03/02 13:37
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 modèles ETP
1 +Gérer lesexports ETP
Contenu
... ... @@ -9,8 +9,251 @@
9 9  )))
10 10  
11 11  (((
12 -= Pourquoi gérer les exports ETP ? =
12 += Pourquoi créer et gérer des exports ETP personnalisés dans Flora ? =
13 +
14 +
15 +Des **exports ETP standards** sont fournis par défaut dans Flora. Ils couvrent un large éventail de besoins courants et permettent d’extraire rapidement des données issues des différentes tables vers des formats exploitables (Excel, CSV…).
16 +
17 +Toutefois, ces exports ne correspondent pas toujours précisément aux pratiques, aux méthodes de pilotage ou aux exigences spécifiques de chaque institution.
18 +
19 +C’est pourquoi les **administrateurs fonctionnels** peuvent créer et gérer leurs propres modèles d’exports ETP, afin de répondre à des besoins ciblés.
20 +
21 +Ils peuvent notamment :
22 +
23 +* choisir les **champs exportés**
24 +* modifier le **nom des colonnes**
25 +* définir l’**ordre des colonnes**
26 +* créer des **exports dédiés** à un usage particulier
27 +
28 +Cette personnalisation permet d’**obtenir des documents parfaitement alignés avec les usages internes **et les contraintes de chaque institution.
29 +
30 +(% class="box" %)
31 +(((
32 +Les exports ETP personnalisés sont **conservés lors des montées de version** et apparaissent exactement comme les exports standards du point de vue des utilisateurs.
13 13  )))
14 -)))|(% style="width:300px" %)
15 15  
35 += Paramétrer un nouvel export ETP =
36 +
37 +== Avant de commencer ==
38 +
39 +Le paramétrage d’un export ETP ne se fait jamais « à partir de zéro ».
40 +
41 +Pour garantir la cohérence technique du fichier et éviter toute erreur de structure, il est indispensable de **dupliquer un modèle d’export déjà existant** (généralement un modèle standard fourni par Flora).
42 +
43 +Ce modèle servira de base de travail :
44 +
45 +* il contient déjà la structure XML correcte,
46 +* il est rattaché à la bonne source et à la bonne table,
47 +* il respecte les règles de syntaxe attendues par Flora.
48 +
49 +La personnalisation consiste ensuite à **adapter ce modèle dupliqué** (ajout, suppression, renommage ou déplacement de champs), sans jamais modifier directement un modèle standard.
50 +
51 +== Dupliquer un modèle standard ==
52 +
53 +=== Accéder aux modèles standards ===
54 +
55 +1. Aller dans **Espace de travail → Administration**
56 +1. Ouvrir le menu **Paramétrage**
57 +1. Cliquer sur **Modèles (exports & impr.)**
58 +1. Une arborescence s'affiche
59 +1. Déplier le dossier **Modèles standards ETP** en cliquant sur le + à gauche
60 +1. Déplier le dossier **musee **(même principe, via le **+**).
61 +1. La liste des modèles disponibles s’affiche alors à l’écran
62 +1. Repérer un modèle à dupliquer
63 +
64 +(% class="box warningmessage" %)
65 +(((
66 +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…).
67 +)))
68 +
69 +[[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"]]
70 +
71 +
72 +=== Dupliquer le modèle ===
73 +
74 +1. **Cliquer sur le modèle** pour le sélectionner
75 +1. Cliquer sur l’icône **ciseaux** afin de le copier
76 +1. Dans l’arborescence, ouvrir le dossier **Mes modèles**.
77 +1. Se positionner sur ce dossier.
78 +1. Cliquer sur l’icône **Dupliquer** pour coller le modèle dans //Mes modèles//.
79 +
80 +[[Copier le modèle standard>>image:1772448040958-862.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
81 +
82 +
83 +[[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"]]
84 +
85 +
86 +=== Renommer le nouveau modèle ===
87 +
88 +Après duplication, il est indispensable de **renommer le nouveau modèle** afin de l’identifier clairement comme un export personnalisé.
89 +
90 +Pour cela :
91 +
92 +1. Cliquer sur le modèle copié dans le dossier **Mes modèles** pour le sélectionner
93 +1. Cliquer sur l’icône **Renommer** (icône crayon)
94 +1. Saisir un nouveau nom
95 +1. Cliquer sur Ok
96 +
97 +(% class="box warningmessage" %)
98 +(((
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 +)))
101 +
102 +[[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
103 +
104 +
105 +== Comprendre la structure du fichier de configuration ==
106 +
107 +Le modèle d’export ETP repose sur un **fichier de configuration structuré en XML**.
108 +Chaque ligne du fichier correspond à un élément exporté dans le fichier final (Excel ou CSV).
109 +
110 +Il existe deux grandes structures :
111 +
112 +* les **champs simples** (<field>),
113 +* les **blocs duplicables** (<group_field>).
114 +
115 +Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier.
116 +
117 +=== Les champs simples : une colonne ~= un champ ===
118 +
119 +Ils sont paramétrés dans le modèle via une balise <field>.
120 +
121 +[[Un champ simple dans le fichier de configuration>>image:1772452988186-928.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
122 +
123 +
124 +**Décomposition **:
125 +
126 +* **name**
127 +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.
128 +* **label**
129 +Correspond à l’**intitulé de la colonne dans le fichier exporté**. C’est ce texte qui apparaîtra en en-tête dans Excel.
130 +
131 +=== Les blocs duplicables : plusieurs champs regroupés dans une seule colonne ===
132 +
133 +Certains blocs de champs dans Flora sont **répétables** (ex. : autres numéros, matières, auteurs…).
134 +Ils sont paramétrés dans le modèle via une balise <group_field>.
135 +
136 +[[Un bloc duplicable dans le fichier de configuration>>image:1772453138263-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
137 +
138 +
139 +**Décomposition :**
140 +
141 +* **group_field name**
142 +Nom informatique du bloc exporté.
143 +* **label**
144 +Intitulé de la colonne dans l’export.
145 +* Les <field name> internes
146 +Champs regroupés à l’intérieur du bloc.
147 +
148 +Un <group_field> génère **une seule colonne dans l’export**, même si plusieurs champs internes sont concaténés.
149 +
150 +== Personnaliser le modèle d'export ==
151 +
152 +Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML.
153 +
154 +La personnalisation consiste à intervenir sur les balises :
155 +
156 +* <field> pour les champs simples
157 +* <group_field> pour les blocs répétables
158 +
159 +Chaque modification impacte directement la structure du fichier exporté.
160 +
161 +(% class="box successmessage" %)
162 +(((
163 +**Bonnes pratiques :**
164 +
165 +* Le **nom informatique (name)** doit correspondre exactement au champ existant dans la table concernée.
166 +* Les **apostrophes sont interdites dans les labels**.
167 +* Ne pas modifier la structure générale des balises.
168 +* Toujours travailler sur un modèle dupliqué situé dans **Mes modèles**.
169 +)))
170 +
171 +=== Retirer une colonne de l'export ===
172 +
173 +Si vous ne souhaitez plus faire apparaître un champ dans le fichier exporté :
174 +
175 +1. (((
176 +Repérer la ligne correspondant au champ :
177 +)))
178 +1. Supprimer entièrement la ligne.
179 +1. Enregistrer le modèle.
180 +
181 +La colonne correspondante disparaîtra du fichier exporté.
182 +
183 +Si le champ se trouve dans un <group_field>, vous pouvez :
184 +
185 +* supprimer uniquement le champ concerné,
186 +* ou supprimer l’ensemble du bloc si vous ne souhaitez plus exporter ce regroupement.
187 +
188 +[[Suppression d'une ligne>>image:1772454434767-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
189 +
190 +=== Intégrer un nouveau champ dans le modèle ===
191 +
192 +Pour ajouter une nouvelle colonne :
193 +
194 +1. Copier une ligne <field> existante.
195 +1. La coller à l’endroit souhaité dans le fichier.
196 +1. (((
197 +Modifier :
198 +
199 +* name → nom informatique exact du champ,
200 +* label → intitulé de la colonne.
201 +)))
202 +1. Enregistrer.
203 +
204 +Une nouvelle colonne apparaîtra dans l’export.
205 +
206 +(% class="box warningmessage" %)
207 +(((
208 +**Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.**
209 +)))
210 +
211 +[[Ajout d'une ligne <field~>>>image:1772454482299-412.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
212 +
213 +=== Réorganiser la position des colonnes ===
214 +
215 +L’ordre des balises dans le fichier XML détermine l’ordre des colonnes dans l’export.
216 +
217 +Pour modifier cet ordre :
218 +
219 +1. Sélectionner la ligne du champ concerné.
220 +1. La déplacer à l’endroit souhaité dans la structure.
221 +1. Enregistrer le modèle.
222 +
223 +La colonne sera repositionnée dans le fichier exporté.
224 +
225 +[[Déplacer une ligne <field~>>>image:1772454528400-149.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
226 +
227 +=== Modifier l’intitulé d’une colonne exportée ===
228 +
229 +L’en-tête visible dans le fichier correspond à l’attribut label.
230 +
231 +Pour modifier l’intitulé :
232 +
233 +1. Modifier uniquement le texte du label.
234 +1. Enregistrer le modèle.
235 +
236 +Seul le titre de la colonne change. La donnée extraite reste identique.
237 +
238 +(% class="box warningmessage" %)
239 +(((
240 +**Attention :
241 +Les apostrophes sont interdites dans les labels.**
242 +Ne pas modifier l’attribut name, sauf si vous souhaitez changer le champ exporté.
243 +)))
244 +
245 +[[Modification d'un label>>image:1772454571706-735.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
246 +
247 +
248 +== Déclarer le modèle d'export ==
249 +
16 16  
251 +)))
252 +)))|(% style="width:300px" %)(% class="box" %)
253 +(((
254 +**Sommaire**
255 +
256 +{{toc depth="2" numbered="true"/}}
257 +)))
258 +
259 +
1772446851263-443.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +183.3 KB
Contenu
1772448040958-862.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +228.1 KB
Contenu
1772448143843-514.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +227.0 KB
Contenu
1772449241680-984.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +222.5 KB
Contenu
1772449421784-403.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.JDT
Taille
... ... @@ -1,0 +1,1 @@
1 +222.5 KB
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