Code source wiki de Modifier par lot

Version 6.1 par Joséphine Ducruet le 2025/08/27 10:30

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