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 17.1
modifié par Joséphine Ducruet
sur 2026/03/02 13:59
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
Contenu
... ... @@ -101,252 +101,8 @@
101 101  
102 102  [[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
103 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**.
104 +
169 169  )))
106 +)))|(% style="width:300px" %)
170 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 -
250 -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**.
251 -
252 -Cette étape permet d’associer :
253 -
254 -* le fichier paramétré,
255 -* une source et une table,
256 -* un nom visible par les utilisateurs,
257 -* des droits d’accès.
258 -
259 -=== Rechercher les modèles d'exports ETP ===
260 -
261 -Pour accéder à la table des modèles :
262 -
263 -1. Aller dans **Espace de travail → Administration**
264 -1. Ouvrir le menu **Données**
265 -1. Cliquer sur **Recherche**
266 -
267 -Dans l’écran de recherche :
268 -
269 -1. Choisir la **source : Données système**
270 -1. Choisir la **table : Modèle de publication**
271 -1. (((
272 -Lancer une recherche avec :
273 -
274 -* **Index : Catégorie**
275 -* **Critère : Export tabulé**
276 -)))
277 -
278 -Lancer la recherche.
279 -
280 -Vous arrivez sur la liste des exports ETP déjà déclarés dans le système.
281 -
282 -[[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"]]
283 -
284 -[[Recherche sur la catégorie Export tabulé>>image:1772456112818-791.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
285 -
286 -=== Dupliquer un modèle existant ===
287 -
288 -Pour créer la déclaration de votre nouvel export :
289 -
290 -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)//
291 -1. Cliquer sur l’icône **Dupliquer**
292 -
293 -Une nouvelle notice est créée à partir du modèle sélectionné.
294 -
295 -[[Liste des notices des modèles d'export>>image:1772456183014-961.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
296 -
297 -[[Dupliquer une notice>>image:1772456234332-547.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
298 -
299 -=== Renseigner la notice dupliquée ===
300 -
301 -Compléter soigneusement les champs suivants en choisissant la **grille de saisie //Export ETP//** :
302 -
303 -* **Nom du modèle**
304 -** Doit obligatoirement commencer par **S_**
305 -** Sert d’identifiant technique
306 -
307 -
308 -
309 -* **Libellé du rapport**
310 -** Correspond au nom visible par les utilisateurs
311 -** C’est ce libellé qui apparaîtra dans la liste des exports disponibles
312 -
313 -
314 -
315 -* **Source et table d’application**
316 -** la **source** (Musée, Default, Archive…),
317 -** la **table** concernée (ex. MUS_BIEN).
318 -
319 -(% class="box warningmessage" %)
320 -(((
321 -Elles doivent correspondre exactement à la table utilisée dans le fichier paramétré.
322 -)))
323 -
324 -* **Droits d’accès**
325 -** Sélectionner les **rôles** autorisés à utiliser cet export.
326 -** Seuls les utilisateurs rattachés à ces rôles verront le modèle dans la liste.
327 -
328 -
329 -
330 -* **Modèle de fusion**
331 -
332 -1. Cliquer sur l’icône **dossier** située à droite du champ.
333 -1. Parcourir l’arborescence.
334 -1. Sélectionner le modèle XML personnalisé précédemment paramétré (dans //Mes modèles//).
335 -
336 -Cela permet d’associer la notice déclarative au fichier de paramétrage.Enregistrer
337 -
338 -
339 -Puis** enregistrer** la notice.
340 -
341 -L’export est désormais déclaré et disponible pour les utilisateurs autorisés.
342 -
343 -[[Notice dupliquée à renseigner>>image:1772456297063-101.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
344 -)))
345 -)))|(% style="width:300px" %)(% class="box" %)
346 -(((
347 -**Sommaire**
348 -
349 -{{toc depth="2" numbered="true"/}}
350 -)))
351 -
352 352  
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