Outils

Mise à jour en masse

Modifier la valeur d'un champ sur plusieurs documents d'un même type en une fois, avec des conditions pour les filtrer.
Créer une mise à jour en masse dans la démo

La Mise à jour en masse donne une même valeur à un champ sur plusieurs documents d'un même type. Une condition choisit les documents concernés. Un passage traite 500 documents au maximum.

Prérequis

  • Le rôle Gestionnaire système.
  • La case Autoriser les actions groupées cochée dans votre fiche Utilisateur. Elle est cochée par défaut.

Champs

ChampRôle
Type de documentLe type à modifier, par exemple « Devis ». Les types simples (paramètres) et les types du cœur (DocType, Utilisateur, Rôle…) sont exclus.
ChampLe nom technique du champ à modifier, par exemple territory. La liste propose les champs qui stockent une valeur.
Mettre à Jour la valeurLa nouvelle valeur. Elle est obligatoire. Pour un champ lien, saisissez le nom exact d'un document existant.
ConditionUne condition SQL sur la table du type de document, sans point-virgule. Exemple : status="Draft". Utilisez les noms techniques des champs et les valeurs stockées en base, en anglais (Draft, pas « Brouillon »). Sans condition, tous les documents sont concernés dans la limite fixée.
LimiteLe nombre maximal de documents à modifier. Valeur par défaut et maximum : 500.

Lancer une mise à jour

  1. Ouvrez la recherche (Ctrl+K) et saisissez Mise à jour en Masse.
  2. Choisissez le Type de document.
  3. Choisissez le Champ.
  4. Saisissez la nouvelle valeur dans Mettre à Jour la valeur.
  5. Saisissez la condition dans Condition.
  6. Ajustez la Limite si besoin.
  7. Cliquez sur Mettre à jour.

Le message « Mise à jour réussie » confirme la fin du traitement. Avec 20 documents ou plus, le traitement passe en tâche de fond . Une alerte vous l'indique et une barre de progression s'affiche.

Exemple

Exemple fictif : vous rattachez au territoire « France » tous les devis en brouillon.

ChampValeur
Type de documentDevis
Champterritory
Mettre à Jour la valeurFrance
Conditionstatus="Draft"
Limite500

Ce qui se passe à l'enregistrement

Dokos ouvre chaque document, change la valeur, puis l'enregistre. Les contrôles habituels du document s'appliquent donc. Un document est ignoré et apparaît dans le message « Impossible de mettre à jour » dans ces cas :

  • Le document est annulé.
  • Le document est validé et le champ n'est pas modifiable après validation.
  • L'enregistrement échoue sur un contrôle. L'erreur est alors visible dans le Journal des erreurs.
La mise à jour ne peut pas être annulée en bloc. Testez d'abord avec une Limite basse, par exemple 5.