Outil d'importation de données
L'outil d'import crée ou met à jour des enregistrements en masse, à partir d'un fichier CSV ou Excel (.xlsx), ou d'une feuille Google Sheets. Il sert surtout pour les données de base : clients, fournisseurs, articles, plan comptable…
Ouvrir l'import
Dans la liste du type de document (par exemple Client), ouvrez le menu des actions et cliquez sur Importer.
L'import s'ouvre dans une fenêtre en quatre étapes : Config, Aperçu, Fix issues et Importer. Seuls les types de documents qui autorisent l'import proposent cette action.
Chaque import est gardé dans la liste Import de données. Vous pouvez y rouvrir un import en attente.
Choisir le type d'import
| Type d'import | Usage |
|---|---|
| Insérer des nouvelles données | Chaque ligne crée un enregistrement. |
| Mettre à jour des données existantes | Chaque ligne modifie l'enregistrement dont l'ID est dans le fichier. |
| Insert or Update Records | Chaque ligne met à jour l'enregistrement s'il existe, ou le crée sinon. |
Créer des enregistrements
Exemple fictif : vous reprenez la liste des clients de votre ancien logiciel.
- Dans la liste des clients, ouvrez l'import.
- Dans l'étape Config, gardez le Type d'import Insérer des nouvelles données.
- Cliquez sur Télécharger un modèle. Choisissez le format du fichier et les colonnes à inclure.
- Remplissez le modèle dans votre tableur : une ligne par client. Enregistrez-le en CSV ou en Excel.
- Joignez le fichier dans l'étape Config, ou collez l'URL d'une feuille Google Sheets.
- Cliquez sur Suivant. L'étape Aperçu montre les lignes et les colonnes reconnues.
- Cliquez sur Suivant. L'étape Fix issues liste les erreurs du fichier. Corrigez-les : voir Corriger les erreurs sans modifier le fichier.
- Dans l'étape Importer, lancez l'import. Le Journal d'import affiche le résultat de chaque ligne.
Mettre à jour des enregistrements
- Dans l'étape Config, choisissez Mettre à jour des données existantes.
- Cliquez sur Télécharger un modèle. Exportez les enregistrements à modifier, avec la colonne ID et les colonnes à mettre à jour.
- Modifiez les valeurs dans votre tableur. Ne modifiez pas la colonne ID : elle identifie les enregistrements.
- Joignez le fichier et suivez les étapes jusqu'à Importer.
Insérer ou mettre à jour en une fois
Le type d'import Insert or Update Records combine les deux modes précédents. Pour chaque ligne de votre fichier, Dokos vérifie si un enregistrement correspondant existe déjà dans le système :
- S'il existe : l'enregistrement est mis à jour avec les nouvelles valeurs. Si aucune valeur n'a changé, la ligne est considérée comme réussie sans modification inutile.
- S'il n'existe pas : un nouvel enregistrement est créé.
Ce mode sert aux synchronisations régulières : un seul fichier contient les nouvelles entrées et les mises à jour.
Quand utiliser ce mode
- Vous recevez périodiquement un export de votre ancien système contenant à la fois des entrées nouvelles et des entrées déjà présentes dans Dokos.
- Vous souhaitez mettre à jour un catalogue d'articles depuis un fichier fournisseur sans savoir lesquels existent déjà.
- Vous synchronisez des données entre deux systèmes sans vouloir gérer manuellement les doublons.
Exemple fictif : vous importez chaque semaine un fichier de 200 clients fourni par votre CRM externe. 180 clients existent déjà dans Dokos (leurs données seront mises à jour si elles ont changé), et 20 sont nouveaux (ils seront créés automatiquement). Avec le mode Insérer ou Mettre à jour, une seule importation suffit.
Utiliser ce mode
- Ouvrez l'import depuis la liste du type de document.
- Dans l'étape Config, choisissez le Type d'import Insert or Update Records.
- Cliquez sur Télécharger un modèle. Le modèle contient la colonne ID, comme en mise à jour.
- Remplissez le fichier. Gardez l'ID des enregistrements existants. Pour une nouvelle entrée, laissez l'ID vide (ID attribué automatiquement) ou saisissez l'identifiant voulu.
- Joignez le fichier, puis suivez les étapes jusqu'à Importer.
Lire le journal d'import
Après l'import, le Journal d'importation affiche pour chaque ligne l'action réalisée :
| Ligne | Action | Statut |
|---|---|---|
| 1 | Insertion | ✅ Succès |
| 2 | Mise à jour | ✅ Succès |
| 3 | Mise à jour | ✅ Succès |
| 4 | Insertion | ❌ Erreur |
Un résumé en haut du journal indique le nombre total d'enregistrements insérés et mis à jour, ainsi que le nombre d'erreurs éventuelles.
En ligne de commande
Pour un administrateur du serveur, la commande data-import accepte --type Insert, Update ou Upsert. Le type de document se donne par son nom technique (en anglais) :
bench --site <site> data-import --file clients.csv --doctype Customer --type Upsert
Importer des tables enfants
Les données dans Dokos sont stockées dans des tableaux comme une feuille de calcul avec des colonnes et des lignes de données. Chaque formulaire peut avoir plusieurs champs comme la commande client. Il a les champs : Client, Entreprise, etc. Il a également des tables comme la table des articles, la table des taxes, etc. Dans l'importation de données, l'ensemble des champs de la commande client est traité comme la table principale et les lignes à l'intérieur de la table enfant (table des éléments) sont traitées comme la table enfant pour l'importation de données.
Chaque formulaire dans Dokos peut être associé à plusieurs tables enfants. Les tables enfants sont liées aux tables parentes et sont implémentées là où il existe plusieurs valeurs pour une propriété. Par exemple, un article peut avoir plusieurs prix, une facture de vente a plusieurs articles, taxes, etc.
Lorsque vous exportez un document avec des tables enfants, par exemple, chaque ligne enfant apparaîtra sur une ligne distincte mais elle est associée à une seule ligne parente. Les valeurs suivantes dans les colonnes parentes resteront vides. Vous devez vous assurer que cet ordre n'est pas rompu lorsque vous les importez dans l'outil d'import.
Importer un client ou un fournisseur avec ses contacts et adresses
Pour les types de documents Client et Fournisseur, le modèle d'import contient deux tables enfants en plus des champs du tiers : Contact et Adresse. Un seul fichier crée le tiers, ses contacts et ses adresses, et les rattache au tiers. Les tables apparaissent seulement si vous avez le droit de lire les contacts et les adresses.
- Ouvrez l'import depuis la liste des clients ou des fournisseurs.
- Dans l'étape Config, cliquez sur Télécharger un modèle. Sélectionnez les colonnes du tiers et celles des tables Contact et Adresse.
- Saisissez une ligne par tiers. Ajoutez des lignes enfants sous le tiers pour ses autres contacts et adresses, comme pour toute table enfant.
Nom du client Groupe de clients Contact : Prénom Contact : Adresse e-mail Adresse : Adresse Ligne 1 Adresse : Ville Maison Verte SARL Commercial Alice alice@example.com 12 rue des Lilas Lyon - Importez le fichier.
Règles appliquées à l'import :
- Le premier contact et la première adresse du tiers deviennent le contact principal et l'adresse principale. Pour choisir une autre ligne, cochez Contact principal ou Est l'adresse principale sur cette ligne.
- Le contact principal donne au tiers son e-mail et son numéro de mobile.
- Une adresse sans type reçoit le type Facturation. Une adresse sans titre prend le nom du tiers.
- Un contact sans nom prend le nom du tiers : le nom de la société pour une société, le prénom et le nom pour un particulier.
- En mise à jour (Mettre à jour des données existantes ou Upsert), Dokos réutilise un contact déjà rattaché au tiers qui a le même e-mail (ou, sans e-mail, le même mobile), et une adresse qui a la même Adresse Ligne 1 et la même ville. Une réimportation ne crée donc pas de doublons. Une ligne peut aussi ajouter seulement des contacts ou des adresses à un tiers existant, sans modifier le tiers.
Un export de clients ou de fournisseurs contient les mêmes tables, avec le contact principal et l'adresse principale en premier. Vous pouvez donc réimporter le fichier exporté sans changer les principaux.
Importer des données arborescentes
Certains types de données dans Dokos sont organisés en hiérarchie (vue en arbre) : c'est le cas notamment du Plan comptable, des Centres de coûts, des Territoires, des Groupes d'articles ou encore des Groupes de clients. Ces structures ont des niveaux parents et enfants.
Dokos gère l'ordre d'import de ces structures : vous pouvez mettre les parents et les enfants dans le même fichier, dans n'importe quel ordre. Dokos crée toujours un parent avant ses enfants.
Importer une hiérarchie en une seule feuille
- Préparez votre fichier CSV ou Excel en y plaçant tous les nœuds (parents et enfants) sur des lignes distinctes.
- Renseignez la colonne Parent (ou le champ équivalent selon le type de document) avec le nom du nœud parent, même si ce parent figure plus bas dans le fichier.
- Joignez le fichier dans l'assistant d'import et lancez l'import.
Dokos analyse la structure, trie les lignes pour que les parents soient toujours créés avant leurs enfants, puis effectue l'import dans cet ordre.
Exemple : vous importez cette liste de groupes de clients :
| Nom | Parent |
|---|---|
| Grands comptes Europe | Grands comptes |
| PME | Tous les groupes de clients |
| Grands comptes | Tous les groupes de clients |
« Grands comptes Europe » a pour parent « Grands comptes », qui est plus bas dans le fichier et n'existe pas encore. L'import réussit quand même : Dokos crée d'abord « Grands comptes », puis « Grands comptes Europe ». (Exemple fictif.)
Vérifier l'arbre avant l'import
Lorsque vous importez un type de document arborescent, l'étape Aperçu propose une vue Tree (arbre) en plus de la vue Table. Elle représente visuellement la hiérarchie que Dokos va créer, en montrant les nœuds parents et leurs enfants imbriqués.
Cette prévisualisation vous permet de vérifier que la structure est bien interprétée avant de valider l'import. Les nœuds déjà présents en base de données apparaissent distincts des nouveaux nœuds à créer.
Corriger les erreurs sans modifier le fichier
Quand Dokos trouve des valeurs invalides (client inconnu, valeur de liste mal orthographiée…), vous pouvez les traiter dans l'étape Fix issues, sans modifier le fichier source.
Faire correspondre des valeurs
Quand une colonne de type Lien (ex. : Client, Article) ou de type Liste (ex. : Statut, Type) contient une valeur absente du système, Dokos affiche un avertissement dans l'étape Fix issues, avec la section Value Mappings.
Dans cette section, pour chaque valeur non reconnue, vous choisissez la valeur correcte dans le système :
| Valeur dans le fichier | Valeur dans Dokos |
|---|---|
Maison verte | Maison Verte SARL |
en cours | En cours |
Comment procéder :
- Joignez votre fichier dans l'étape Config.
- Dans l'étape Fix issues, ouvrez la section Value Mappings.
- Pour chaque valeur inconnue, choisissez la valeur correcte.
- Lancez l'import. Dokos remplace les valeurs pendant l'import.
Exemple fictif : la colonne « Client » de votre fichier contient « Bureau moderne ». Le client s'appelle « Bureau Moderne » dans Dokos. Au lieu de corriger le fichier, définissez la correspondance Bureau moderne → Bureau Moderne, puis lancez l'import.
Ignorer des lignes
Si certaines lignes de votre fichier contiennent des erreurs que vous ne souhaitez pas corriger immédiatement, vous pouvez les exclure de l'import sans modifier le fichier source.
Comment procéder :
- Dans l'étape Fix issues, repérez la ligne concernée. Le numéro de ligne du fichier est indiqué.
- Cliquez sur Skip Row pour cette ligne.
- Lancez l'import. Dokos traite seulement les lignes non ignorées.
Les lignes ignorées sont listées dans la section Skipped Rows. Le bouton Download Skipped Rows donne un fichier de ces lignes, pour les corriger et les importer plus tard.
Exemple fictif : votre fichier contient 500 articles, dont 3 avec un groupe d'articles inconnu. Ignorez ces 3 lignes, importez les 497 autres, puis corrigez les 3 lignes dans un second fichier.
Options d'import
| Option | Usage |
|---|---|
| Ne pas envoyer d'emails | Cochée par défaut. Bloque les e-mails pendant l'import, par exemple les notifications envoyées à chaque création de piste. |
| Valider après import | Pour les documents validables (commandes, factures…), valide chaque document après sa création. |
| Détecter le type de CSV et Délimiteurs personnalisés | Pour un fichier CSV dont le séparateur n'est pas la virgule (par exemple le point-virgule d'un export Excel français). |
Pour importer depuis Google Sheets, la feuille doit être publique. Vérifiez-le en ouvrant son URL dans une fenêtre de navigation privée.
Conseils
- Il n'y a pas de limite stricte au nombre de lignes. Importez plutôt quelques milliers de lignes à la fois : un très gros import (50 000 lignes) ralentit le site pour les autres utilisateurs.
- Enregistrez les fichiers CSV en UTF-8 pour garder les accents.
Types de documents importables
L'importation de données n'est pas disponible pour tous les types de documents. Seuls les types de documents configurés pour autoriser l'importation proposent l'option Importer dans le menu de leur liste.
Pour la liste des types importables de l'application RH, voir Importer des données RH.