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.
Données

Importer des données

Importer en masse des documents depuis un fichier Excel, CSV ou Google Sheets, avec l'assistant en quatre étapes : configuration, aperçu, correction et import.

Importer des données

L'Import de données crée ou met à jour en masse des documents d'un type de document, à partir d'un fichier Excel, CSV ou d'une feuille Google Sheets. Un assistant en quatre étapes vous guide.

:::info Prérequis

  • Avoir le droit d'import sur le type de document.
  • Avoir un fichier au format du modèle d'import. Téléchargez ce modèle à l'étape Config. :::

Ouvrir l'assistant d'import

L'assistant d'import est accessible depuis la liste d'un type de document :

  1. Ouvrez la liste d'un type de document, par exemple Client.
  2. Cliquez sur la flèche du bouton Ajouter.
  3. Choisissez Importer.

L'assistant s'ouvre dans une grande boîte de dialogue, intitulée « Importer Client ». Vous pouvez la réduire pendant un import. Sur une liste vide, le bouton Importer ouvre le même assistant.

L'entrée Importer n'apparaît que pour les types de documents qui autorisent l'import, et si vous avez le droit d'import.

Fonctionnement général

L'assistant d'import comporte quatre étapes successives :

  1. Config : choisir le type d'import et téléverser le fichier.
  2. Aperçu : vérifier les données lues.
  3. Corriger les problèmes : traiter les avertissements et ignorer des lignes.
  4. Importer : lancer l'import et suivre son avancement.

Passez d'une étape à l'autre avec les boutons Retour et Suivant. Vous pouvez aussi cliquer sur une étape déjà atteinte dans la barre des étapes.

Si vous rouvrez un import enregistré, l'assistant reprend à l'étape où il s'était arrêté.

1. Config

La première étape sert à déclarer le fichier à importer.

Téléverser un fichier

  1. Choisissez le Type d'import : Insérer des nouvelles données (défaut), Mettre à jour des données existantes ou Insérer ou mettre à jour des enregistrements. Ce choix ne change plus après l'enregistrement de l'import.
  2. Glissez-déposez votre fichier dans la zone de téléversement, ou cliquez dessus pour choisir un fichier.
  3. Le fichier doit être au format Excel .xlsx ou CSV .csv. La taille maximale est indiquée sous la zone.

Fichier local ou Google Sheets

L'onglet Fichier accepte un fichier depuis votre poste. L'onglet Google Sheet accepte l'URL d'une feuille Google Sheets accessible publiquement en lecture.

Type de document et modèle

L'assistant reprend automatiquement le type de document depuis lequel vous avez ouvert l'import. Vous pouvez le modifier avant de poursuivre.

Le fichier comporte une ligne d'en-tête, puis une colonne par champ à renseigner. L'en-tête identifie le champ de chaque colonne.

:::tip Astuce Cliquez sur Télécharger un modèle à cette étape pour obtenir un fichier au format attendu. :::

2. Aperçu

L'étape d'aperçu présente les données lues par Dokos avant tout lancement. Elle permet de vérifier que les colonnes correspondent bien aux champs attendus et que les valeurs sont correctement interprétées.

Tableau

Les données s'affichent sous forme de tableau. Chaque colonne correspond à un champ du type de document, chaque ligne à un document à créer ou modifier.

:::warning Colonne manquante Si une colonne attendue n'est pas présente dans votre fichier, Dokos signale le champ et lève un avertissement. Vous pouvez corriger votre fichier, le téléverser de nouveau et reprendre l'import. :::

Vue arborescente

Pour les types de documents arborescents — comme le Plan comptable, les Catégories d'article ou les Centres de coûts — l'aperçu bascule automatiquement en Vue arborescente. Vous y retrouvez la hiérarchie parent-enfant telle qu'elle sera créée dans Dokos.

Utilisez le sélecteur en haut de l'aperçu pour basculer entre Table et Arbre.

3. Fix issues

L'étape Corriger les problèmes regroupe les avertissements détectés durant l'aperçu. Chaque avertissement concerne soit une ligne, soit une colonne, et est accompagné d'un message explicite.

Traiter un avertissement

Pour chaque avertissement :

  • Le message indique la nature du problème, par exemple Valeur obligatoire manquante ou Valeur introuvable.
  • Lorsque le problème concerne une ligne, le bouton Ignorer la ligne exclut la ligne de l'import sans la supprimer du fichier.
  • S'il ne reste aucun avertissement, l'assistant affiche « Aucun problème à corriger » et vous pouvez continuer.

Table de correspondance des valeurs

Certains champs de référence — comme un Client, un Fournisseur ou un Article — peuvent nécessiter une correspondance entre une valeur présente dans le fichier et une valeur existante dans Dokos.

La table des Correspondances de valeurs se présente sous forme de grille. Renseignez pour chaque valeur source la valeur Dokos correspondante :

  • Les valeurs sont automatiquement recherchées dans Dokos.
  • Si aucune correspondance n'est trouvée, vous pouvez saisir manuellement la valeur cible.

Exemple fictif : votre fichier contient Maison Verte comme nom de client, mais le client est enregistré sous le nom Maison Verte SARL dans Dokos. Renseignez la correspondance pour que l'import associe les deux écritures.

Ignorer une ligne

Une ligne ignorée n'est pas importée mais reste visible dans l'aperçu. Pour la réintégrer, cliquez sur Annuler l'exclusion à cette même étape.

4. Importer

L'étape Importer lance l'import et vous permet d'en suivre son exécution en direct.

Lancer l'import

Cliquez sur Importer pour démarrer le traitement. Dokos exécute l'import en arrière-plan sans bloquer l'interface.

Suivi en direct

Pendant l'exécution, l'écran affiche :

  • le nombre de lignes traitées sur le total, mis à jour en continu ;
  • l'activité récente : chaque ligne traitée apparaît avec son statut (succès, échec ou ignorée) ;
  • une barre de progression.

Le bouton Annuler l'importation arrête la tâche en cours.

Filtrer le journal

Une fois l'import terminé, le journal reprend l'ensemble des opérations :

  • All : toutes les lignes traitées ;
  • Success : les lignes importées ;
  • Failed : les lignes en échec, avec le message d'erreur.

Le nombre de lignes de chaque filtre s'affiche entre parenthèses. Le résumé propose aussi de télécharger les lignes en échec (« Télécharger les lignes en échec »).

Chaque entrée du journal indique le numéro de ligne concerné et le motif du succès ou de l'échec.

Que faire en cas d'échec ?

  1. Filtrez le journal sur Failed pour identifier les lignes en erreur.
  2. Téléchargez ces lignes avec le bouton « Télécharger les lignes en échec » du résumé.
  3. Corrigez-les dans le fichier téléchargé.
  4. Lancez un nouvel import avec ce fichier. Il ne contient que les lignes à reprendre, ce qui évite de recréer les lignes déjà importées.

:::warning Imports sans identifiant Si votre fichier ne comporte pas d'identifiant unique pour chaque ligne, Dokos ne peut pas déterminer si une ligne a déjà été importée. Un nouvel import risque alors de créer des doublons. :::

Importer des données dans une table enfant

Un tableau enfant est une grille intégrée à un formulaire, par exemple les lignes d'articles d'une facture ou les numéros de téléphone d'un contact. Certaines tables enfant autorisent l'import en masse depuis un fichier Excel ou CSV, avec un assistant dédié semblable à celui des imports de documents.

:::info Prérequis L'option d'import n'apparaît que sur les tables enfant dont le champ a la case Autoriser les modifications en masse cochée dans le type de document. Vous devez posséder un fichier structuré selon le modèle d'import de la table enfant. :::

Ouvrir l'import d'une table enfant

  1. Ouvrez le formulaire contenant la table enfant, par exemple une facture.
  2. Repérez la grille de la table enfant.
  3. Cliquez sur le bouton Charger sous la grille.

Le bouton Charger n'apparaît que si le champ de la table a la case Autoriser les modifications en masse cochée, et seulement si la table est modifiable dans le document.

Le serveur vérifie les permissions sur le document parent :

  • Lecture pour télécharger un modèle ;
  • Écriture pour lire le fichier ou la feuille Google Sheets, puis pour importer les lignes.

Télécharger un modèle

Depuis la première étape de l'assistant, cliquez sur Télécharger un modèle pour obtenir un modèle d'import au format Excel ou CSV. Le modèle comporte une ligne d'en-tête unique : chaque colonne est identifiée par le libellé du champ suivi de son nom technique entre parenthèses, par exemple Numéro (phone).

:::warning Compatibilité des modèles L'en-tête du modèle comporte une seule ligne. Les anciens modèles à en-tête de sept lignes ne sont pas reconnus. Téléchargez un nouveau modèle. :::

Vous pouvez choisir le contenu du modèle :

  • Toutes les données — inclut les lignes déjà présentes dans la table enfant.
  • 5 entrées — inclut les cinq premières lignes de la table enfant.
  • Modèle vide — un en-tête seul, sans données.

Un sélecteur de champs permet de choisir les colonnes à inclure : Tout sélectionner, Sélectionner les champs obligatoires ou Tout déselectionner.

Étapes de l'import

L'assistant d'une table enfant comporte trois étapes. Le bouton Suivant fait passer à l'étape suivante, le bouton Retour revient à l'étape précédente.

  1. Upload (titre « Upload » suivi du nom de la table) — choisissez le Type d'import, puis sélectionnez un fichier CSV ou Excel depuis votre ordinateur ou la bibliothèque de fichiers. L'onglet Google Sheet accepte à la place l'URL d'une feuille Google Sheets accessible publiquement.
  2. Fix Issues — les lignes contenant des erreurs s'affichent pour correction. Vous pouvez modifier les cellules, changer la correspondance d'une colonne (ou choisir Ne pas importer), ignorer une ligne ou toutes les lignes en erreur. Si les erreurs sont trop nombreuses, le bouton Skip Invalid and Continue ignore les lignes en erreur et passe à l'aperçu.
  3. Aperçu — vérifiez les données et le résumé, par exemple « 12 rows will be inserted. ». Cliquez sur Charger : l'assistant se ferme et ajoute ou met à jour les lignes de la table enfant.

Les lignes ne sont pas encore enregistrées. Enregistrez le formulaire parent pour conserver les modifications.

Certains libellés de cet assistant ne sont pas encore traduits en français. La documentation les reprend tels qu'ils s'affichent.

Types d'import

L'assistant propose trois types d'import :

  • Insérer des nouvelles données — ajoute les lignes importées à la table enfant, sans modifier les lignes existantes. Cette option est sélectionnée par défaut.
  • Mettre à jour des données existantes — met à jour les lignes existantes identifiées par leur colonne ID.
  • Insérer ou mettre à jour des enregistrements — met à jour les lignes existantes identifiées par leur colonne ID et ajoute les nouvelles lignes.

:::warning Comportement d'ajout L'import de type Insérer des nouvelles données ajoute les lignes importées à celles déjà présentes dans la table enfant. Il ne remplace pas les lignes existantes. Pour modifier des lignes existantes, utilisez Mettre à jour des données existantes ou Insérer ou mettre à jour des enregistrements avec la colonne ID. :::

Validation et correction

L'assistant valide les données avant l'import :

  • Validation des types de champs — les dates, durées, notes et numéros de téléphone sont vérifiés selon le format attendu.
  • Validation des liens — les valeurs des champs de type Lien et Sélection sont vérifiées par colonne en une seule requête.
  • Validation structurelle — par exemple, la colonne ID doit être présente pour un import de type Mettre à jour.

À l'étape de correction, seules les lignes en erreur s'affichent. Vous pouvez corriger les cellules directement dans le tableau, remapper une colonne non reconnue ou ignorer une ligne. Une colonne ignorée n'est pas importée mais reste visible dans l'aperçu.

Limites

  • Le modèle peut contenir jusqu'à 10 000 lignes.
  • L'import accepte jusqu'à 5 000 lignes par opération.
  • Seules les extensions .csv, .xlsx et .xls sont acceptées.
  • Les champs en lecture seule et virtuels ne peuvent pas être importés.

Conseils d'utilisation

  • Toujours tester sur un échantillon : importez d'abord quelques lignes pour valider la structure du fichier, puis lancez l'import complet.
  • Conserver l'identifiant : pour une mise à jour, le fichier doit contenir la colonne ID du document.
  • Vérifier les valeurs de référence : les champs liés (Client, Fournisseur, Article, etc.) doivent correspondre à des valeurs déjà existantes dans Dokos. Utilisez la table de correspondance de l'étape Corriger les problèmes pour ajuster les différences.
  • Ne pas modifier les en-têtes : les noms de colonnes doivent rester strictement identiques à ceux du modèle d'export.