Aller au contenu

Code source wiki de Modifier par lot

Version 2.5 par Doriane Bautista le 2025/08/07 14:50
Afficher les derniers auteurs
1
2
3 {{toc/}}
4
5 La modification globale ou par lot est réservée aux professionnels habilités. Potentiellement, toutes les données de Flora peuvent être traitées par cette fonction. La modification globale permet de mettre à jour, en temps réel, un lot de fiches résultant d'une recherche, et cela selon plusieurs axes :
6
7 * modifier partiellement ou totalement la valeur d'un champ
8 * ajouter un champ
9 * supprimer le contenu d'un champ
10 * échanger des autorités
11 * supprimer les notices.
12
13 (% class="box warningmessage" %)
14 (((
15 Il est conseillé d'effectuer les modifications par lot au préalable sur la base de test pour vérifier si le résultat est celui attendu. Une fois les données modifiées il n'y a pas de retour en arrière possible.
16 )))
17
18 (% class="box warningmessage" %)
19 (((
20 Pour les grosses modifications par lot il est conseillé de les effectuer en fin de journée quand les autres utilisateurs ne sont pas connectés afin de ne pas causer de ralentissements de la base.
21 )))
22
23 = Rechercher les fiches à modifier =
24
25 La recherche des fiches à modifier peut être réalisée de deux façons (tout dépend des droits accordés à l'utilisateur) :
26
27 * par le menu Données / Modification globale de l'espace de travail Administration.
28 * directement à partir d'une liste résultat de recherche standard présentant les fiches à modifier.
29
30 (% id="HStandard" %)
31 == Accéder à l'écran de modification globale par le menu d'Administration ==
32
33 - Sélectionnez l'espace de travail Administration, puis cliquez sur le menu Données / Modification globale.
34
35 [[image:1717771048889-896.png||data-xwiki-image-style-alignment="center" height="419" width="968" class="img-thumbnail"]]
36
37
38 Sélectionner la [[source>>doc:1_Fonctionnalités.2_Administration.Administration fonctionnelle.Présentation des sources et des tables.FAQ Connaître la différence entre source et table.WebHome]] souhaitée dans la liste déroulante proposée.
39
40 La liste des tables associées à la source sélectionnée - et pour lesquelles vous avez les droits de modification - s'affiche alors dans la liste des tables. Il suffit ensuite de sélectionner la table souhaitée.
41
42 La liste des index disponibles pour cette table s'affiche alors dans la liste des index, permettant de électionner l'index souhaité.
43
44 Saisir ensuite les critères de recherche et lancer la recherche
45
46 [[image:1717771513301-161.png||data-xwiki-image-style-alignment="center" height="415" width="547" class="img-thumbnail"]]
47
48
49 (% id="HAccE9derE0l27E9crandemodificationglobaleE0partird27unelisterE9sultat" class="MsoCaption" %)
50 == Accéder à l'écran de modification globale à partir d'une liste résultat ==
51
52 Suite à une recherche standard dans Flora, les utilisateurs habilités ont accès directement à la modification globale à partir de la liste résultat, grâce au bouton [[image:1717771582485-182.png]] .
53
54 Il est possible de sélectionner les notices à modifier en les cochant puis en cliquant sur le bouton de modification par lot.
55
56 [[image:1717771746741-695.png||data-xwiki-image-style-alignment="center" height="518" width="1093" class="img-thumbnail"]]
57
58 (% class="MsoCaption" %)
59 Si aucune notice n'a été sélectionnée dans la liste, Flora propose de prendre en compte toutes les réponses.
60
61 [[image:1717771855009-131.png||data-xwiki-image-style-alignment="center" height="521" width="1088" class="img-thumbnail"]]
62
63 = Modification globale =
64
65 Une fois arrivé sur l'interface de modification globale plusieurs fonctionnalités de modifications sont disponibles :
66
67 - Remplacer
68
69 - Ajouter
70
71 - Supprimer un champ
72
73 - Echange
74
75 - Supprimer les notices
76
77 == Remplacer ==
78
79 (% id="HStandard-2" %)
80 La fonctionnalité remplacer permet de remplacer la valeur d'un champ par une autre valeur.
81
82 //Par exemple, dans une notice bien, remplacer la dénomination table par la dénomination chaise.//
83
84 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.
85
86 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é.
87
88 Renseigner ensuite la valeur recherchée et la nouvelle valeur souhaitée.
89
90 [[image:1717772769570-868.png||data-xwiki-image-style-alignment="center" height="557" width="1155" class="img-thumbnail"]]
91
92 (% class="wikigeneratedid" %)
93 Lancer le test permet de vérifier que la modification globale va fonctionner.
94
95 (% class="box warningmessage" %)
96 (((
97 Attention Lancer le test ne permet pas de visualiser le résultat.
98 )))
99
100 (% class="wikigeneratedid" %)
101 Lancer le traitement lancera la modification des notices.
102
103 === Forcer ===
104
105 (% class="wikigeneratedid" %)
106 Cocher la case "Forcer" permet de ne pas spécifier de valeurs à rechercher. Toutes les notices sélectionnées seront modifiées.
107
108 //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.//
109
110 === Options ===
111
112 Des options peuvent s'appliquer pour effectuer des remplacements. Elles sont disponibles en dessous de la nouvelle valeur.
113
114 [[image:1717773756783-200.png||data-xwiki-image-style-alignment="center" height="520" width="1066" class="img-thumbnail"]]
115
116 (% class="box warningmessage" %)
117 (((
118 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.
119 Il convient alors de laisser les options cochées par défaut : champ entier et occurence.
120 )))
121
122 ==== Chercher ====
123
124 Les options de la colonne Chercher permettent de préciser le niveau de recherche de la valeur à remplacer.
125
126 - Caractère : la recherche se fera uniquement sur une suite de caractères
127
128 - Mot entier : la recherche se fera sur le mot entier
129
130 - Champ entier : la recherche se fera sur le champ entier
131
132 Par exemple, sur le texte Lorem Ipsum :
133
134 //La recherche sur caractères « sum » ne prendra en compte que Lorem ip**SUM**//
135
136 //La recherche sur mot entier de « ipsum » ne prendra en compte que Lorem **IPSUM**//
137
138 //La recherche sur champ entier « Lorem ipsum» prendra en compte le texte entier **LOREM IPSUM**//
139
140 ==== Emplacement ====
141
142 Les options de la colonne Emplacement permettent de spécifier le remplacement de la valeur du champ.
143
144 - Occurrence : l’occurrence recherchée est remplacée
145
146 - Champ entier : Le champ entier est remplacé (quel que soit l’occurrence recherchée)
147
148 - Début de champ : La nouvelle valeur est ajoutée au début du champ
149
150 - Fin de champ : La nouvelle valeur est ajoutée à la fin du champ
151
152 Ces options sont à combiner avec les options précédentes de la colonne Chercher.
153
154 //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 ~://
155
156 |Option Chercher|Option Emplacement|Résultat
157 |Caractère|Occurence|Lorem iphone
158 |Caractère|Champ entier|hone
159 |Caractère|Début du champ|honeLorem ipsum
160 |Caractère|Fin du champ|Lorem ipsumhone
161
162 //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 ~://
163
164 |Option Chercher|Option Emplacement|Résultat
165 |Mot entier|Occurence|Lorem dolor
166 |Mot entier|Champ entier|dolor
167 |Mot entier|Début du champ|dolorLorem ipsum
168 |Mot entier|Fin du champ|Lorem ipsumsdolor
169
170 (% class="box warningmessage" %)
171 (((
172 Attention cela ne fonctionnera pas si vous indiquez des caractères et non des mots entiers.
173 //Par exemple remplacer « sum » par « dolor » en cochant l’option mot entier.//
174 )))
175
176 //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 ~://
177
178 |Option Chercher|Option Emplacement|Résultat
179 |Champ entier|Occurence|dolor
180 |Champ entier|Champ entier|dolor
181 |Champ entier|Début du champ|dolorLorem ipsum
182 |Champ entier|Fin du champ|Lorem ipsumsdolor
183
184 (% class="box warningmessage" %)
185 (((
186 Attention cela ne fonctionnera pas si vous indiquez des caractères ou des mots entiers à la place du champ entier.
187 //Par exemple remplacer « sum » par « dolor » ou remplacer « ipsum » par « dolor » en cochant champ entier.//
188 )))
189
190 ==== Options supplémentaires ====
191
192 - 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.
193
194 //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.//
195
196 - 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.
197
198 //Par exemple, mon champ contient Lorem ipsum ipsum, je souhaite remplacer tous les « sum » par « hone ».//
199
200 //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.//
201
202 //Alors qu’en cochant l’option les deux « sum » seront remplacés ce qui donnera Lorem iphone iphone.//
203
204
205 == Ajouter ==
206
207
208 La fonctionnalité ajouter permet d'ajouter une valeur dans un champ.
209
210 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.
211
212 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é.
213
214 Renseigner ensuite la nouvelle valeur souhaitée.
215
216 [[image:1718002712583-345.png||data-xwiki-image-style-alignment="center" height="470" width="924"]]
217
218 (% class="wikigeneratedid" %)
219 Lancer le test permet de vérifier que la modification globale va fonctionner.
220
221 (% class="box warningmessage" %)
222 (((
223 Attention Lancer le test ne permet pas de visualiser le résultat.
224 )))
225
226 (% class="wikigeneratedid" %)
227 Lancer le traitement lancera la modification des notices.
228
229
230 === Ajouter au champ parent existant ===
231
232
233 (% class="reference" %)
234 L'option ajouter au champ parent existant permet d'ajouter la valeur à un champ déjà existant dans la notice.
235
236 [[image:1718004841774-374.png||data-xwiki-image-style-alignment="center" height="277" width="926" class="img-thumbnail"]]
237
238 (% class="reference" %)
239 Plusieurs cas de figure peuvent se présenter :
240
241 (% class="reference" %)
242 - Le champ accepte une valeur unique et n'est pas renseigné: la valeur est ajoutée
243
244 (% class="reference" %)
245 - Le champ accepte une valeur unique et est déjà renseigné : l'ajout de de valeur n'a aucun effet
246
247 (% class="reference" %)
248 - Le champ est multivalué et n'est pas renseigné : la valeur est ajoutée
249
250 (% class="reference" %)
251 - Le champ est multivalué et est déjà renseigné : la nouvelle valeur vient compléter celles déjà existantes
252
253
254 (% id="HCrE9erunnouveauchampparent" class="reference" %)
255 === Créer un nouveau champ parent ===
256
257
258 (% class="reference" %)
259 Cette option permet de dupliquer le champ afin d'ajouter la nouvelle valeur.
260
261 (% class="box warningmessage" %)
262 (((
263 Attention cette option ne fonctionne qu'avec les champs duplicables.
264 )))
265
266 [[image:1718005071968-162.png||data-xwiki-image-style-alignment="center" height="479" width="966" class="img-thumbnail"]]
267
268 == Supprimer un champ ==
269
270
271 La fonctionnalité supprimer un champ permet de supprimer une valeur d'un champ.
272
273 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.
274
275 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é.
276
277 Renseigner ensuite la valeur recherchée et qui est à supprimer.
278
279 [[image:1718005707106-758.png||data-xwiki-image-style-alignment="center" height="497" width="1060" class="img-thumbnail"]]
280
281 (% class="wikigeneratedid" %)
282 Lancer le test permet de vérifier que la modification globale va fonctionner.
283
284 (% class="box warningmessage" %)
285 (((
286 Attention Lancer le test ne permet pas de visualiser le résultat.
287 )))
288
289 (% class="wikigeneratedid" %)
290 Lancer le traitement lancera la modification des notices.
291
292 (% class="box warningmessage" id="HOptions-1" %)
293 (((
294 Attention les options de recherche ne fonctionnent pas pour la suppression d'un champ.
295 Quelque soit l'option cochée, le champ contenant la valeur recherchée sera entièrement supprimée.
296 )))
297
298 == Echange ==
299
300
301 La fonctionnalité échange permet d'échanger une autorité avec une autre autorité.
302
303 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.
304
305 La table liée permet de renseigner la table d'autorité concernée par l'échange.
306
307 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é.
308
309 Renseigner ensuite la valeur recherchée à remplacer et la nouvelle valeur souhaitée.
310
311 //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.//
312
313 [[image:1718007194775-136.png||data-xwiki-image-style-alignment="center" height="420" width="1381" class="img-thumbnail"]]
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 == Supprimer les notices ==
327
328 (% id="HStandard-6" %)
329 La fonctionnalité supprimer les notices permet de supprimer l'ensemble des notices sélectionnées.
330
331 (% class="box warningmessage" %)
332 (((
333 Attention toutes suppressions de notices est irréversibles.
334 )))
335
336 [[image:1718007555125-860.png||data-xwiki-image-style-alignment="center" height="220" width="1273" class="img-thumbnail"]]
337
338 Lancer le test permet de vérifier que la suppression va fonctionner.
339
340 (% class="box warningmessage" %)
341 (((
342 Attention Lancer le test ne permet pas de visualiser le résultat.
343 )))
344
345 Lancer le traitement lancera la suppression des notices.
346
347 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é.
348
349 = Lancer le traitement =
350
351
352 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.
353
354 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.
355
356 [[image:1718007767433-901.png||data-xwiki-image-style-alignment="center" height="554" width="1184" class="img-thumbnail"]]
357
358 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.
359
360 [[image:1718007797909-766.png||data-xwiki-image-style-alignment="center" height="552" width="1177" class="img-thumbnail"]]
361
362 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.)
363
364 [[image:1718007901694-625.png||data-xwiki-image-style-alignment="center" height="375" width="1174" class="img-thumbnail"]]
365
366 (% class="box warningmessage" %)
367 (((
368 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.
369 )))
370
371 Une fois la modification paramétrée et testée, deux possibilités sont offertes pour lancer le traitement effectif :
372
373 * A partir de l'écran de résultat de test (étape précédente) : cliquez sur Appliquer.
374 * A partir d'un des écrans de paramétrage de la modification globale : cliquez sur Lancer le traitement.
375
376 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.
377
378
379 Une fois le test ou le traitement terminé, trois boutons se présentent en haut de la page :
380
381 [[image:1718007993541-975.png]]retour au formulaire de recherche
382
383 [[image:1718008006027-949.png]]retour à la liste résultat
384
385 [[image:1718008017305-150.png]] télécharger les rapports.
386
387 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é.
388
389 [[image:1718008058300-626.png||data-xwiki-image-style-alignment="center" height="333" width="389" class="img-thumbnail"]]
390
391 (% class="imgpara" %)
392 Le fichier zip contient trois fichiers correspondant aux trois zones d'informations décrites ci-dessous.
393
394 (% class="imgpara" %)
395 Les noms de fichier sont composés :
396
397 * du code de l’action
398 * global_replace = Remplacement
399 * global_add = Ajout
400 * global_remove = Suppression de champ
401 * global_exchange = Echange d'autorité
402 * global_notice_delete = Suppression de notice
403 * CommitBatch = traitement effectif,
404 * du code de l’utilisateur connecté,
405 * de la date d’exécution de la modification,
406 * du type d'information
407 * err = erreurs rencontrées (contenu de la troisième partie de la page)
408 * out = liste de fiches impactées (contenu de la deuxième partie de la page)
409 * summary = récapitulatif (affiché dans la première partie de la page)