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 16.1
modifié par Joséphine Ducruet
sur 2026/03/02 13:55
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Contenu
... ... @@ -112,6 +112,8 @@
112 112  * les **champs simples** (<field>),
113 113  * les **blocs duplicables** (<group_field>).
114 114  
115 +Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier.
116 +
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,198 @@
147 147  
148 148  == Personnaliser le modèle d'export ==
149 149  
152 +Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML.
150 150  
151 -
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**.
152 152  )))
153 -)))|(% style="width:300px" %)
154 154  
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 +=== Renseigner la notice dupliquée ===
296 +
297 +Compléter soigneusement les champs suivants :
298 +
299 +* **Nom du modèle**
300 +** Doit obligatoirement commencer par **S_**
301 +** Sert d’identifiant technique
302 +
303 +
304 +
305 +* **Libellé du rapport**
306 +** Correspond au nom visible par les utilisateurs
307 +** C’est ce libellé qui apparaîtra dans la liste des exports disponibles
308 +
309 +
310 +
311 +* **Source et table d’application**
312 +** la **source** (Musée, Default, Archive…),
313 +** la **table** concernée (ex. MUS_BIEN).
314 +
315 +(% class="box warningmessage" %)
316 +(((
317 +Elles doivent correspondre exactement à la table utilisée dans le fichier paramétré.
318 +)))
319 +
320 +* **Droits d’accès**
321 +** Sélectionner les **rôles** autorisés à utiliser cet export.
322 +** Seuls les utilisateurs rattachés à ces rôles verront le modèle dans la liste.
323 +
324 +
325 +
326 +* **Modèle de fusion**
327 +
328 +1. Cliquer sur l’icône **dossier** située à droite du champ.
329 +1. Parcourir l’arborescence.
330 +1. Sélectionner le modèle XML personnalisé précédemment paramétré (dans //Mes modèles//).
331 +
332 +Cela permet d’associer la notice déclarative au fichier de paramétrage.Enregistrer
333 +
334 +
335 +Puis** enregistrer** la notice.
336 +
337 +L’export est désormais déclaré et disponible pour les utilisateurs autorisés.
338 +)))
339 +)))|(% style="width:300px" %)(% class="box" %)
340 +(((
341 +**Sommaire**
342 +
343 +{{toc depth="2" numbered="true"/}}
344 +)))
345 +
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