[{"data":1,"prerenderedAt":831},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Fpersonnalisation\u002Fdonnees\u002Fimportation-donnees":3,"section:\u002Fnext\u002Fdodock\u002Fpersonnalisation\u002Fdonnees\u002Fimportation-donnees":830},{"id":4,"title":5,"body":6,"description":812,"extension":813,"meta":814,"navigation":815,"path":826,"seo":827,"stem":828,"__hash__":829},"docs\u002F2.next\u002F3.dodock\u002F03.personnalisation\u002F03.donnees\u002Fimportation-donnees.md","Importer des données",{"type":7,"value":8,"toc":776},"minimark",[9,13,22,25,39,44,47,69,75,81,85,88,112,126,137,140,144,147,152,187,191,202,206,209,212,219,223,226,230,233,236,240,258,267,271,277,281,284,306,310,324,331,339,350,354,361,365,370,374,380,384,387,398,405,409,412,432,435,438,442,459,462,466,469,476,480,495,503,506,520,523,532,535,538,558,571,575,584,620,623,629,633,636,658,671,675,678,711,714,718,740,744],[10,11,5],"h1",{"id":12},"importer-des-données",[14,15,16,17,21],"p",{},"L'",[18,19,20],"strong",{},"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.",[14,23,24],{},":::info Prérequis",[26,27,28,32],"ul",{},[29,30,31],"li",{},"Avoir le droit d'import sur le type de document.",[29,33,34,35,38],{},"Avoir un fichier au format du modèle d'import. Téléchargez ce modèle à l'étape ",[18,36,37],{},"Config",".\n:::",[40,41,43],"h2",{"id":42},"ouvrir-lassistant-dimport","Ouvrir l'assistant d'import",[14,45,46],{},"L'assistant d'import est accessible depuis la liste d'un type de document :",[48,49,50,57,63],"ol",{},[29,51,52,53,56],{},"Ouvrez la liste d'un type de document, par exemple ",[18,54,55],{},"Client",".",[29,58,59,60,56],{},"Cliquez sur la flèche du bouton ",[18,61,62],{},"Ajouter",[29,64,65,66,56],{},"Choisissez ",[18,67,68],{},"Importer",[14,70,71,72,74],{},"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 ",[18,73,68],{}," ouvre le même assistant.",[14,76,77,78,80],{},"L'entrée ",[18,79,68],{}," n'apparaît que pour les types de documents qui autorisent l'import, et si vous avez le droit d'import.",[40,82,84],{"id":83},"fonctionnement-général","Fonctionnement général",[14,86,87],{},"L'assistant d'import comporte quatre étapes successives :",[48,89,90,95,101,107],{},[29,91,92,94],{},[18,93,37],{}," : choisir le type d'import et téléverser le fichier.",[29,96,97,100],{},[18,98,99],{},"Aperçu"," : vérifier les données lues.",[29,102,103,106],{},[18,104,105],{},"Corriger les problèmes"," : traiter les avertissements et ignorer des lignes.",[29,108,109,111],{},[18,110,68],{}," : lancer l'import et suivre son avancement.",[113,114,115],"mermaid",{},[116,117,123],"pre",{"className":118,"code":120,"language":121,"meta":122},[119],"language-text","flowchart LR\n  A[Config\u003Cbr\u002F>Téléverser le fichier] --> B[Aperçu\u003Cbr\u002F>Visualiser les données]\n  B --> C{Fix issues\u003Cbr\u002F>Avertissements ?}\n  C -- Oui --> D[Traiter les avertissements]\n  D --> B\n  C -- Non --> E[Importer\u003Cbr\u002F>Lancer et suivre]\n","text","",[124,125,120],"code",{"__ignoreMap":122},[14,127,128,129,132,133,136],{},"Passez d'une étape à l'autre avec les boutons ",[18,130,131],{},"Retour"," et ",[18,134,135],{},"Suivant",". Vous pouvez aussi cliquer sur une étape déjà atteinte dans la barre des étapes.",[14,138,139],{},"Si vous rouvrez un import enregistré, l'assistant reprend à l'étape où il s'était arrêté.",[40,141,143],{"id":142},"_1-config","1. Config",[14,145,146],{},"La première étape sert à déclarer le fichier à importer.",[148,149,151],"h3",{"id":150},"téléverser-un-fichier","Téléverser un fichier",[48,153,154,173,176],{},[29,155,156,157,160,161,164,165,168,169,172],{},"Choisissez le ",[18,158,159],{},"Type d'import"," : ",[18,162,163],{},"Insérer des nouvelles données"," (défaut), ",[18,166,167],{},"Mettre à jour des données existantes"," ou ",[18,170,171],{},"Insérer ou mettre à jour des enregistrements",". Ce choix ne change plus après l'enregistrement de l'import.",[29,174,175],{},"Glissez-déposez votre fichier dans la zone de téléversement, ou cliquez dessus pour choisir un fichier.",[29,177,178,179,182,183,186],{},"Le fichier doit être au format Excel ",[124,180,181],{},".xlsx"," ou CSV ",[124,184,185],{},".csv",". La taille maximale est indiquée sous la zone.",[148,188,190],{"id":189},"fichier-local-ou-google-sheets","Fichier local ou Google Sheets",[14,192,193,194,197,198,201],{},"L'onglet ",[18,195,196],{},"Fichier"," accepte un fichier depuis votre poste. L'onglet ",[18,199,200],{},"Google Sheet"," accepte l'URL d'une feuille Google Sheets accessible publiquement en lecture.",[148,203,205],{"id":204},"type-de-document-et-modèle","Type de document et modèle",[14,207,208],{},"L'assistant reprend automatiquement le type de document depuis lequel vous avez ouvert l'import. Vous pouvez le modifier avant de poursuivre.",[14,210,211],{},"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.",[14,213,214,215,218],{},":::tip Astuce\nCliquez sur ",[18,216,217],{},"Télécharger un modèle"," à cette étape pour obtenir un fichier au format attendu.\n:::",[40,220,222],{"id":221},"_2-aperçu","2. Aperçu",[14,224,225],{},"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.",[148,227,229],{"id":228},"tableau","Tableau",[14,231,232],{},"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.",[14,234,235],{},":::warning Colonne manquante\nSi 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.\n:::",[148,237,239],{"id":238},"vue-arborescente","Vue arborescente",[14,241,242,243,246,247,250,251,254,255,257],{},"Pour les types de documents arborescents — comme le ",[18,244,245],{},"Plan comptable",", les ",[18,248,249],{},"Catégories d'article"," ou les ",[18,252,253],{},"Centres de coûts"," — l'aperçu bascule automatiquement en ",[18,256,239],{},". Vous y retrouvez la hiérarchie parent-enfant telle qu'elle sera créée dans Dokos.",[14,259,260,261,132,264,56],{},"Utilisez le sélecteur en haut de l'aperçu pour basculer entre ",[18,262,263],{},"Table",[18,265,266],{},"Arbre",[40,268,270],{"id":269},"_3-fix-issues","3. Fix issues",[14,272,273,274,276],{},"L'étape ",[18,275,105],{}," 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.",[148,278,280],{"id":279},"traiter-un-avertissement","Traiter un avertissement",[14,282,283],{},"Pour chaque avertissement :",[26,285,286,296,303],{},[29,287,288,289,168,293,56],{},"Le message indique la nature du problème, par exemple ",[290,291,292],"em",{},"Valeur obligatoire manquante",[290,294,295],{},"Valeur introuvable",[29,297,298,299,302],{},"Lorsque le problème concerne une ligne, le bouton ",[18,300,301],{},"Ignorer la ligne"," exclut la ligne de l'import sans la supprimer du fichier.",[29,304,305],{},"S'il ne reste aucun avertissement, l'assistant affiche « Aucun problème à corriger » et vous pouvez continuer.",[148,307,309],{"id":308},"table-de-correspondance-des-valeurs","Table de correspondance des valeurs",[14,311,312,313,315,316,319,320,323],{},"Certains champs de référence — comme un ",[18,314,55],{},", un ",[18,317,318],{},"Fournisseur"," ou un ",[18,321,322],{},"Article"," — peuvent nécessiter une correspondance entre une valeur présente dans le fichier et une valeur existante dans Dokos.",[14,325,326,327,330],{},"La table des ",[18,328,329],{},"Correspondances de valeurs"," se présente sous forme de grille. Renseignez pour chaque valeur source la valeur Dokos correspondante :",[26,332,333,336],{},[29,334,335],{},"Les valeurs sont automatiquement recherchées dans Dokos.",[29,337,338],{},"Si aucune correspondance n'est trouvée, vous pouvez saisir manuellement la valeur cible.",[14,340,341,342,345,346,349],{},"Exemple fictif : votre fichier contient ",[290,343,344],{},"Maison Verte"," comme nom de client, mais le client est enregistré sous le nom ",[290,347,348],{},"Maison Verte SARL"," dans Dokos. Renseignez la correspondance pour que l'import associe les deux écritures.",[148,351,353],{"id":352},"ignorer-une-ligne","Ignorer une ligne",[14,355,356,357,360],{},"Une ligne ignorée n'est pas importée mais reste visible dans l'aperçu. Pour la réintégrer, cliquez sur ",[18,358,359],{},"Annuler l'exclusion"," à cette même étape.",[40,362,364],{"id":363},"_4-importer","4. Importer",[14,366,273,367,369],{},[18,368,68],{}," lance l'import et vous permet d'en suivre son exécution en direct.",[148,371,373],{"id":372},"lancer-limport","Lancer l'import",[14,375,376,377,379],{},"Cliquez sur ",[18,378,68],{}," pour démarrer le traitement. Dokos exécute l'import en arrière-plan sans bloquer l'interface.",[148,381,383],{"id":382},"suivi-en-direct","Suivi en direct",[14,385,386],{},"Pendant l'exécution, l'écran affiche :",[26,388,389,392,395],{},[29,390,391],{},"le nombre de lignes traitées sur le total, mis à jour en continu ;",[29,393,394],{},"l'activité récente : chaque ligne traitée apparaît avec son statut (succès, échec ou ignorée) ;",[29,396,397],{},"une barre de progression.",[14,399,400,401,404],{},"Le bouton ",[18,402,403],{},"Annuler l'importation"," arrête la tâche en cours.",[148,406,408],{"id":407},"filtrer-le-journal","Filtrer le journal",[14,410,411],{},"Une fois l'import terminé, le journal reprend l'ensemble des opérations :",[26,413,414,420,426],{},[29,415,416,419],{},[18,417,418],{},"All"," : toutes les lignes traitées ;",[29,421,422,425],{},[18,423,424],{},"Success"," : les lignes importées ;",[29,427,428,431],{},[18,429,430],{},"Failed"," : les lignes en échec, avec le message d'erreur.",[14,433,434],{},"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 »).",[14,436,437],{},"Chaque entrée du journal indique le numéro de ligne concerné et le motif du succès ou de l'échec.",[148,439,441],{"id":440},"que-faire-en-cas-déchec","Que faire en cas d'échec ?",[48,443,444,450,453,456],{},[29,445,446,447,449],{},"Filtrez le journal sur ",[18,448,430],{}," pour identifier les lignes en erreur.",[29,451,452],{},"Téléchargez ces lignes avec le bouton « Télécharger les lignes en échec » du résumé.",[29,454,455],{},"Corrigez-les dans le fichier téléchargé.",[29,457,458],{},"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.",[14,460,461],{},":::warning Imports sans identifiant\nSi 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.\n:::",[40,463,465],{"id":464},"importer-des-données-dans-une-table-enfant","Importer des données dans une table enfant",[14,467,468],{},"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.",[14,470,471,472,475],{},":::info Prérequis\nL'option d'import n'apparaît que sur les tables enfant dont le champ a la case ",[18,473,474],{},"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.\n:::",[148,477,479],{"id":478},"ouvrir-limport-dune-table-enfant","Ouvrir l'import d'une table enfant",[48,481,482,485,488],{},[29,483,484],{},"Ouvrez le formulaire contenant la table enfant, par exemple une facture.",[29,486,487],{},"Repérez la grille de la table enfant.",[29,489,490,491,494],{},"Cliquez sur le bouton ",[18,492,493],{},"Charger"," sous la grille.",[14,496,400,497,499,500,502],{},[18,498,493],{}," n'apparaît que si le champ de la table a la case ",[18,501,474],{}," cochée, et seulement si la table est modifiable dans le document.",[14,504,505],{},"Le serveur vérifie les permissions sur le document parent :",[26,507,508,514],{},[29,509,510,513],{},[18,511,512],{},"Lecture"," pour télécharger un modèle ;",[29,515,516,519],{},[18,517,518],{},"Écriture"," pour lire le fichier ou la feuille Google Sheets, puis pour importer les lignes.",[148,521,217],{"id":522},"télécharger-un-modèle",[14,524,525,526,528,529,56],{},"Depuis la première étape de l'assistant, cliquez sur ",[18,527,217],{}," 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 ",[124,530,531],{},"Numéro (phone)",[14,533,534],{},":::warning Compatibilité des modèles\nL'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.\n:::",[14,536,537],{},"Vous pouvez choisir le contenu du modèle :",[26,539,540,546,552],{},[29,541,542,545],{},[18,543,544],{},"Toutes les données"," — inclut les lignes déjà présentes dans la table enfant.",[29,547,548,551],{},[18,549,550],{},"5 entrées"," — inclut les cinq premières lignes de la table enfant.",[29,553,554,557],{},[18,555,556],{},"Modèle vide"," — un en-tête seul, sans données.",[14,559,560,561,564,565,168,568,56],{},"Un sélecteur de champs permet de choisir les colonnes à inclure : ",[18,562,563],{},"Tout sélectionner",", ",[18,566,567],{},"Sélectionner les champs obligatoires",[18,569,570],{},"Tout déselectionner",[148,572,574],{"id":573},"étapes-de-limport","Étapes de l'import",[14,576,577,578,580,581,583],{},"L'assistant d'une table enfant comporte trois étapes. Le bouton ",[18,579,135],{}," fait passer à l'étape suivante, le bouton ",[18,582,131],{}," revient à l'étape précédente.",[48,585,586,598,612],{},[29,587,588,591,592,594,595,597],{},[18,589,590],{},"Upload"," (titre « Upload » suivi du nom de la table) — choisissez le ",[18,593,159],{},", puis sélectionnez un fichier CSV ou Excel depuis votre ordinateur ou la bibliothèque de fichiers. L'onglet ",[18,596,200],{}," accepte à la place l'URL d'une feuille Google Sheets accessible publiquement.",[29,599,600,603,604,607,608,611],{},[18,601,602],{},"Fix Issues"," — les lignes contenant des erreurs s'affichent pour correction. Vous pouvez modifier les cellules, changer la correspondance d'une colonne (ou choisir ",[18,605,606],{},"Ne pas importer","), ignorer une ligne ou toutes les lignes en erreur. Si les erreurs sont trop nombreuses, le bouton ",[18,609,610],{},"Skip Invalid and Continue"," ignore les lignes en erreur et passe à l'aperçu.",[29,613,614,616,617,619],{},[18,615,99],{}," — vérifiez les données et le résumé, par exemple « 12 rows will be inserted. ». Cliquez sur ",[18,618,493],{}," : l'assistant se ferme et ajoute ou met à jour les lignes de la table enfant.",[14,621,622],{},"Les lignes ne sont pas encore enregistrées. Enregistrez le formulaire parent pour conserver les modifications.",[624,625,626],"note",{},[14,627,628],{},"Certains libellés de cet assistant ne sont pas encore traduits en français. La documentation les reprend tels qu'ils s'affichent.",[148,630,632],{"id":631},"types-dimport","Types d'import",[14,634,635],{},"L'assistant propose trois types d'import :",[26,637,638,643,651],{},[29,639,640,642],{},[18,641,163],{}," — ajoute les lignes importées à la table enfant, sans modifier les lignes existantes. Cette option est sélectionnée par défaut.",[29,644,645,647,648,56],{},[18,646,167],{}," — met à jour les lignes existantes identifiées par leur colonne ",[18,649,650],{},"ID",[29,652,653,647,655,657],{},[18,654,171],{},[18,656,650],{}," et ajoute les nouvelles lignes.",[14,659,660,661,663,664,168,666,668,669,38],{},":::warning Comportement d'ajout\nL'import de type ",[18,662,163],{}," 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 ",[18,665,167],{},[18,667,171],{}," avec la colonne ",[18,670,650],{},[148,672,674],{"id":673},"validation-et-correction","Validation et correction",[14,676,677],{},"L'assistant valide les données avant l'import :",[26,679,680,686,699],{},[29,681,682,685],{},[18,683,684],{},"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.",[29,687,688,691,692,132,695,698],{},[18,689,690],{},"Validation des liens"," — les valeurs des champs de type ",[18,693,694],{},"Lien",[18,696,697],{},"Sélection"," sont vérifiées par colonne en une seule requête.",[29,700,701,704,705,707,708,56],{},[18,702,703],{},"Validation structurelle"," — par exemple, la colonne ",[18,706,650],{}," doit être présente pour un import de type ",[18,709,710],{},"Mettre à jour",[14,712,713],{},"À 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.",[148,715,717],{"id":716},"limites","Limites",[26,719,720,723,726,737],{},[29,721,722],{},"Le modèle peut contenir jusqu'à 10 000 lignes.",[29,724,725],{},"L'import accepte jusqu'à 5 000 lignes par opération.",[29,727,728,729,564,731,132,733,736],{},"Seules les extensions ",[124,730,185],{},[124,732,181],{},[124,734,735],{},".xls"," sont acceptées.",[29,738,739],{},"Les champs en lecture seule et virtuels ne peuvent pas être importés.",[40,741,743],{"id":742},"conseils-dutilisation","Conseils d'utilisation",[26,745,746,752,761,770],{},[29,747,748,751],{},[18,749,750],{},"Toujours tester sur un échantillon"," : importez d'abord quelques lignes pour valider la structure du fichier, puis lancez l'import complet.",[29,753,754,757,758,760],{},[18,755,756],{},"Conserver l'identifiant"," : pour une mise à jour, le fichier doit contenir la colonne ",[18,759,650],{}," du document.",[29,762,763,766,767,769],{},[18,764,765],{},"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 ",[18,768,105],{}," pour ajuster les différences.",[29,771,772,775],{},[18,773,774],{},"Ne pas modifier les en-têtes"," : les noms de colonnes doivent rester strictement identiques à ceux du modèle d'export.",{"title":122,"searchDepth":777,"depth":778,"links":779},1,2,[780,781,782,788,792,797,803,811],{"id":42,"depth":778,"text":43},{"id":83,"depth":778,"text":84},{"id":142,"depth":778,"text":143,"children":783},[784,786,787],{"id":150,"depth":785,"text":151},3,{"id":189,"depth":785,"text":190},{"id":204,"depth":785,"text":205},{"id":221,"depth":778,"text":222,"children":789},[790,791],{"id":228,"depth":785,"text":229},{"id":238,"depth":785,"text":239},{"id":269,"depth":778,"text":270,"children":793},[794,795,796],{"id":279,"depth":785,"text":280},{"id":308,"depth":785,"text":309},{"id":352,"depth":785,"text":353},{"id":363,"depth":778,"text":364,"children":798},[799,800,801,802],{"id":372,"depth":785,"text":373},{"id":382,"depth":785,"text":383},{"id":407,"depth":785,"text":408},{"id":440,"depth":785,"text":441},{"id":464,"depth":778,"text":465,"children":804},[805,806,807,808,809,810],{"id":478,"depth":785,"text":479},{"id":522,"depth":785,"text":217},{"id":573,"depth":785,"text":574},{"id":631,"depth":785,"text":632},{"id":673,"depth":785,"text":674},{"id":716,"depth":785,"text":717},{"id":742,"depth":778,"text":743},"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.","md",{"reviewed":815,"last_verified":816,"sources":817},true,"2026-11-04",[818,819,820,821,822,823,824,825],"frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Flist\u002Flist_view.js","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fdata_import\u002Fdata_import_dialog.js","frappe\u002Fpublic\u002Fjs\u002Fdata_import_wizard.bundle.js","frappe\u002Fcore\u002Fdoctype\u002Fdata_import\u002Fdata_import.js","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fform\u002Fgrid.js","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fform\u002Fgrid_import.js","frappe\u002Fdesk\u002Fform\u002Fgrid_import.py","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fdata_import\u002Fdata_exporter.js","\u002Fnext\u002Fdodock\u002Fpersonnalisation\u002Fdonnees\u002Fimportation-donnees",{"title":5,"description":812},"2.next\u002F3.dodock\u002F03.personnalisation\u002F03.donnees\u002Fimportation-donnees","LPPHWNivJqyFXMkH4TkhwRCL61lsbqoefU3JaUApVyA",{},1795274590488]