Code source wiki de Modifier par lot

Version 5.1 par Joséphine Ducruet le 2025/08/27 10:28

Masquer les derniers auteurs
Joséphine Ducruet 3.1 1 (% class="mark small" %)**Version 3.5 et ultérieures**
admin admin 1.1 2
Joséphine Ducruet 3.1 3 |(% style="width:840px" %)(((
4 = Points clés avant de se lancer =
admin admin 1.1 5
Joséphine Ducruet 3.1 6 La **modification globale (ou par lot)** est réservée aux professionnels habilités.
7 Elle permet de mettre à jour, en temps réel, un ensemble de notices issues d’une recherche, selon différents axes :
admin admin 1.1 8
Joséphine Ducruet 3.1 9 * remplacer partiellement ou totalement la valeur d’un champ,
10 * ajouter une valeur,
11 * supprimer le contenu d’un champ,
12 * échanger des autorités,
13 * supprimer des notices.
admin admin 1.1 14
15 (% class="box warningmessage" %)
16 (((
Joséphine Ducruet 3.1 17 **Attention** : une fois validées, les modifications sont irréversibles.
admin admin 1.1 18 )))
19
Joséphine Ducruet 3.1 20 (% class="box successmessage" %)
admin admin 1.1 21 (((
Joséphine Ducruet 3.1 22 **Bonnes pratiques :**
23
24 * **Toujours tester sur la base de formation** avant d’appliquer en production.
25 * Planifier les **grosses modifications en fin de journée**, lorsque les autres utilisateurs ne sont pas connectés, afin d’éviter les ralentissements.
admin admin 1.1 26 )))
27
Joséphine Ducruet 3.1 28 = Rechercher les notices à modifier =
admin admin 1.1 29
Joséphine Ducruet 3.1 30 Deux modes d’accès sont possibles (selon vos droits) :
admin admin 1.1 31
Joséphine Ducruet 3.1 32 == Depuis l’Administration ==
admin admin 1.1 33
Joséphine Ducruet 3.1 34 1. Espace de travail //Administration// → Menu **Données / Modification globale**.
35 1. Sélectionner la source, puis la table concernée.
36 1. Choisir l'index de recherche
37 1. Définir les critères de recherche.
admin admin 1.1 38
Joséphine Ducruet 3.1 39 [[Accès à la modification globale depuis l'administration>>image:1717771048889-896.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
admin admin 1.1 40
41
Joséphine Ducruet 3.1 42 [[Interface de recherche de la modification globale>>image:1717771513301-161.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
admin admin 1.1 43
Joséphine Ducruet 3.1 44 == Depuis une liste de résultats ==
admin admin 1.1 45
Joséphine Ducruet 3.1 46 1. À l’issue d’une recherche standard, **sélectionner les notices à modifier** (ou laisser vide pour traiter l’ensemble de la liste).
47 1. Cliquer sur le bouton de **modification par lot**.
admin admin 1.1 48
Joséphine Ducruet 3.1 49 [[Modification par lot depuis une liste de résultats>>image:1717771746741-695.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
admin admin 1.1 50
51
Joséphine Ducruet 3.1 52 [[Modification par lot sans sélection de notices>>image:1717771855009-131.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
admin admin 1.1 53
Joséphine Ducruet 4.1 54 = Les types de modifications disponibles =
admin admin 1.1 55
Joséphine Ducruet 3.1 56 == Remplacer une valeur ==
admin admin 1.1 57
Joséphine Ducruet 3.1 58 Permet de **remplacer la valeur d’un champ par une autre**.
admin admin 1.1 59
Joséphine Ducruet 3.1 60 >(% class="small" %)Ex. remplacer la dénomination //table// par //chaise//.
admin admin 1.1 61
Joséphine Ducruet 3.1 62 === Définir la valeur à remplacer ===
admin admin 1.1 63
Joséphine Ducruet 3.1 64 La **source** et la **table** sur lesquelles effectuer les modifications sont pré-remplies par défaut.
65 Il faut ensuite choisir le **champ** concerné.
admin admin 1.1 66
Joséphine Ducruet 3.1 67 Par défaut, la case **Trier par libellé** est cochée : le champ apparaît sous la forme //Libellé (nom informatique)//, ce qui permet de distinguer des champs portant le même libellé.
68
69 Il suffit enfin de renseigner :
70
71 * la **valeur recherchée**,
72 * la **nouvelle valeur** souhaitée.
73
74 [[Exemple : remplacer la dénomination table par chaise>>image:1717772769570-868.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
75
76 === Options disponibles ===
77
78 ==== Forcer ====
79
80 Cocher la case **Forcer** permet de ne pas spécifier de valeur recherchée : toutes les notices sélectionnées seront modifiées.
81
Joséphine Ducruet 5.1 82 >(% class="small" %)**Exemple :**Notice A : Dénomination = //table//Notice B : Dénomination = //tabouret//Notice C : Dénomination = //buffet//Action : Remplacer Dénomination → Nouvelle valeur = //chaise// + **Forcer** cochéRésultat :Notice A : Dénomination = //chaise//Notice B : Dénomination = //chaise//Notice C : Dénomination = //chaise//
Joséphine Ducruet 3.1 83 )))|(% style="width:300px" %)
84
85
86
admin admin 1.1 87 = Modification globale =
88
89 Une fois arrivé sur l'interface de modification globale plusieurs fonctionnalités de modifications sont disponibles :
90
91 - Remplacer
92
93 - Ajouter
94
95 - Supprimer un champ
96
97 - Echange
98
99 - Supprimer les notices
100
101 == Remplacer ==
102
103 (% id="HStandard-2" %)
104 La fonctionnalité remplacer permet de remplacer la valeur d'un champ par une autre valeur.
105
106 //Par exemple, dans une notice bien, remplacer la dénomination table par la dénomination chaise.//
107
108 La source et la table sur lesquelles effectuer les modifications sont remplis par défaut. Il faut alors choisir le champ sur lequel la modification est souhaitée.
109
110 Par défaut la case "Trier par libellé" est cochée. Elle permet de faire apparaitre le libellé du champ suivi de son nom informatique. Cela permet de différencier des champs qui ont potentiellement le même libellé.
111
112 Renseigner ensuite la valeur recherchée et la nouvelle valeur souhaitée.
113
Doriane Bautista 2.1 114 [[image:1717772769570-868.png||data-xwiki-image-style-alignment="center" height="557" width="1155" class="img-thumbnail"]]
admin admin 1.1 115
116 (% class="wikigeneratedid" %)
117 Lancer le test permet de vérifier que la modification globale va fonctionner.
118
119 (% class="box warningmessage" %)
120 (((
121 Attention Lancer le test ne permet pas de visualiser le résultat.
122 )))
123
124 (% class="wikigeneratedid" %)
125 Lancer le traitement lancera la modification des notices.
126
127 === Forcer ===
128
129 (% class="wikigeneratedid" %)
130 Cocher la case "Forcer" permet de ne pas spécifier de valeurs à rechercher. Toutes les notices sélectionnées seront modifiées.
131
132 //Par exemple, une notice avec une dénomination table et une autre avec une dénomination tabouret seront toutes les deux modifiées pour avoir la dénomination chaise.//
133
134 === Options ===
135
136 Des options peuvent s'appliquer pour effectuer des remplacements. Elles sont disponibles en dessous de la nouvelle valeur.
137
Doriane Bautista 2.1 138 [[image:1717773756783-200.png||data-xwiki-image-style-alignment="center" height="520" width="1066" class="img-thumbnail"]]
admin admin 1.1 139
140 (% class="box warningmessage" %)
141 (((
142 Attention ces options ne sont disponibles que pour des remplacements sur des champs en texte libre. Les modifications effectuées avec ces options sur des champs de type liens, thésaurus ou liste peuvent entrainer des pertes de données.
143 Il convient alors de laisser les options cochées par défaut : champ entier et occurence.
144 )))
145
146 ==== Chercher ====
147
148 Les options de la colonne Chercher permettent de préciser le niveau de recherche de la valeur à remplacer.
149
150 - Caractère : la recherche se fera uniquement sur une suite de caractères
151
152 - Mot entier : la recherche se fera sur le mot entier
153
154 - Champ entier : la recherche se fera sur le champ entier
155
156 Par exemple, sur le texte Lorem Ipsum :
157
158 //La recherche sur caractères « sum » ne prendra en compte que Lorem ip**SUM**//
159
160 //La recherche sur mot entier de « ipsum » ne prendra en compte que Lorem **IPSUM**//
161
162 //La recherche sur champ entier « Lorem ipsum» prendra en compte le texte entier **LOREM IPSUM**//
163
164 ==== Emplacement ====
165
166 Les options de la colonne Emplacement permettent de spécifier le remplacement de la valeur du champ.
167
168 - Occurrence : l’occurrence recherchée est remplacée
169
170 - Champ entier : Le champ entier est remplacé (quel que soit l’occurrence recherchée)
171
172 - Début de champ : La nouvelle valeur est ajoutée au début du champ
173
174 - Fin de champ : La nouvelle valeur est ajoutée à la fin du champ
175
176 Ces options sont à combiner avec les options précédentes de la colonne Chercher.
177
178 //Par exemple, toujours sur le texte Lorem ipsum si on veut remplacer les caractères « sum » par « hone » voici les résultats en fonction des combinaisons possibles ~://
179
180 |Option Chercher|Option Emplacement|Résultat
181 |Caractère|Occurence|Lorem iphone
182 |Caractère|Champ entier|hone
183 |Caractère|Début du champ|honeLorem ipsum
184 |Caractère|Fin du champ|Lorem ipsumhone
185
186 //Toujours sur le texte Lorem ipsum si on veut remplacer le mot entier « ipsum » par « dolor » voici les résultats en fonction des combinaisons possibles ~://
187
188 |Option Chercher|Option Emplacement|Résultat
189 |Mot entier|Occurence|Lorem dolor
190 |Mot entier|Champ entier|dolor
191 |Mot entier|Début du champ|dolorLorem ipsum
192 |Mot entier|Fin du champ|Lorem ipsumsdolor
193
194 (% class="box warningmessage" %)
195 (((
196 Attention cela ne fonctionnera pas si vous indiquez des caractères et non des mots entiers.
197 //Par exemple remplacer « sum » par « dolor » en cochant l’option mot entier.//
198 )))
199
200 //Toujours sur le texte Lorem ipsum, si on veut remplacer le champ entier «Lorem ipsum » par « dolor » voici les résultats en fonction des combinaisons possibles ~://
201
202 |Option Chercher|Option Emplacement|Résultat
203 |Champ entier|Occurence|dolor
204 |Champ entier|Champ entier|dolor
205 |Champ entier|Début du champ|dolorLorem ipsum
206 |Champ entier|Fin du champ|Lorem ipsumsdolor
207
208 (% class="box warningmessage" %)
209 (((
210 Attention cela ne fonctionnera pas si vous indiquez des caractères ou des mots entiers à la place du champ entier.
211 //Par exemple remplacer « sum » par « dolor » ou remplacer « ipsum » par « dolor » en cochant champ entier.//
212 )))
213
214 ==== Options supplémentaires ====
215
216 - Respecter la casse : la recherche s’appuie sur la valeur telle qu’elle est saisie, c’est-à-dire en prenant en compte les majuscules, les accents etc.
217
218 //Par exemple si je veux remplacer lorem ipsum (sans majuscule) par dolor en cochant respecter la casse alors que mon champ contient Lorem ipsum (avec majuscule) la modification ne s’effectuera pas.//
219
220 - Remplacer toutes les occurrences présentes dans la valeur : par défaut, seule la première occurrence de la valeur recherchée est remplacée. Cette option permet de remplacer toutes les occurrences.
221
222 //Par exemple, mon champ contient Lorem ipsum ipsum, je souhaite remplacer tous les « sum » par « hone ».//
223
224 //En ne cochant pas remplacer toutes les occurrences présentes dans la valeur, seul le premier « sum » sera remplacé ce qui donnera Lorem iphone ipsum.//
225
226 //Alors qu’en cochant l’option les deux « sum » seront remplacés ce qui donnera Lorem iphone iphone.//
227
228
229 == Ajouter ==
230
231
232 La fonctionnalité ajouter permet d'ajouter une valeur dans un champ.
233
234 La source et la table sur lesquelles effectuer les modifications sont remplis par défaut. Il faut alors choisir le champ sur lequel la modification est souhaitée.
235
236 Par défaut la case "Trier par libellé" est cochée. Elle permet de faire apparaitre le libellé du champ suivi de son nom informatique. Cela permet de différencier des champs qui ont potentiellement le même libellé.
237
238 Renseigner ensuite la nouvelle valeur souhaitée.
239
Doriane Bautista 2.1 240 [[image:1718002712583-345.png||data-xwiki-image-style-alignment="center" height="470" width="924"]]
admin admin 1.1 241
242 (% class="wikigeneratedid" %)
243 Lancer le test permet de vérifier que la modification globale va fonctionner.
244
245 (% class="box warningmessage" %)
246 (((
247 Attention Lancer le test ne permet pas de visualiser le résultat.
248 )))
249
250 (% class="wikigeneratedid" %)
251 Lancer le traitement lancera la modification des notices.
252
253
254 === Ajouter au champ parent existant ===
255
256
257 (% class="reference" %)
258 L'option ajouter au champ parent existant permet d'ajouter la valeur à un champ déjà existant dans la notice.
259
Doriane Bautista 2.1 260 [[image:1718004841774-374.png||data-xwiki-image-style-alignment="center" height="277" width="926" class="img-thumbnail"]]
admin admin 1.1 261
262 (% class="reference" %)
263 Plusieurs cas de figure peuvent se présenter :
264
265 (% class="reference" %)
266 - Le champ accepte une valeur unique et n'est pas renseigné: la valeur est ajoutée
267
268 (% class="reference" %)
269 - Le champ accepte une valeur unique et est déjà renseigné : l'ajout de de valeur n'a aucun effet
270
271 (% class="reference" %)
272 - Le champ est multivalué et n'est pas renseigné : la valeur est ajoutée
273
274 (% class="reference" %)
275 - Le champ est multivalué et est déjà renseigné : la nouvelle valeur vient compléter celles déjà existantes
276
277
Doriane Bautista 2.1 278 (% id="HCrE9erunnouveauchampparent" class="reference" %)
admin admin 1.1 279 === Créer un nouveau champ parent ===
280
281
282 (% class="reference" %)
283 Cette option permet de dupliquer le champ afin d'ajouter la nouvelle valeur.
284
285 (% class="box warningmessage" %)
286 (((
287 Attention cette option ne fonctionne qu'avec les champs duplicables.
288 )))
289
Doriane Bautista 2.1 290 [[image:1718005071968-162.png||data-xwiki-image-style-alignment="center" height="479" width="966" class="img-thumbnail"]]
admin admin 1.1 291
292 == Supprimer un champ ==
293
294
295 La fonctionnalité supprimer un champ permet de supprimer une valeur d'un champ.
296
297 La source et la table sur lesquelles effectuer les modifications sont remplis par défaut. Il faut alors choisir le champ sur lequel la suppression est souhaitée.
298
299 Par défaut la case "Trier par libellé" est cochée. Elle permet de faire apparaitre le libellé du champ suivi de son nom informatique. Cela permet de différencier des champs qui ont potentiellement le même libellé.
300
301 Renseigner ensuite la valeur recherchée et qui est à supprimer.
302
Doriane Bautista 2.1 303 [[image:1718005707106-758.png||data-xwiki-image-style-alignment="center" height="497" width="1060" class="img-thumbnail"]]
admin admin 1.1 304
305 (% class="wikigeneratedid" %)
306 Lancer le test permet de vérifier que la modification globale va fonctionner.
307
308 (% class="box warningmessage" %)
309 (((
310 Attention Lancer le test ne permet pas de visualiser le résultat.
311 )))
312
313 (% class="wikigeneratedid" %)
314 Lancer le traitement lancera la modification des notices.
315
316 (% class="box warningmessage" id="HOptions-1" %)
317 (((
318 Attention les options de recherche ne fonctionnent pas pour la suppression d'un champ.
319 Quelque soit l'option cochée, le champ contenant la valeur recherchée sera entièrement supprimée.
320 )))
321
322 == Echange ==
323
324
325 La fonctionnalité échange permet d'échanger une autorité avec une autre autorité.
326
327 La source et la table sur lesquelles effectuer les modifications sont remplis par défaut. Il faut alors choisir le champ sur lequel la suppression est souhaitée.
328
329 La table liée permet de renseigner la table d'autorité concernée par l'échange.
330
331 Par défaut la case "Trier par libellé" est cochée. Elle permet de faire apparaitre le libellé du champ suivi de son nom informatique. Cela permet de différencier des champs qui ont potentiellement le même libellé.
332
333 Renseigner ensuite la valeur recherchée à remplacer et la nouvelle valeur souhaitée.
334
335 //Par exemple, remplacer dans des notices bien, l'autorité personne Delacroix Eugène par Sandro Botticelli. Ainsi tous les champs des notices sélectionnées faisant appel à Delacroix Eugène feront maintenant appel à Sandro Botticelli.//
336
Doriane Bautista 2.1 337 [[image:1718007194775-136.png||data-xwiki-image-style-alignment="center" height="420" width="1381" class="img-thumbnail"]]
admin admin 1.1 338
339 (% class="wikigeneratedid" %)
340 Lancer le test permet de vérifier que la modification globale va fonctionner.
341
342 (% class="box warningmessage" %)
343 (((
344 Attention Lancer le test ne permet pas de visualiser le résultat.
345 )))
346
347 (% class="wikigeneratedid" %)
348 Lancer le traitement lancera la modification des notices.
349
350 == Supprimer les notices ==
351
352 (% id="HStandard-6" %)
353 La fonctionnalité supprimer les notices permet de supprimer l'ensemble des notices sélectionnées.
354
355 (% class="box warningmessage" %)
356 (((
357 Attention toutes suppressions de notices est irréversibles.
358 )))
359
Doriane Bautista 2.1 360 [[image:1718007555125-860.png||data-xwiki-image-style-alignment="center" height="220" width="1273" class="img-thumbnail"]]
admin admin 1.1 361
362 Lancer le test permet de vérifier que la suppression va fonctionner.
363
364 (% class="box warningmessage" %)
365 (((
366 Attention Lancer le test ne permet pas de visualiser le résultat.
367 )))
368
369 Lancer le traitement lancera la suppression des notices.
370
371 L'option Ignorer les erreurs permet de passer outre tout problème rencontré lors de la suppression. Sinon, l'opération est stoppée dès qu'un problème est rencontré.
372
373 = Lancer le traitement =
374
375
376 Une fois la modification paramétrée, cliquez sur Lancer le test pour tester le traitement (sans impact sur les données). Une page d'informations s'affiche en trois parties.
377
378 La première présente un résumé des informations de la modification. Le pourcentage de traitement réalisé apparaît en haut de l'écran.
379
Doriane Bautista 2.1 380 [[image:1718007767433-901.png||data-xwiki-image-style-alignment="center" height="554" width="1184" class="img-thumbnail"]]
admin admin 1.1 381
382 La seconde présente les informations remontées en cours de traitement ainsi que les clefs et digests des notices modifiées. En raison du nombre d’informations pouvant être remontées dans cette zone, son contenu est volatile. Si l’on quitte l’écran de modification globale et que l’on revient dessus, on ne verra plus les précédentes informations affichées. Le nombre de lignes pouvant être affiché dans cette zone est limité à 10000. Passé ce nombre, « ….. » s'affiche.
383
Doriane Bautista 2.1 384 [[image:1718007797909-766.png||data-xwiki-image-style-alignment="center" height="552" width="1177" class="img-thumbnail"]]
admin admin 1.1 385
386 La troisième zone est masquée. Elle apparaît lorsque des erreurs sont remontées. A l'inverse de la liste des enregistrements traités, les messages affichés dans cette zone restent jusque' à la fin du traitement : si l’on quitte cette page, on les retrouve lorsque l’on revient sur la modification en cours. Les erreurs sont détaillées, y compris les fiches impossibles à modifier à cause de droits insuffisants. (On peut disposer d'un droit de modification filtré, qui ne s'applique donc pas à toutes les notices d'une table.)
387
Doriane Bautista 2.1 388 [[image:1718007901694-625.png||data-xwiki-image-style-alignment="center" height="375" width="1174" class="img-thumbnail"]]
admin admin 1.1 389
390 (% class="box warningmessage" %)
391 (((
392 Il est conseillé de tester d'abord l'impact potentiel de votre modification globale, avant de lancer le traitement réel sur les données.
393 )))
394
395 Une fois la modification paramétrée et testée, deux possibilités sont offertes pour lancer le traitement effectif :
396
397 * A partir de l'écran de résultat de test (étape précédente) : cliquez sur Appliquer.
398 * A partir d'un des écrans de paramétrage de la modification globale : cliquez sur Lancer le traitement.
399
400 Une fois le traitement lancé, les informations associées s'affichent de la même manière que lors du test, sans la mention Exécution en mode test.
401
402
403 Une fois le test ou le traitement terminé, trois boutons se présentent en haut de la page :
404
405 [[image:1718007993541-975.png]]retour au formulaire de recherche
406
407 [[image:1718008006027-949.png]]retour à la liste résultat
408
409 [[image:1718008017305-150.png]] télécharger les rapports.
410
411 Ce dernier permet de récupérer les fichiers contenant la totalité des informations affichées. Il suffit de fournir le nom du fichier zip téléchargé.
412
Doriane Bautista 2.1 413 [[image:1718008058300-626.png||data-xwiki-image-style-alignment="center" height="333" width="389" class="img-thumbnail"]]
admin admin 1.1 414
415 (% class="imgpara" %)
416 Le fichier zip contient trois fichiers correspondant aux trois zones d'informations décrites ci-dessous.
417
418 (% class="imgpara" %)
419 Les noms de fichier sont composés :
420
421 * du code de l’action
422 * global_replace = Remplacement
423 * global_add = Ajout
424 * global_remove = Suppression de champ
425 * global_exchange = Echange d'autorité
426 * global_notice_delete = Suppression de notice
427 * CommitBatch = traitement effectif,
428 * du code de l’utilisateur connecté,
429 * de la date d’exécution de la modification,
430 * du type d'information
431 * err = erreurs rencontrées (contenu de la troisième partie de la page)
432 * out = liste de fiches impactées (contenu de la deuxième partie de la page)
433 * summary = récapitulatif (affiché dans la première partie de la page)