Aller au contenu

Code source wiki de Gérer lesexports ETP

Version 14.1 par Joséphine Ducruet le 2026/03/02 13:29
Afficher les derniers auteurs
1 **PAGE EN COURS DE REDACTION**
2
3 (% class="mark small" %)**Version 4.5.40 et ultérieures**
4
5 |(% style="width:840px" %)(((
6 (% class="box" %)
7 (((
8
9 )))
10
11 (((
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.
33 )))
34
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 )))|(% style="width:300px" %)
248
249