Code source wiki de Modifier par lot

Version 7.1 par Joséphine Ducruet le 2025/08/27 10:40

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
Joséphine Ducruet 7.1 76 === Option Forcer ===
Joséphine Ducruet 3.1 77
78 Cocher la case **Forcer** permet de ne pas spécifier de valeur recherchée : toutes les notices sélectionnées seront modifiées.
79
Joséphine Ducruet 6.1 80 >(% class="small" %)**Exemple :**Notice A : Dénomination = //table//
81
82 >(% class="small" %)Notice B : Dénomination = //tabouret//
83
84 >(% class="small" %)**Action : Remplacer Dénomination → Nouvelle valeur = //chaise// + Forcer coché**
85
86 >(% class="small" %)**Résultat :**
87
88 >(% class="small" %)Notice A : Dénomination = //chaise//
89
90 >(% class="small" %)Notice B : Dénomination = //chaise//
Joséphine Ducruet 7.1 91
92 (% class="box successmessage" %)
93 (((
94 **À retenir :**
95
96 * L’option **Forcer** écrase sans distinction toutes les valeurs présentes dans le champ sélectionné.
97 * Elle est **particulièrement utile** lorsque les notices sélectionnées comportent **des valeurs différentes** dans le champ à modifier, mais que l’on souhaite toutes les uniformiser avec une même donnée.
98 * C’est une action **radicale** à réserver aux cas où toutes les notices doivent avoir exactement la même donnée.
99 )))
100
101 === Options de remplacement ===
102
103 Ces options permettent d’affiner le comportement du remplacement. Elles apparaissent juste en dessous du champ //Nouvelle valeur//.
104
105 (% class="box warningmessage" %)
106 (((
107 **Important** : ces options ne concernent que les champs en **texte libre**.
108 Ne les utilisez pas sur les champs de type **liens, thésaurus ou listes**, car cela peut provoquer des pertes de données.
109 Si vous avez un doute, laissez les réglages par défaut : **Champ entier** + **Occurrence**.
110 )))
111
112 ==== Chercher ====
113
114 Cette option permet de **préciser le niveau de recherche de la valeur à remplacer**, selon qu’il s’agit d’une simple séquence de caractères, d’un mot complet ou de l’intégralité du champ.
115
116 * **Caractère** → recherche une simple suite de caractères.
117
118 >(% class="small" %)//Exemple (Précision sur la description)// :valeur = « peinture sur **toile boisée** »
119
120 >(% class="small" %)Chercher = Caractère boi → remplace par métal
121
122 >(% class="small" %)Résultat → « peinture sur toile **métal**sée »
123
124
125
Joséphine Ducruet 3.1 126 )))|(% style="width:300px" %)
127
128
129
admin admin 1.1 130 = Modification globale =
131
132 Une fois arrivé sur l'interface de modification globale plusieurs fonctionnalités de modifications sont disponibles :
133
134 - Remplacer
135
136 - Ajouter
137
138 - Supprimer un champ
139
140 - Echange
141
142 - Supprimer les notices
143
144 == Remplacer ==
145
146 (% id="HStandard-2" %)
147 La fonctionnalité remplacer permet de remplacer la valeur d'un champ par une autre valeur.
148
149 //Par exemple, dans une notice bien, remplacer la dénomination table par la dénomination chaise.//
150
151 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.
152
153 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é.
154
155 Renseigner ensuite la valeur recherchée et la nouvelle valeur souhaitée.
156
Doriane Bautista 2.1 157 [[image:1717772769570-868.png||data-xwiki-image-style-alignment="center" height="557" width="1155" class="img-thumbnail"]]
admin admin 1.1 158
159 (% class="wikigeneratedid" %)
160 Lancer le test permet de vérifier que la modification globale va fonctionner.
161
162 (% class="box warningmessage" %)
163 (((
164 Attention Lancer le test ne permet pas de visualiser le résultat.
165 )))
166
167 (% class="wikigeneratedid" %)
168 Lancer le traitement lancera la modification des notices.
169
170 === Forcer ===
171
172 (% class="wikigeneratedid" %)
173 Cocher la case "Forcer" permet de ne pas spécifier de valeurs à rechercher. Toutes les notices sélectionnées seront modifiées.
174
175 //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.//
176
177 === Options ===
178
179 Des options peuvent s'appliquer pour effectuer des remplacements. Elles sont disponibles en dessous de la nouvelle valeur.
180
Doriane Bautista 2.1 181 [[image:1717773756783-200.png||data-xwiki-image-style-alignment="center" height="520" width="1066" class="img-thumbnail"]]
admin admin 1.1 182
183 (% class="box warningmessage" %)
184 (((
185 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.
186 Il convient alors de laisser les options cochées par défaut : champ entier et occurence.
187 )))
188
189 ==== Chercher ====
190
191 Les options de la colonne Chercher permettent de préciser le niveau de recherche de la valeur à remplacer.
192
193 - Caractère : la recherche se fera uniquement sur une suite de caractères
194
195 - Mot entier : la recherche se fera sur le mot entier
196
197 - Champ entier : la recherche se fera sur le champ entier
198
199 Par exemple, sur le texte Lorem Ipsum :
200
201 //La recherche sur caractères « sum » ne prendra en compte que Lorem ip**SUM**//
202
203 //La recherche sur mot entier de « ipsum » ne prendra en compte que Lorem **IPSUM**//
204
205 //La recherche sur champ entier « Lorem ipsum» prendra en compte le texte entier **LOREM IPSUM**//
206
207 ==== Emplacement ====
208
209 Les options de la colonne Emplacement permettent de spécifier le remplacement de la valeur du champ.
210
211 - Occurrence : l’occurrence recherchée est remplacée
212
213 - Champ entier : Le champ entier est remplacé (quel que soit l’occurrence recherchée)
214
215 - Début de champ : La nouvelle valeur est ajoutée au début du champ
216
217 - Fin de champ : La nouvelle valeur est ajoutée à la fin du champ
218
219 Ces options sont à combiner avec les options précédentes de la colonne Chercher.
220
221 //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 ~://
222
223 |Option Chercher|Option Emplacement|Résultat
224 |Caractère|Occurence|Lorem iphone
225 |Caractère|Champ entier|hone
226 |Caractère|Début du champ|honeLorem ipsum
227 |Caractère|Fin du champ|Lorem ipsumhone
228
229 //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 ~://
230
231 |Option Chercher|Option Emplacement|Résultat
232 |Mot entier|Occurence|Lorem dolor
233 |Mot entier|Champ entier|dolor
234 |Mot entier|Début du champ|dolorLorem ipsum
235 |Mot entier|Fin du champ|Lorem ipsumsdolor
236
237 (% class="box warningmessage" %)
238 (((
239 Attention cela ne fonctionnera pas si vous indiquez des caractères et non des mots entiers.
240 //Par exemple remplacer « sum » par « dolor » en cochant l’option mot entier.//
241 )))
242
243 //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 ~://
244
245 |Option Chercher|Option Emplacement|Résultat
246 |Champ entier|Occurence|dolor
247 |Champ entier|Champ entier|dolor
248 |Champ entier|Début du champ|dolorLorem ipsum
249 |Champ entier|Fin du champ|Lorem ipsumsdolor
250
251 (% class="box warningmessage" %)
252 (((
253 Attention cela ne fonctionnera pas si vous indiquez des caractères ou des mots entiers à la place du champ entier.
254 //Par exemple remplacer « sum » par « dolor » ou remplacer « ipsum » par « dolor » en cochant champ entier.//
255 )))
256
257 ==== Options supplémentaires ====
258
259 - 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.
260
261 //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.//
262
263 - 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.
264
265 //Par exemple, mon champ contient Lorem ipsum ipsum, je souhaite remplacer tous les « sum » par « hone ».//
266
267 //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.//
268
269 //Alors qu’en cochant l’option les deux « sum » seront remplacés ce qui donnera Lorem iphone iphone.//
270
271
272 == Ajouter ==
273
274
275 La fonctionnalité ajouter permet d'ajouter une valeur dans un champ.
276
277 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.
278
279 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é.
280
281 Renseigner ensuite la nouvelle valeur souhaitée.
282
Doriane Bautista 2.1 283 [[image:1718002712583-345.png||data-xwiki-image-style-alignment="center" height="470" width="924"]]
admin admin 1.1 284
285 (% class="wikigeneratedid" %)
286 Lancer le test permet de vérifier que la modification globale va fonctionner.
287
288 (% class="box warningmessage" %)
289 (((
290 Attention Lancer le test ne permet pas de visualiser le résultat.
291 )))
292
293 (% class="wikigeneratedid" %)
294 Lancer le traitement lancera la modification des notices.
295
296
297 === Ajouter au champ parent existant ===
298
299
300 (% class="reference" %)
301 L'option ajouter au champ parent existant permet d'ajouter la valeur à un champ déjà existant dans la notice.
302
Doriane Bautista 2.1 303 [[image:1718004841774-374.png||data-xwiki-image-style-alignment="center" height="277" width="926" class="img-thumbnail"]]
admin admin 1.1 304
305 (% class="reference" %)
306 Plusieurs cas de figure peuvent se présenter :
307
308 (% class="reference" %)
309 - Le champ accepte une valeur unique et n'est pas renseigné: la valeur est ajoutée
310
311 (% class="reference" %)
312 - Le champ accepte une valeur unique et est déjà renseigné : l'ajout de de valeur n'a aucun effet
313
314 (% class="reference" %)
315 - Le champ est multivalué et n'est pas renseigné : la valeur est ajoutée
316
317 (% class="reference" %)
318 - Le champ est multivalué et est déjà renseigné : la nouvelle valeur vient compléter celles déjà existantes
319
320
Doriane Bautista 2.1 321 (% id="HCrE9erunnouveauchampparent" class="reference" %)
admin admin 1.1 322 === Créer un nouveau champ parent ===
323
324
325 (% class="reference" %)
326 Cette option permet de dupliquer le champ afin d'ajouter la nouvelle valeur.
327
328 (% class="box warningmessage" %)
329 (((
330 Attention cette option ne fonctionne qu'avec les champs duplicables.
331 )))
332
Doriane Bautista 2.1 333 [[image:1718005071968-162.png||data-xwiki-image-style-alignment="center" height="479" width="966" class="img-thumbnail"]]
admin admin 1.1 334
335 == Supprimer un champ ==
336
337
338 La fonctionnalité supprimer un champ permet de supprimer une valeur d'un champ.
339
340 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.
341
342 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é.
343
344 Renseigner ensuite la valeur recherchée et qui est à supprimer.
345
Doriane Bautista 2.1 346 [[image:1718005707106-758.png||data-xwiki-image-style-alignment="center" height="497" width="1060" class="img-thumbnail"]]
admin admin 1.1 347
348 (% class="wikigeneratedid" %)
349 Lancer le test permet de vérifier que la modification globale va fonctionner.
350
351 (% class="box warningmessage" %)
352 (((
353 Attention Lancer le test ne permet pas de visualiser le résultat.
354 )))
355
356 (% class="wikigeneratedid" %)
357 Lancer le traitement lancera la modification des notices.
358
359 (% class="box warningmessage" id="HOptions-1" %)
360 (((
361 Attention les options de recherche ne fonctionnent pas pour la suppression d'un champ.
362 Quelque soit l'option cochée, le champ contenant la valeur recherchée sera entièrement supprimée.
363 )))
364
365 == Echange ==
366
367
368 La fonctionnalité échange permet d'échanger une autorité avec une autre autorité.
369
370 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.
371
372 La table liée permet de renseigner la table d'autorité concernée par l'échange.
373
374 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é.
375
376 Renseigner ensuite la valeur recherchée à remplacer et la nouvelle valeur souhaitée.
377
378 //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.//
379
Doriane Bautista 2.1 380 [[image:1718007194775-136.png||data-xwiki-image-style-alignment="center" height="420" width="1381" class="img-thumbnail"]]
admin admin 1.1 381
382 (% class="wikigeneratedid" %)
383 Lancer le test permet de vérifier que la modification globale va fonctionner.
384
385 (% class="box warningmessage" %)
386 (((
387 Attention Lancer le test ne permet pas de visualiser le résultat.
388 )))
389
390 (% class="wikigeneratedid" %)
391 Lancer le traitement lancera la modification des notices.
392
393 == Supprimer les notices ==
394
395 (% id="HStandard-6" %)
396 La fonctionnalité supprimer les notices permet de supprimer l'ensemble des notices sélectionnées.
397
398 (% class="box warningmessage" %)
399 (((
400 Attention toutes suppressions de notices est irréversibles.
401 )))
402
Doriane Bautista 2.1 403 [[image:1718007555125-860.png||data-xwiki-image-style-alignment="center" height="220" width="1273" class="img-thumbnail"]]
admin admin 1.1 404
405 Lancer le test permet de vérifier que la suppression va fonctionner.
406
407 (% class="box warningmessage" %)
408 (((
409 Attention Lancer le test ne permet pas de visualiser le résultat.
410 )))
411
412 Lancer le traitement lancera la suppression des notices.
413
414 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é.
415
416 = Lancer le traitement =
417
418
419 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.
420
421 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.
422
Doriane Bautista 2.1 423 [[image:1718007767433-901.png||data-xwiki-image-style-alignment="center" height="554" width="1184" class="img-thumbnail"]]
admin admin 1.1 424
425 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.
426
Doriane Bautista 2.1 427 [[image:1718007797909-766.png||data-xwiki-image-style-alignment="center" height="552" width="1177" class="img-thumbnail"]]
admin admin 1.1 428
429 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.)
430
Doriane Bautista 2.1 431 [[image:1718007901694-625.png||data-xwiki-image-style-alignment="center" height="375" width="1174" class="img-thumbnail"]]
admin admin 1.1 432
433 (% class="box warningmessage" %)
434 (((
435 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.
436 )))
437
438 Une fois la modification paramétrée et testée, deux possibilités sont offertes pour lancer le traitement effectif :
439
440 * A partir de l'écran de résultat de test (étape précédente) : cliquez sur Appliquer.
441 * A partir d'un des écrans de paramétrage de la modification globale : cliquez sur Lancer le traitement.
442
443 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.
444
445
446 Une fois le test ou le traitement terminé, trois boutons se présentent en haut de la page :
447
448 [[image:1718007993541-975.png]]retour au formulaire de recherche
449
450 [[image:1718008006027-949.png]]retour à la liste résultat
451
452 [[image:1718008017305-150.png]] télécharger les rapports.
453
454 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é.
455
Doriane Bautista 2.1 456 [[image:1718008058300-626.png||data-xwiki-image-style-alignment="center" height="333" width="389" class="img-thumbnail"]]
admin admin 1.1 457
458 (% class="imgpara" %)
459 Le fichier zip contient trois fichiers correspondant aux trois zones d'informations décrites ci-dessous.
460
461 (% class="imgpara" %)
462 Les noms de fichier sont composés :
463
464 * du code de l’action
465 * global_replace = Remplacement
466 * global_add = Ajout
467 * global_remove = Suppression de champ
468 * global_exchange = Echange d'autorité
469 * global_notice_delete = Suppression de notice
470 * CommitBatch = traitement effectif,
471 * du code de l’utilisateur connecté,
472 * de la date d’exécution de la modification,
473 * du type d'information
474 * err = erreurs rencontrées (contenu de la troisième partie de la page)
475 * out = liste de fiches impactées (contenu de la deuxième partie de la page)
476 * summary = récapitulatif (affiché dans la première partie de la page)