Code source wiki de Modifier par lot

Version 3.1 par Joséphine Ducruet le 2025/08/27 10:25

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