Modifications pour le document Modifier par lot

Modifié par Joséphine Ducruet le 2025/10/30 15:23

Gérer
- Copier
Actions
- Exporter
- Aperçu avant impression
Affichage

From 2.5 to 2.4 From 15.1 to 14.1

Depuis la version 14.1

modifié par Joséphine Ducruet
sur 2025/08/27 14:13

Commentaire de modification : Il n'y a aucun commentaire pour cette version

À la version 2.5

modifié par Doriane Bautista
sur 2025/08/07 14:50

Commentaire de modification : Update document after refactoring.

Source
Rendu

Résumé

Propriétés de la Page (2 modifications, 0 ajouts, 0 suppressions)
Pièces jointes (14 modifications, 0 ajouts, 1 suppressions)

Détails

Propriétés de la Page

Auteur du document

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.DBA

Contenu

@@ -1,549 +1,409 @@
--(% class="mark small" %)**Version 3.5 et ultérieures**
++
--|(% style="width:840px" %)(((
--(((
--(% class="box" %)
--(((
--La **modification par lot** permet de mettre à jour en une seule opération un ensemble de notices issues d’une recherche. Elle sert à normaliser, corriger, enrichir ou nettoyer des données à grande échelle, sans passer notice par notice.
--)))
++{{toc/}}
--= Points clés avant de se lancer =
++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 :
--La **modification globale (ou par lot)** est réservée aux professionnels habilités.
--Elle permet de mettre à jour, en temps réel, un ensemble de notices issues d’une recherche, selon différents axes :
++* modifier partiellement ou totalement la valeur d'un champ
++* ajouter un champ
++* supprimer le contenu d'un champ
++* échanger des autorités
++* supprimer les notices.
--* remplacer partiellement ou totalement la valeur d’un champ,
--* ajouter une valeur,
--* supprimer le contenu d’un champ,
--* échanger des autorités,
--* supprimer des notices.
--
  (% class="box warningmessage" %)
  (((
--**Attention** : une fois validées, les modifications sont **irréversibles.**
++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.
  )))
--(% class="box successmessage" %)
++(% class="box warningmessage" %)
  (((
--**Bonnes pratiques :**
--
--* **Toujours tester sur la base de formation** avant d’appliquer en production.
--* Planifier les **grosses modifications en fin de journée**, lorsque les autres utilisateurs ne sont pas connectés, afin d’éviter les ralentissements.
++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.
  )))
--= Rechercher les notices à modifier =
++= Rechercher les fiches à modifier =
-- Deux modes d’accès sont possibles (selon vos droits) :
++La recherche des fiches à modifier peut être réalisée de deux façons (tout dépend des droits accordés à l'utilisateur) :
--== Depuis l’Administration ==
++* par le menu Données / Modification globale de l'espace de travail Administration.
++* directement à partir d'une liste résultat de recherche standard présentant les fiches à modifier.
--1. Espace de travail //Administration// → Menu **Données / Modification globale**.
--1. Sélectionner la source, puis la table concernée.
--1. Choisir l'index de recherche
--1. Définir les critères de recherche.
++(% id="HStandard" %)
++== Accéder à l'écran de modification globale par le menu d'Administration ==
--[[Accès à la modification globale depuis l'administration>>image:1717771048889-896.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++- Sélectionnez l'espace de travail Administration, puis cliquez sur le menu Données / Modification globale.
++[[image:1717771048889-896.png||data-xwiki-image-style-alignment="center" height="419" width="968" class="img-thumbnail"]]
--[[Interface de recherche de la modification globale>>image:1717771513301-161.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--== Depuis une liste de résultats ==
++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.
--1. À l’issue d’une recherche standard, **sélectionner les notices à modifier** (ou laisser vide pour traiter l’ensemble de la liste).
--1. Cliquer sur le bouton de **modification par lot**.
++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.
--[[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"]]
++La liste des index disponibles pour cette table s'affiche alors dans la liste des index, permettant de électionner l'index souhaité.
++Saisir ensuite les critères de recherche et lancer la recherche
--[[Modification par lot sans sélection de notices>>image:1717771855009-131.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++[[image:1717771513301-161.png||data-xwiki-image-style-alignment="center" height="415" width="547" class="img-thumbnail"]]
--= Remplacer une valeur =
--== Cas d'usage ==
++(% id="HAccE9derE0l27E9crandemodificationglobaleE0partird27unelisterE9sultat" class="MsoCaption" %)
++== Accéder à l'écran de modification globale à partir d'une liste résultat ==
++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]] .
--Permet de **remplacer la valeur d’un champ par une autre**.
++Il est possible de sélectionner les notices à modifier en les cochant puis en cliquant sur le bouton de modification par lot.
-->(% class="small" %)Ex. remplacer la dénomination //table// par //chaise//.
++[[image:1717771746741-695.png||data-xwiki-image-style-alignment="center" height="518" width="1093" class="img-thumbnail"]]
-- Idéal pour :
++(% class="MsoCaption" %)
++Si aucune notice n'a été sélectionnée dans la liste, Flora propose de prendre en compte toutes les réponses.
--* **Corriger une coquille** dans un champ texte
--* **Nettoyer la typographie** : doubles espaces, séparateurs, guillemets, etc
--* **Normaliser un terme** ou une abréviation
--* **Harmoniser la casse/accents**
--* **Préfixer** ou **suffixer** une valeur
--* **Remplacer un contenu obsolète** par un libellé actuel
--* **Réécrire entièrement** une valeur incorrecte
++[[image:1717771855009-131.png||data-xwiki-image-style-alignment="center" height="521" width="1088" class="img-thumbnail"]]
--== Définir la valeur à remplacer ==
++= Modification globale =
--La **source** et la **table** sur lesquelles effectuer les modifications sont pré-remplies par défaut.
--Il faut ensuite choisir le **champ** concerné.
++Une fois arrivé sur l'interface de modification globale plusieurs fonctionnalités de modifications sont disponibles :
--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é.
++- Remplacer
--Il suffit enfin de renseigner :
++- Ajouter
--* la **valeur recherchée**,
--* la **nouvelle valeur** souhaitée.
++- Supprimer un champ
--[[Exemple : remplacer la dénomination table par chaise>>image:1717772769570-868.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++- Echange
--== Option Forcer ==
++- Supprimer les notices
--Cocher la case **Forcer** permet de ne pas spécifier de valeur recherchée : toutes les notices sélectionnées seront modifiées.
++== Remplacer ==
-->(% class="small" %)**Exemple :**Notice A : Dénomination = //table//
++(% id="HStandard-2" %)
++La fonctionnalité remplacer permet de remplacer la valeur d'un champ par une autre valeur.
-->(% class="small" %)Notice B : Dénomination = //tabouret//
++//Par exemple, dans une notice bien, remplacer la dénomination table par la dénomination chaise.//
-->(% class="small" %)**Action : Remplacer Dénomination → Nouvelle valeur = //chaise// + Forcer coché**
++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.
-->(% class="small" %)**Résultat :**
++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é.
-->(% class="small" %)Notice A : Dénomination = //chaise//
++Renseigner ensuite la valeur recherchée et la nouvelle valeur souhaitée.
-->(% class="small" %)Notice B : Dénomination = //chaise//
++[[image:1717772769570-868.png||data-xwiki-image-style-alignment="center" height="557" width="1155" class="img-thumbnail"]]
--(% class="box successmessage" %)
--(((
--**À retenir :**
++(% class="wikigeneratedid" %)
++Lancer le test permet de vérifier que la modification globale va fonctionner.
--* L’option **Forcer** écrase sans distinction toutes les valeurs présentes dans le champ sélectionné.
--* 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.
--* C’est une action **radicale** à réserver aux cas où toutes les notices doivent avoir exactement la même donnée.
--)))
--
--== Options de remplacement ==
--
--Ces options permettent d’affiner le comportement du remplacement. Elles apparaissent juste en dessous du champ //Nouvelle valeur//.
--
  (% class="box warningmessage" %)
  (((
--**Important** : ces options ne concernent que les champs en **texte libre**.
--Ne les utilisez pas sur les champs de type **liens, thésaurus ou listes**, car cela peut provoquer des pertes de données.
--Si vous avez un doute, laissez les réglages par défaut : **Champ entier** + **Occurrence**.
++Attention Lancer le test ne permet pas de visualiser le résultat.
  )))
--=== Chercher ===
++(% class="wikigeneratedid" %)
++Lancer le traitement lancera la modification des notices.
--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.
++=== Forcer ===
--* **Caractère** → recherche une simple suite de caractères
--* **Mot entier** → recherche un mot complet
--* **Champ entier** → recherche la valeur complète du champ
++(% class="wikigeneratedid" %)
++Cocher la case "Forcer" permet de ne pas spécifier de valeurs à rechercher. Toutes les notices sélectionnées seront modifiées.
-->(% class="small" %)Exemple :
++//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.//
-->(% class="small" %)Texte de départ : Inventaire des peintures anciennes
++=== Options ===
-->(% class="small" %)Caractère : Recherche de **tair** → prend en compte uniquement la suite de caractères dans //Inven**tair**e//.
++Des options peuvent s'appliquer pour effectuer des remplacements. Elles sont disponibles en dessous de la nouvelle valeur.
-->(% class="small" %)Mot entier : Recherche de **Inventaire** → prend en compte uniquement le mot complet **//Inventaire//**.
++[[image:1717773756783-200.png||data-xwiki-image-style-alignment="center" height="520" width="1066" class="img-thumbnail"]]
-->(% class="small" %)Champ entier : Recherche de** Inventaire des peintures anciennes** → prend en compte le texte complet **Inventaire des peintures anciennes**
--
--=== Emplacement ===
--
--Cette option permet de préciser **où** la nouvelle valeur sera appliquée dans le champ : uniquement à l’occurrence trouvée, à tout le champ, au début ou à la fin du texte.
--
--* **Occurrence** → seule la partie identifiée est remplacée.
--* **Champ entier** → tout le contenu du champ est remplacé (quelque soit la recherche)
--* **Début de champ** → la nouvelle valeur est ajoutée au début du texte existant.
--* **Fin de champ** → la nouvelle valeur est ajoutée à la fin du texte existant.
--
--Elle se **combine** avec le réglage **Chercher** (Caractère, Mot entier, Champ entier).
--
-->(% class="small" %)**Exemple**
--
-->(% class="small" %)Texte de départ : Inventaire des peintures anciennes
--
-->(% class="small" %)**Cas 1** Chercher = Caractère **pein** | Nouvelle valeur : **phot**
--
++(% class="box warningmessage" %)
  (((
--|=(% style="text-align: center;" %)(% class="small" %)Chercher|=(% style="text-align: center;" %)(% class="small" %)Emplacement|=(% style="text-align: center;" %)(% class="small" %)Résultat
--|(%%)(% class="small" %)Caractère|(%%)(% class="small" %)Occurrence|(%%)(% class="small" %)Inventaire des **phot**tures anciennes
--|(%%)(% class="small" %)Caractère|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)**phot**
--|(%%)(% class="small" %)Caractère|(%%)(% class="small" %)Début de champ|(%%)(% class="small" %)**phot**Inventaire des peintures anciennes
--|(%%)(% class="small" %)Caractère|(%%)(% class="small" %)Fin de champ|(%%)(% class="small" %)Inventaire des peintures anciennes**phot**
++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.
++Il convient alors de laisser les options cochées par défaut : champ entier et occurence.
  )))
-->(% class="small" %)**Cas 2** Chercher = Mot entier **peintures** | Nouvelle valeur : **dessins**
++==== Chercher ====
--|=(% style="text-align: center;" %)(% class="small" %)Chercher|=(% style="text-align: center;" %)(% class="small" %)Emplacement|=(% style="text-align: center;" %)(% class="small" %)Résultat
--|(%%)(% class="small" %)Mot entier|(%%)(% class="small" %)Occurrence|(%%)(% class="small" %)Inventaire des **dessins** anciennes
--|(%%)(% class="small" %)Mot entier|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)**dessins**
--|(%%)(% class="small" %)Mot entier|(%%)(% class="small" %)Début de champ|(%%)(% class="small" %)**dessins**Inventaire des peintures anciennes
--|(%%)(% class="small" %)Mot entier|(%%)(% class="small" %)Fin de champ|(%%)(% class="small" %)Inventaire des peintures anciennes**dessins**
++Les options de la colonne Chercher permettent de préciser le niveau de recherche de la valeur à remplacer.
--(% class="box warningmessage" %)
--(((
--**Attention :** cela ne fonctionnera pas si vous indiquez une **suite de caractères** au lieu d’un **mot complet**.
--Par exemple, chercher (ou remplacer) « **pein** » en cochant l’option **Mot entier** ne donnera aucun résultat ; utilisez le mot complet « **peintures** ».
--)))
++- Caractère : la recherche se fera uniquement sur une suite de caractères
-->(% class="small" %)**Cas 3** Chercher = Champ entier **Inventaire des peintures anciennes** | Nouvelle valeur : **Catalogue des peintures**
--)))
++- Mot entier : la recherche se fera sur le mot entier
--(((
--|=(% class="small" %)Chercher|=(% class="small" %)Emplacement|=(% class="small" %)Résultat
--|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)Occurrence|(%%)(% class="small" %)**Catalogue des peintures**
--|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)**Catalogue des peintures**
--|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)Début de champ|(%%)(% class="small" %)**Catalogue des peintures**Inventaire des peintures anciennes
--|(%%)(% class="small" %)Champ entier|(%%)(% class="small" %)Fin de champ|(%%)(% class="small" %)Inventaire des peintures anciennes**Catalogue des peintures**
++- Champ entier : la recherche se fera sur le champ entier
--(% class="box warningmessage" %)
--(((
--Avec **Champ entier**, la valeur recherchée doit **correspondre exactement** au contenu du champ (pas seulement un mot ou un extrait).
--)))
++Par exemple, sur le texte Lorem Ipsum :
--(% class="box successmessage" %)
--(((
--**A retenir : **
++//La recherche sur caractères « sum » ne prendra en compte que Lorem ip**SUM**//
--* **Chercher = quoi cibler** :
--**Caractère** (séquence) · **Mot entier** (mot complet) · **Champ entier** (valeur exacte).
--* **Emplacement = où appliquer** :
--**Occurrence** (partie trouvée) · **Champ entier** (tout le champ) · **Début**/**Fin** (ajout en pré/suffixe).
--* **Combinaison** : le résultat dépend **des deux** réglages (Chercher × Emplacement).
--* Utile pour :
--** **Corriger une coquille**
--** **Remplacer un terme obsolète**
--** **Nettoyer la ponctuation et les espaces**
--)))
++//La recherche sur mot entier de « ipsum »  ne prendra en compte que Lorem **IPSUM**//
--== Respecter la casse ==
++//La recherche sur champ entier « Lorem ipsum» prendra en compte le texte entier **LOREM IPSUM**//
--Active une recherche **strictement identique** à la valeur saisie : **majuscules, minuscules et accents** sont distingués.
++==== Emplacement ====
--(% class="box warningmessage" %)
--(((
--**Important** : ces options ne concernent que les champs en **texte libre**.
--Ne les utilisez pas sur les champs de type **liens, thésaurus ou listes**, car cela peut provoquer des pertes de données.
--Si vous avez un doute, laissez les réglages par défaut : **Champ entier** + **Occurrence**.
--)))
++Les options de la colonne Emplacement permettent de spécifier le remplacement de la valeur du champ.
-->(% class="small" %)**Exemples :**
++- Occurrence : l’occurrence recherchée est remplacée
-->(% class="small" %)**Majuscules**
++- Champ entier : Le champ entier est remplacé (quel que soit l’occurrence recherchée)
-->(% class="small" %)Champ : Catalogue Monet
++- Début de champ : La nouvelle valeur est ajoutée au début du champ
-->(% class="small" %)Recherche : monet avec **Respecter la casse** → **aucun résultat**
++- Fin de champ : La nouvelle valeur est ajoutée à la fin du champ
-->(% class="small" %)(Décochez l’option ou recherchez Monet pour trouver la valeur.)
++Ces options sont à combiner avec les options précédentes de la colonne Chercher.
-->(% class="small" %)**Accents**
++//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 ~://
-->(% class="small" %)Champ : École de Paris
++|Option Chercher|Option Emplacement|Résultat
++|Caractère|Occurence|Lorem iphone
++|Caractère|Champ entier|hone
++|Caractère|Début du champ|honeLorem ipsum
++|Caractère|Fin du champ|Lorem ipsumhone
-->(% class="small" %)Recherche : Ecole avec **Respecter la casse** → **aucun résultat**
++//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 ~://
-->(% class="small" %)(Décochez l’option ou recherchez École pour trouver la valeur.)
++|Option Chercher|Option Emplacement|Résultat
++|Mot entier|Occurence|Lorem dolor
++|Mot entier|Champ entier|dolor
++|Mot entier|Début du champ|dolorLorem ipsum
++|Mot entier|Fin du champ|Lorem ipsumsdolor
--(% class="box successmessage" %)
++(% class="box warningmessage" %)
  (((
--**A retenir :**
--
--* **Effet** : correspondance **strictement identique** (majuscules/minuscules **et** accents pris en compte).
++Attention cela ne fonctionnera pas si vous indiquez des caractères et non des mots entiers.
++//Par exemple remplacer « sum » par « dolor » en cochant l’option mot entier.//
  )))
--== Remplacer toutes les occurrences présentes dans la valeur ==
++//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 ~://
--Par défaut, **seule la première occurrence** trouvée dans le champ est remplacée.
--En cochant **Remplacer toutes les occurrences présentes dans la valeur**, **toutes** les occurrences repérées dans ce même champ sont modifiées.
++|Option Chercher|Option Emplacement|Résultat
++|Champ entier|Occurence|dolor
++|Champ entier|Champ entier|dolor
++|Champ entier|Début du champ|dolorLorem ipsum
++|Champ entier|Fin du champ|Lorem ipsumsdolor
  (% class="box warningmessage" %)
  (((
--**Important** : ces options ne concernent que les champs en **texte libre**.
--Ne les utilisez pas sur les champs de type **liens, thésaurus ou listes**, car cela peut provoquer des pertes de données.
--Si vous avez un doute, laissez les réglages par défaut : **Champ entier** + **Occurrence**.
++Attention cela ne fonctionnera pas si vous indiquez des caractères ou des mots entiers à la place du champ entier.
++//Par exemple remplacer « sum » par « dolor » ou remplacer « ipsum » par « dolor » en cochant champ entier.//
  )))
-->(% class="small" %)**Exemple :**
++==== Options supplémentaires ====
-->(% class="small" %)Champ (//Titre//) : Inventaire des peintures et des peintures anciennes
++- 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.
-->(% class="small" %)Chercher = **Mot entier** peintures → Nouvelle valeur = dessins
++//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.//
-->(% class="small" %)**Sans** l’option : Inventaire des ~*~*dessins~*~* et des peintures anciennes
++- 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.
-->(% class="small" %)**Avec** l’option : Inventaire des ~*~*dessins~*~* et des ~*~*dessins~*~* anciennes
++//Par exemple, mon champ contient Lorem ipsum ipsum, je souhaite remplacer tous les « sum » par « hone ».//
--(% class="box successmessage" %)
--(((
--**A retenir : **
++//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.//
--* **Effet** : par défaut, seule la **première** occurrence est remplacée ; avec l’option cochée, **toutes** les occurrences dans le **même champ** sont modifiées.
--* Utile pour :
--** **Corriger une faute répétée**
--** **Remplacer un terme obsolète récurrent**
--)))
++//Alors qu’en cochant l’option les deux « sum » seront remplacés ce qui donnera Lorem iphone iphone.//
--== Lancer le traitement ==
--* **Lancer le test** : permet de vérifier que la modification globale va fonctionner.
++== Ajouter ==
--(% class="box warningmessage" %)
--(((
--**Attention** : //Lancer le test ne permet pas de visualiser le résultat// (aucune donnée n’est modifiée).
--)))
--* **Lancer le traitement** : applique réellement la modification sur les notices sélectionnées.
++La fonctionnalité ajouter permet d'ajouter une valeur dans un champ.
--= Ajouter une valeur =
++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.
--== Cas d'usage ==
++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é.
--Ajoute une valeur dans la notice, idéal pour **compléter** une info manquante.
++Renseigner ensuite la nouvelle valeur souhaitée.
--== Définir la valeur à ajouter ==
++[[image:1718002712583-345.png||data-xwiki-image-style-alignment="center" height="470" width="924"]]
--1. La **source** et la **table** sont pré-remplies par défaut.
--1. Sélectionnez le **champ** à modifier.
--1. Par défaut, **Trier par libellé** est coché : le champ s’affiche sous la forme //Libellé (nom informatique)// pour distinguer les libellés identiques.
--1. Renseignez la **nouvelle valeur** souhaitée.
++(% class="wikigeneratedid" %)
++Lancer le test permet de vérifier que la modification globale va fonctionner.
--[[Exemple : Ajoute du lieu d'utilisation Lyon>>image:1718002712583-345.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++(% class="box warningmessage" %)
++(((
++Attention Lancer le test ne permet pas de visualiser le résultat.
++)))
--== Ajouter au champ parent existant ==
++(% class="wikigeneratedid" %)
++Lancer le traitement lancera la modification des notices.
--Ajoute la valeur **dans le champ déjà présent** sur la notice.
--[[Ajout dans un champ parent existant>>image:1718004841774-374.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++=== Ajouter au champ parent existant ===
--**Comportement selon le type de champ :**
++(% class="reference" %)
++L'option ajouter au champ parent existant permet d'ajouter la valeur à un champ déjà existant dans la notice.
--* Champ **mono-valeur** vide → la valeur est **ajoutée**.
--* Champ **mono-valeur** déjà renseigné → **aucun effet**.
--* Champ **multi-valeur** vide → la valeur est **ajoutée**.
--* Champ **multi-valeur** déjà renseigné → la valeur **complète** celles existantes.
++[[image:1718004841774-374.png||data-xwiki-image-style-alignment="center" height="277" width="926" class="img-thumbnail"]]
--(% class="box successmessage" %)
--(((
--**A retenir : **
++(% class="reference" %)
++Plusieurs cas de figure peuvent se présenter :
--* **Effet** : insère la **nouvelle valeur** dans le **champ déjà présent** sur la notice
--* Utile pour :
--** **Compléter des mots-clés**
--** **Enrichir un champ multi-valeur**
--)))
++(% class="reference" %)
++- Le champ accepte une valeur unique et n'est pas renseigné: la valeur est ajoutée
--== Créer un nouveau champ parent ==
++(% class="reference" %)
++- Le champ accepte une valeur unique et est déjà renseigné : l'ajout de de valeur n'a aucun effet
--**Duplique** le champ pour y ajouter la nouvelle valeur (uniquement pour les **champs duplicables**).
++(% class="reference" %)
++- Le champ est multivalué et n'est pas renseigné : la valeur est ajoutée
--[[Duplication du champ lieu d'utilisation>>image:1718005071968-162.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++(% class="reference" %)
++- Le champ est multivalué et est déjà renseigné : la nouvelle valeur vient compléter celles déjà existantes
--(% class="box successmessage" %)
--(((
--**A retenir : **
++(% id="HCrE9erunnouveauchampparent" class="reference" %)
++=== Créer un nouveau champ parent ===
--* **Effet** : duplique le **bloc (champ parent)** pour y ajouter la nouvelle valeur dans une **nouvelle occurrence** distincte.
--* Utile pour :
--** **Coupler correctement Matière & Technique**
--** **Associer la bonne Personne à la bonne Fonction**
--)))
--== Lancer le traitement ==
++(% class="reference" %)
++Cette option permet de dupliquer le champ afin d'ajouter la nouvelle valeur.
--* **Lancer le test** : permet de vérifier que la modification globale va fonctionner.
--
  (% class="box warningmessage" %)
  (((
--**Attention** : //Lancer le test ne permet pas de visualiser le résultat// (aucune donnée n’est modifiée).
++Attention cette option ne fonctionne qu'avec les champs duplicables.
  )))
--* **Lancer le traitement** : applique réellement la modification sur les notices sélectionnées.
++[[image:1718005071968-162.png||data-xwiki-image-style-alignment="center" height="479" width="966" class="img-thumbnail"]]
--= Supprimer un champ =
++== Supprimer un champ ==
--== Cas d'usage ==
--Efface la **valeur d’un champ** sur les notices sélectionnées.
++La fonctionnalité supprimer un champ permet de supprimer une valeur d'un champ.
--Idéal pour :
++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.
--* **Retirer une information** obsolète ou erronée
--* **Remettre à zéro** un champ saisi au mauvais endroit
--* **Nettoyer** pour normaliser
++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é.
--== Définir la suppression ==
++Renseigner ensuite la valeur recherchée et qui est à supprimer.
--1. La **source** et la **table** sont pré-remplies par défaut.
--1. Sélectionnez le **champ** à nettoyer.
--1. Par défaut, **Trier par libellé** est coché : le champ s’affiche sous la forme //Libellé (nom informatique)// pour distinguer les libellés identiques.
--1. Renseignez la **valeur recherchée** (celle à supprimer).
++[[image:1718005707106-758.png||data-xwiki-image-style-alignment="center" height="497" width="1060" class="img-thumbnail"]]
++(% class="wikigeneratedid" %)
++Lancer le test permet de vérifier que la modification globale va fonctionner.
++
  (% class="box warningmessage" %)
  (((
--**Attention les options Chercher / Emplacement** **ne s’appliquent pas** à la suppression :
--dès que la valeur recherchée est **présente** dans le champ, **l’occurrence du champ est supprimée en entier** (et pas seulement une partie du texte).
++Attention Lancer le test ne permet pas de visualiser le résultat.
  )))
--[[Exemple : suppression du lieu d'utilisation Lyon>>image:1718005707106-758.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++(% class="wikigeneratedid" %)
++Lancer le traitement lancera la modification des notices.
--
--(% class="box successmessage" %)
++(% class="box warningmessage" id="HOptions-1" %)
  (((
--**Astuce :  Besoin de vider un champ sans spécifier de valeur recherchée ?**
--Utilisez **Remplacer** plutôt que **Supprimer un champ.**
--Sélectionnez le champ, activez **//Forcer//**, et **ne renseignez pas //Nouvelle valeur//**.
--
--[[Vider le champ Date fin de collecte>>image:1718008933138-967.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++Attention les options de recherche ne fonctionnent pas pour la suppression d'un champ.
++Quelque soit l'option cochée, le champ contenant la valeur recherchée sera entièrement supprimée.
  )))
--== Lancer le traitement ==
++== Echange ==
--* **Lancer le test** : permet de vérifier que la modification globale va fonctionner.
--(% class="box warningmessage" %)
--(((
--**Attention** : //Lancer le test ne permet pas de visualiser le résultat// (aucune donnée n’est modifiée).
--)))
++La fonctionnalité échange permet d'échanger une autorité avec une autre autorité.
--* **Lancer le traitement** : applique réellement la modification sur les notices sélectionnées.
++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.
--= Echanger une autorité =
++La table liée permet de renseigner la table d'autorité concernée par l'échange.
--== Cas d'usage ==
++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é.
--Permet de remplacer, dans les notices sélectionnées, une **autorité A** par une **autorité B** (personne, lieu, thésaurus, etc.) dans un **champ lié à une table d’autorités**.
++Renseigner ensuite la valeur recherchée à remplacer et la nouvelle valeur souhaitée.
--Idéal pour :
++//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.//
--* **Corriger** une attribution à une autorité
--* **Réparer un import** : **mauvais identifiant** pointant vers A → **autorité correcte** B
--* **Préparer la suppression de doublons d’autorités** : **rediriger** toutes les notices vers l’**autorité de référence**, **vérifier** qu’il n’y a plus de liens sur les doublons, **puis** supprimer ces autorités vides.
--)))
++[[image:1718007194775-136.png||data-xwiki-image-style-alignment="center" height="420" width="1381" class="img-thumbnail"]]
--(((
--== Définir l'échange ==
++(% class="wikigeneratedid" %)
++Lancer le test permet de vérifier que la modification globale va fonctionner.
--* La **source** et la **table** sont pré-remplies par défaut.
--* Sélectionnez le **champ** à modifier (champ **lien** vers une autorité).
--* Renseignez la **Table liée** (table d’autorité concernée : Personnes, Lieux...).
--* Indiquez l’**Autorité à remplacer** (valeur recherchée) et l’**Autorité de remplacement** (nouvelle valeur).
--
--(% class="box infomessage" %)
--(((
--Portée : si le champ accepte plusieurs valeurs, **seule l’occurrence** correspondant à l’autorité à remplacer est substituée ; les autres valeurs du champ sont **conservées**.
--)))
--
--[[Exemple : Echange de l'autorité Personnes Delacroix avec Botticelli>>image:1718007194775-136.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--
--== Lancer le traitement ==
--
--* **Lancer le test** : permet de vérifier que la modification globale va fonctionner.
--
  (% class="box warningmessage" %)
  (((
--**Attention** : //Lancer le test ne permet pas de visualiser le résultat// (aucune donnée n’est modifiée).
++Attention Lancer le test ne permet pas de visualiser le résultat.
  )))
--* **Lancer le traitement** : applique réellement la modification sur les notices sélectionnées.
++(% class="wikigeneratedid" %)
++Lancer le traitement lancera la modification des notices.
--= Supprimer des notices =
++== Supprimer les notices ==
--Supprime **définitivement** l’ensemble des notices sélectionnées.
++(% id="HStandard-6" %)
++La fonctionnalité supprimer les notices permet de supprimer l'ensemble des notices sélectionnées.
  (% class="box warningmessage" %)
  (((
--**Irréversible** : toute suppression de notice est **définitive**.
++Attention toutes suppressions de notices est irréversibles.
  )))
--[[Suppression de 59 notices>>image:1718007555125-860.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++[[image:1718007555125-860.png||data-xwiki-image-style-alignment="center" height="220" width="1273" class="img-thumbnail"]]
++Lancer le test permet de vérifier que la suppression va fonctionner.
--* **Ignorer les erreurs** : si l’option est cochée, la suppression se poursuit malgré les anomalies rencontrées ; si elle est décochée, le traitement s’interrompt dès la première erreur.
--* **Lancer le test** : permet de vérifier que la modification globale va fonctionner.
--
  (% class="box warningmessage" %)
  (((
--**Attention** : //Lancer le test ne permet pas de visualiser le résultat// (aucune donnée n’est modifiée).
++Attention Lancer le test ne permet pas de visualiser le résultat.
  )))
--* **Lancer le traitement** : applique réellement la modification sur les notices sélectionnées.
++Lancer le traitement lancera la suppression des notices.
--= Clôture du traitement : affichage et rapports =
++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é.
--== Actions disponibles après exécution ==
++= Lancer le traitement =
--À l’issue du test ou du traitement, trois boutons sont disponibles en haut de page :
--* **Retour au formulaire de recherche **[[image:1718007993541-975.png]]
--* **Retour à la liste résultat **[[image:1718008006027-949.png]]
--* **Télécharger les rapports** (recommandé)[[image:1718008017305-150.png]]
++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.
--**Cas particulier — mode test :** un bouton **Appliquer** est proposé pour lancer **réellement** le traitement.
++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.
--== Suivi du traitement ==
++[[image:1718007767433-901.png||data-xwiki-image-style-alignment="center" height="554" width="1184" class="img-thumbnail"]]
--L’affichage présente également trois zones identiques, en mode test comme en exécution :
++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.
--* **Résumé** — Synthèse des paramètres et **taux de progression**.
++[[image:1718007797909-766.png||data-xwiki-image-style-alignment="center" height="552" width="1177" class="img-thumbnail"]]
--[[Résumé>>image:1718007767433-901.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++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.)
++[[image:1718007901694-625.png||data-xwiki-image-style-alignment="center" height="375" width="1174" class="img-thumbnail"]]
--* (((
--**Détails du traitement** — Flux d’informations en cours (inclut **clés** et **digests** des notices).
--
--* Zone **volatile** : si vous quittez/revenez, l’historique affiché disparaît.
--* **Limite d’affichage** : 10 000 lignes ; au-delà, ….. s’affiche.
++(% class="box warningmessage" %)
++(((
++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.
  )))
--[[Détails du traitement>>image:1718007797909-766.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++Une fois la modification paramétrée et testée, deux possibilités sont offertes pour lancer le traitement effectif :
++* A partir de l'écran de résultat de test (étape précédente) : cliquez sur Appliquer.
++* A partir d'un des écrans de paramétrage de la modification globale : cliquez sur Lancer le traitement.
--* **Erreurs** — Zone masquée tant qu’il n’y a pas d’erreurs ; elle **persiste** jusqu’à la fin du traitement (utile notamment pour les **droits insuffisants** ou les droits **filtrés** qui n’autorisent pas toutes les notices d’une table).
++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.
--[[Erreurs>>image:1718007901694-625.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--== Rapports ==
++Une fois le test ou le traitement terminé, trois boutons se présentent en haut de la page :
--Le bouton **Télécharger les rapports** génère un **fichier .zip** qui reprend **l’intégralité des informations affichées**.
--Saisissez simplement le **nom du fichier .zip** à créer, puis validez.
++[[image:1718007993541-975.png]]retour au formulaire de recherche
--* **Contenu du .zip** — 3 fichiers correspondant aux **trois zones** de l’écran :
--** …summary… : **récapitulatif** (zone 1)
--** …out… : **liste des notices impactées** (zone 2)
--** …err… : **erreurs rencontrées** (zone 3)
++ [[image:1718008006027-949.png]]retour à la liste résultat
++[[image:1718008017305-150.png]] télécharger les rapports.
++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é.
--* **Nommage des fichiers** : concaténation de
++[[image:1718008058300-626.png||data-xwiki-image-style-alignment="center" height="333" width="389" class="img-thumbnail"]]
--1. **Code de l’action** :
--global_replace (Remplacement) · global_add (Ajout) · global_remove (Suppression de champ) ·
--global_exchange (Échange d’autorité) · global_notice_delete (Suppression de notice) ·
--CommitBatch (traitement effectif)
--1. **Code utilisateur** connecté
--1. **Date/heure d’exécution**
--1. **Type d’information** : summary / out / err
--)))
--)))|(% style="width:300px" %)(((
--(% class="box" %)
--(((
--**Sommaire**
++(% class="imgpara" %)
++Le fichier zip contient trois fichiers correspondant aux trois zones d'informations décrites ci-dessous.
--{{toc depth="2" numbered="true"/}}
--)))
++(% class="imgpara" %)
++Les noms de fichier sont composés :
--(% class="box" %)
--(((
--**Aller plus loin**
--
--* [[Rechercher dans Flora>>doc:1_Fonctionnalités.Recherche.WebHome]]
--* [[Saisir dans Flora>>doc:1_Fonctionnalités.5\.C\. Saisie.WebHome]]
--)))
--
--(% class="box" %)
--(((
--**Icônes principales**
--
--)))
--)))
++* du code de l’action
++* global_replace = Remplacement
++* global_add = Ajout
++* global_remove = Suppression de champ
++* global_exchange = Echange d'autorité
++* global_notice_delete = Suppression de notice
++* CommitBatch = traitement effectif,
++* du code de l’utilisateur connecté,
++* de la date d’exécution de la modification,
++* du type d'information
++* err = erreurs rencontrées (contenu de la troisième partie de la page)
++* out = liste de fiches impactées (contenu de la deuxième partie de la page)
++* summary = récapitulatif (affiché dans la première partie de la page)

1717771048889-896.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--62.1 KB
++83.7 KB

Contenu

1717771513301-161.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--36.5 KB
++37.1 KB

Contenu

1717771746741-695.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--180.6 KB
++258.2 KB

Contenu

1717771855009-131.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--185.9 KB
++268.6 KB

Contenu

1717772769570-868.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--126.8 KB
++69.1 KB

Contenu

1718002712583-345.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--72.8 KB
++53.4 KB

Contenu

1718004841774-374.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--33.5 KB
++27.4 KB

Contenu

1718005071968-162.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--38.6 KB
++39.6 KB

Contenu

1718005707106-758.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--77.5 KB
++33.2 KB

Contenu

1718007194775-136.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--69.6 KB
++33.8 KB

Contenu

1718007555125-860.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--32.5 KB
++20.4 KB

Contenu

1718007767433-901.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--187.1 KB
++84.5 KB

Contenu

1718007797909-766.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--190.1 KB
++82.3 KB

Contenu

1718007901694-625.png

Auteur

@@ -1,1 +1,1 @@
--XWiki.JDT
++XWiki.admin

Taille

@@ -1,1 +1,1 @@
--40.6 KB
++22.5 KB

Contenu

1718008933138-967.png

Auteur

...	...	@@ -1,1 +1,0 @@
1		-XWiki.JDT

Taille

...	...	@@ -1,1 +1,0 @@
1		-84.0 KB

Contenu