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 6.1
modifié par Joséphine Ducruet
sur 2026/03/02 11:17
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 14.1
modifié par Joséphine Ducruet
sur 2026/03/02 13:29
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Contenu
... ... @@ -55,12 +55,9 @@
55 55  1. Aller dans **Espace de travail → Administration**
56 56  1. Ouvrir le menu **Paramétrage**
57 57  1. Cliquer sur **Modèles (exports & impr.)**
58 -1. (((
59 -Une arborescence s’affiche
60 -
61 -
62 -)))
63 -1. Puis,déplier également le dossier **musee **(même principe, via le **+**).
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 **+**).
64 64  1. La liste des modèles disponibles s’affiche alors à l’écran
65 65  1. Repérer un modèle à dupliquer
66 66  
... ... @@ -68,7 +68,185 @@
68 68  (((
69 69  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…).
70 70  )))
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.
71 71  )))
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 +)))
72 72  )))|(% style="width:300px" %)
73 73  
74 74  
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