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
| Champ | Rôle |
|---|---|
| Type de document | Le type à modifier, par exemple « Devis ». Les types simples (paramètres) et les types du cœur (DocType, Utilisateur, Rôle…) sont exclus. |
| Champ | Le nom technique du champ à modifier, par exemple territory. La liste propose les champs qui stockent une valeur. |
| Mettre à Jour la valeur | La nouvelle valeur. Elle est obligatoire. Pour un champ lien, saisissez le nom exact d'un document existant. |
| Condition | Une 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. |
| Limite | Le nombre maximal de documents à modifier. Valeur par défaut et maximum : 500. |
Lancer une mise à jour
- Ouvrez la recherche (Ctrl+K) et saisissez Mise à jour en Masse.
- Choisissez le Type de document.
- Choisissez le Champ.
- Saisissez la nouvelle valeur dans Mettre à Jour la valeur.
- Saisissez la condition dans Condition.
- Ajustez la Limite si besoin.
- 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.
| Champ | Valeur |
|---|---|
| Type de document | Devis |
| Champ | territory |
| Mettre à Jour la valeur | France |
| Condition | status="Draft" |
| Limite | 500 |
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.