Code source wiki de Gérer les exports ETP
Modifié par Joséphine Ducruet le 2026/03/02 14:20
Masquer les derniers auteurs
| author | version | line-number | content |
|---|---|---|---|
 |
3.1 | 1 | (% class="mark small" %)**Version 4.5.40 et ultérieures** |
| |
4.1 | 2 | |
| 3 | |(% style="width:840px" %)((( | ||
| 4 | (% class="box" %) | ||
| 5 | ((( | ||
| |
19.1 | 6 | Les exports ETP constituent un outil central d’extraction de données dans Flora. |
| 7 | Ils permettent de produire des fichiers structurés (Excel ou CSV) à partir des différentes tables de l’application en sélectionnant précisément les champs à exporter. | ||
| 8 | |||
| 9 | La gestion des exports ETP repose sur deux niveaux : | ||
| 10 | |||
| 11 | * **le paramétrage du modèle d’export** (structure des champs, ordre des colonnes, intitulés), | ||
| 12 | * **la déclaration du modèle** pour le rendre disponible aux utilisateurs selon des droits d’accès définis. | ||
| 13 | |||
| 14 | Cette organisation permet aux administrateurs fonctionnels de créer des exports parfaitement adaptés aux besoins de leur institution. | ||
| |
4.1 | 15 | ))) |
| 16 | |||
| 17 | ((( | ||
| |
5.1 | 18 | = Pourquoi créer et gérer des exports ETP personnalisés dans Flora ? = |
| 19 | |||
| 20 | |||
| 21 | 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…). | ||
| 22 | |||
| 23 | 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. | ||
| 24 | |||
| 25 | 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. | ||
| 26 | |||
| 27 | Ils peuvent notamment : | ||
| 28 | |||
| 29 | * choisir les **champs exportés** | ||
| 30 | * modifier le **nom des colonnes** | ||
| 31 | * définir l’**ordre des colonnes** | ||
| 32 | * créer des **exports dédiés** à un usage particulier | ||
| 33 | |||
| 34 | Cette personnalisation permet d’**obtenir des documents parfaitement alignés avec les usages internes **et les contraintes de chaque institution. | ||
| 35 | |||
| 36 | (% class="box" %) | ||
| 37 | ((( | ||
| 38 | 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. | ||
| |
4.1 | 39 | ))) |
| |
5.1 | 40 | |
| 41 | = Paramétrer un nouvel export ETP = | ||
| 42 | |||
| 43 | == Avant de commencer == | ||
| 44 | |||
| 45 | Le paramétrage d’un export ETP ne se fait jamais « à partir de zéro ». | ||
| 46 | |||
| 47 | 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). | ||
| 48 | |||
| 49 | Ce modèle servira de base de travail : | ||
| 50 | |||
| 51 | * il contient déjà la structure XML correcte, | ||
| 52 | * il est rattaché à la bonne source et à la bonne table, | ||
| 53 | * il respecte les règles de syntaxe attendues par Flora. | ||
| 54 | |||
| 55 | 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. | ||
| 56 | |||
| 57 | == Dupliquer un modèle standard == | ||
| 58 | |||
| 59 | === Accéder aux modèles standards === | ||
| 60 | |||
| 61 | 1. Aller dans **Espace de travail → Administration** | ||
| 62 | 1. Ouvrir le menu **Paramétrage** | ||
| 63 | 1. Cliquer sur **Modèles (exports & impr.)** | ||
| |
7.1 | 64 | 1. Une arborescence s'affiche |
| 65 | 1. Déplier le dossier **Modèles standards ETP** en cliquant sur le + à gauche | ||
| 66 | 1. Déplier le dossier **musee **(même principe, via le **+**). | ||
| |
5.1 | 67 | 1. La liste des modèles disponibles s’affiche alors à l’écran |
| 68 | 1. Repérer un modèle à dupliquer | ||
| 69 | |||
| 70 | (% class="box warningmessage" %) | ||
| 71 | ((( | ||
| 72 | 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…). | ||
| 73 | ))) | ||
| |
7.1 | 74 | |
| 75 | [[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"]] | ||
| 76 | |||
| |
8.1 | 77 | |
| 78 | === Dupliquer le modèle === | ||
| 79 | |||
| 80 | 1. **Cliquer sur le modèle** pour le sélectionner | ||
| 81 | 1. Cliquer sur l’icône **ciseaux** afin de le copier | ||
| 82 | 1. Dans l’arborescence, ouvrir le dossier **Mes modèles**. | ||
| 83 | 1. Se positionner sur ce dossier. | ||
| 84 | 1. Cliquer sur l’icône **Dupliquer** pour coller le modèle dans //Mes modèles//. | ||
| 85 | |||
| |
9.1 | 86 | [[Copier le modèle standard>>image:1772448040958-862.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] |
| 87 | |||
| |
10.1 | 88 | |
| |
9.1 | 89 | [[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"]] |
| 90 | |||
| |
10.1 | 91 | |
| 92 | === Renommer le nouveau modèle === | ||
| 93 | |||
| 94 | Après duplication, il est indispensable de **renommer le nouveau modèle** afin de l’identifier clairement comme un export personnalisé. | ||
| 95 | |||
| 96 | Pour cela : | ||
| 97 | |||
| 98 | 1. Cliquer sur le modèle copié dans le dossier **Mes modèles** pour le sélectionner | ||
| 99 | 1. Cliquer sur l’icône **Renommer** (icône crayon) | ||
| 100 | 1. Saisir un nouveau nom | ||
| 101 | 1. Cliquer sur Ok | ||
| 102 | |||
| 103 | (% class="box warningmessage" %) | ||
| 104 | ((( | ||
| 105 | 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. | ||
| |
5.1 | 106 | ))) |
| |
10.1 | 107 | |
| |
11.1 | 108 | [[Renommer le modèle personnalisé>>image:1772449421784-403.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] |
| |
10.1 | 109 | |
| |
12.1 | 110 | |
| 111 | == Comprendre la structure du fichier de configuration == | ||
| 112 | |||
| 113 | Le modèle d’export ETP repose sur un **fichier de configuration structuré en XML**. | ||
| 114 | Chaque ligne du fichier correspond à un élément exporté dans le fichier final (Excel ou CSV). | ||
| 115 | |||
| 116 | Il existe deux grandes structures : | ||
| 117 | |||
| 118 | * les **champs simples** (<field>), | ||
| 119 | * les **blocs duplicables** (<group_field>). | ||
| 120 | |||
| |
14.1 | 121 | Comprendre cette structure est essentiel pour personnaliser efficacement vos exports et produire des fichiers parfaitement adaptés à vos besoins métier. |
| 122 | |||
| |
12.1 | 123 | === Les champs simples : une colonne ~= un champ === |
| 124 | |||
| 125 | Ils sont paramétrés dans le modèle via une balise <field>. | ||
| 126 | |||
| 127 | [[Un champ simple dans le fichier de configuration>>image:1772452988186-928.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 128 | |||
| 129 | |||
| 130 | **Décomposition **: | ||
| 131 | |||
| 132 | * **name** | ||
| 133 | 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. | ||
| 134 | * **label** | ||
| 135 | Correspond à l’**intitulé de la colonne dans le fichier exporté**. C’est ce texte qui apparaîtra en en-tête dans Excel. | ||
| 136 | |||
| 137 | === Les blocs duplicables : plusieurs champs regroupés dans une seule colonne === | ||
| 138 | |||
| 139 | Certains blocs de champs dans Flora sont **répétables** (ex. : autres numéros, matières, auteurs…). | ||
| 140 | Ils sont paramétrés dans le modèle via une balise <group_field>. | ||
| 141 | |||
| |
13.1 | 142 | [[Un bloc duplicable dans le fichier de configuration>>image:1772453138263-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] |
| 143 | |||
| 144 | |||
| 145 | **Décomposition :** | ||
| 146 | |||
| 147 | * **group_field name** | ||
| 148 | Nom informatique du bloc exporté. | ||
| 149 | * **label** | ||
| 150 | Intitulé de la colonne dans l’export. | ||
| 151 | * Les <field name> internes | ||
| 152 | Champs regroupés à l’intérieur du bloc. | ||
| 153 | |||
| 154 | Un <group_field> génère **une seule colonne dans l’export**, même si plusieurs champs internes sont concaténés. | ||
| 155 | |||
| 156 | == Personnaliser le modèle d'export == | ||
| 157 | |||
| |
14.1 | 158 | Une fois le modèle dupliqué et renommé, vous pouvez en modifier le contenu directement dans l’éditeur XML. |
| |
13.1 | 159 | |
| |
14.1 | 160 | La personnalisation consiste à intervenir sur les balises : |
| 161 | |||
| 162 | * <field> pour les champs simples | ||
| 163 | * <group_field> pour les blocs répétables | ||
| 164 | |||
| 165 | Chaque modification impacte directement la structure du fichier exporté. | ||
| 166 | |||
| 167 | (% class="box successmessage" %) | ||
| 168 | ((( | ||
| 169 | **Bonnes pratiques :** | ||
| 170 | |||
| 171 | * Le **nom informatique (name)** doit correspondre exactement au champ existant dans la table concernée. | ||
| 172 | * Les **apostrophes sont interdites dans les labels**. | ||
| 173 | * Ne pas modifier la structure générale des balises. | ||
| 174 | * Toujours travailler sur un modèle dupliqué situé dans **Mes modèles**. | ||
| |
10.1 | 175 | ))) |
| |
14.1 | 176 | |
| 177 | === Retirer une colonne de l'export === | ||
| 178 | |||
| 179 | Si vous ne souhaitez plus faire apparaître un champ dans le fichier exporté : | ||
| 180 | |||
| 181 | 1. ((( | ||
| 182 | Repérer la ligne correspondant au champ : | ||
| 183 | ))) | ||
| 184 | 1. Supprimer entièrement la ligne. | ||
| 185 | 1. Enregistrer le modèle. | ||
| 186 | |||
| 187 | La colonne correspondante disparaîtra du fichier exporté. | ||
| 188 | |||
| 189 | Si le champ se trouve dans un <group_field>, vous pouvez : | ||
| 190 | |||
| 191 | * supprimer uniquement le champ concerné, | ||
| 192 | * ou supprimer l’ensemble du bloc si vous ne souhaitez plus exporter ce regroupement. | ||
| 193 | |||
| 194 | [[Suppression d'une ligne>>image:1772454434767-760.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 195 | |||
| 196 | === Intégrer un nouveau champ dans le modèle === | ||
| 197 | |||
| 198 | Pour ajouter une nouvelle colonne : | ||
| 199 | |||
| 200 | 1. Copier une ligne <field> existante. | ||
| 201 | 1. La coller à l’endroit souhaité dans le fichier. | ||
| 202 | 1. ((( | ||
| 203 | Modifier : | ||
| 204 | |||
| 205 | * name → nom informatique exact du champ, | ||
| 206 | * label → intitulé de la colonne. | ||
| 207 | ))) | ||
| 208 | 1. Enregistrer. | ||
| 209 | |||
| 210 | Une nouvelle colonne apparaîtra dans l’export. | ||
| 211 | |||
| 212 | (% class="box warningmessage" %) | ||
| 213 | ((( | ||
| 214 | **Attention : Le nom informatique doit correspondre exactement à un champ existant dans la table sélectionnée.** | ||
| 215 | ))) | ||
| 216 | |||
| 217 | [[Ajout d'une ligne <field~>>>image:1772454482299-412.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 218 | |||
| 219 | === Réorganiser la position des colonnes === | ||
| 220 | |||
| 221 | L’ordre des balises dans le fichier XML détermine l’ordre des colonnes dans l’export. | ||
| 222 | |||
| 223 | Pour modifier cet ordre : | ||
| 224 | |||
| 225 | 1. Sélectionner la ligne du champ concerné. | ||
| 226 | 1. La déplacer à l’endroit souhaité dans la structure. | ||
| 227 | 1. Enregistrer le modèle. | ||
| 228 | |||
| 229 | La colonne sera repositionnée dans le fichier exporté. | ||
| 230 | |||
| 231 | [[Déplacer une ligne <field~>>>image:1772454528400-149.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 232 | |||
| 233 | === Modifier l’intitulé d’une colonne exportée === | ||
| 234 | |||
| 235 | L’en-tête visible dans le fichier correspond à l’attribut label. | ||
| 236 | |||
| 237 | Pour modifier l’intitulé : | ||
| 238 | |||
| 239 | 1. Modifier uniquement le texte du label. | ||
| 240 | 1. Enregistrer le modèle. | ||
| 241 | |||
| 242 | Seul le titre de la colonne change. La donnée extraite reste identique. | ||
| 243 | |||
| 244 | (% class="box warningmessage" %) | ||
| 245 | ((( | ||
| 246 | **Attention : | ||
| 247 | Les apostrophes sont interdites dans les labels.** | ||
| 248 | Ne pas modifier l’attribut name, sauf si vous souhaitez changer le champ exporté. | ||
| 249 | ))) | ||
| 250 | |||
| 251 | [[Modification d'un label>>image:1772454571706-735.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| |
15.1 | 252 | |
| 253 | |||
| 254 | == Déclarer le modèle d'export == | ||
| 255 | |||
| |
16.1 | 256 | 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**. |
| 257 | |||
| 258 | Cette étape permet d’associer : | ||
| 259 | |||
| 260 | * le fichier paramétré, | ||
| 261 | * une source et une table, | ||
| 262 | * un nom visible par les utilisateurs, | ||
| 263 | * des droits d’accès. | ||
| 264 | |||
| 265 | === Rechercher les modèles d'exports ETP === | ||
| 266 | |||
| 267 | Pour accéder à la table des modèles : | ||
| 268 | |||
| 269 | 1. Aller dans **Espace de travail → Administration** | ||
| 270 | 1. Ouvrir le menu **Données** | ||
| 271 | 1. Cliquer sur **Recherche** | ||
| 272 | |||
| 273 | Dans l’écran de recherche : | ||
| 274 | |||
| 275 | 1. Choisir la **source : Données système** | ||
| 276 | 1. Choisir la **table : Modèle de publication** | ||
| 277 | 1. ((( | ||
| 278 | Lancer une recherche avec : | ||
| 279 | |||
| 280 | * **Index : Catégorie** | ||
| 281 | * **Critère : Export tabulé** | ||
| |
14.1 | 282 | ))) |
| |
16.1 | 283 | |
| 284 | Lancer la recherche. | ||
| 285 | |||
| 286 | Vous arrivez sur la liste des exports ETP déjà déclarés dans le système. | ||
| 287 | |||
| 288 | [[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"]] | ||
| 289 | |||
| 290 | [[Recherche sur la catégorie Export tabulé>>image:1772456112818-791.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 291 | |||
| 292 | === Dupliquer un modèle existant === | ||
| 293 | |||
| 294 | Pour créer la déclaration de votre nouvel export : | ||
| 295 | |||
| 296 | 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)// | ||
| 297 | 1. Cliquer sur l’icône **Dupliquer** | ||
| 298 | |||
| 299 | Une nouvelle notice est créée à partir du modèle sélectionné. | ||
| 300 | |||
| |
17.1 | 301 | [[Liste des notices des modèles d'export>>image:1772456183014-961.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] |
| 302 | |||
| 303 | [[Dupliquer une notice>>image:1772456234332-547.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| 304 | |||
| |
16.1 | 305 | === Renseigner la notice dupliquée === |
| 306 | |||
| |
17.1 | 307 | Compléter soigneusement les champs suivants en choisissant la **grille de saisie //Export ETP//** : |
| |
16.1 | 308 | |
| 309 | * **Nom du modèle** | ||
| 310 | ** Doit obligatoirement commencer par **S_** | ||
| 311 | ** Sert d’identifiant technique | ||
| 312 | |||
| 313 | |||
| 314 | |||
| 315 | * **Libellé du rapport** | ||
| 316 | ** Correspond au nom visible par les utilisateurs | ||
| 317 | ** C’est ce libellé qui apparaîtra dans la liste des exports disponibles | ||
| 318 | |||
| 319 | |||
| 320 | |||
| 321 | * **Source et table d’application** | ||
| 322 | ** la **source** (Musée, Default, Archive…), | ||
| 323 | ** la **table** concernée (ex. MUS_BIEN). | ||
| 324 | |||
| 325 | (% class="box warningmessage" %) | ||
| 326 | ((( | ||
| 327 | Elles doivent correspondre exactement à la table utilisée dans le fichier paramétré. | ||
| 328 | ))) | ||
| 329 | |||
| 330 | * **Droits d’accès** | ||
| 331 | ** Sélectionner les **rôles** autorisés à utiliser cet export. | ||
| 332 | ** Seuls les utilisateurs rattachés à ces rôles verront le modèle dans la liste. | ||
| 333 | |||
| 334 | |||
| 335 | |||
| 336 | * **Modèle de fusion** | ||
| 337 | |||
| 338 | 1. Cliquer sur l’icône **dossier** située à droite du champ. | ||
| 339 | 1. Parcourir l’arborescence. | ||
| 340 | 1. Sélectionner le modèle XML personnalisé précédemment paramétré (dans //Mes modèles//). | ||
| 341 | |||
| 342 | Cela permet d’associer la notice déclarative au fichier de paramétrage.Enregistrer | ||
| 343 | |||
| 344 | |||
| |
17.1 | 345 | Puis** enregistrer** la notice. |
| |
16.1 | 346 | |
| 347 | L’export est désormais déclaré et disponible pour les utilisateurs autorisés. | ||
| |
17.1 | 348 | |
| 349 | [[Notice dupliquée à renseigner>>image:1772456297063-101.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] | ||
| |
16.1 | 350 | ))) |
| |
19.1 | 351 | )))|(% style="width:300px" %)((( |
| 352 | (% class="box" %) | ||
| |
15.1 | 353 | ((( |
| 354 | **Sommaire** | ||
| |
4.1 | 355 | |
| |
15.1 | 356 | {{toc depth="2" numbered="true"/}} |
| 357 | ))) | ||
| 358 | |||
| |
19.1 | 359 | (% class="box" %) |
| 360 | ((( | ||
| 361 | **Aller plus loin** | ||
| |
20.1 | 362 | |
| 363 | * [[Générer des documents>>doc:1_Fonctionnalités.Communiquer les données .Générer des documents.WebHome]] | ||
| 364 | * [[Comprendre les sources et les tables dans Flora>>doc:2_Administration.Administration fonctionnelle.Présentation des sources et des tables.WebHome]] | ||
| |
19.1 | 365 | ))) |
| 366 | |||
| 367 | (% class="box" %) | ||
| 368 | ((( | ||
| |
20.1 | 369 | **Icônes principales** |
| 370 | |||
| 371 | * [[image:1753106455706-977.png]] : Copier | ||
| 372 | |||
| 373 | |||
| 374 | |||
| 375 | * [[image:1753108579445-945.png]] : Dupliquer | ||
| 376 | |||
| 377 | |||
| 378 | |||
| 379 | * [[image:1753106171963-656.png]] : Renommer | ||
| |
19.1 | 380 | ))) |
| 381 | ))) | ||
| 382 | |||
| 383 |