Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
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.
ConditionUn filtre au format JSON. Exemple : {"status": "Draft"}. Utilisez les noms techniques des champs et les valeurs stockées en base, en anglais (Draft, pas « Brouillon »). Une clé or_filters ajoute des filtres « ou ». 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
Condition{"status": "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.