Skip to main content

14.4 Assistant import

Créer un nouvel import

Allez dans Outils > Assistant import > Nouvel import. Étape 1 — Choisir le lot de données

Sélectionnez le module à importer (ex. Tiers) et cliquez sur l’icône Nouvel import.

Figure 14.14 – Étape 1 — Choix du lot de données à importer

Figure 14.14

Étape 2 — Choisir le format Cliquez sur le pictogramme en fin de ligne pour sélectionner le format de fichier à importer.

Astuce : Téléchargez un exemple vierge en cliquant sur Télécharger un exemple vierge de fichier pour créer votre fichier d’import dans le bon format.

Figure 14.15 – Étape 2 — Choix du format de fichier

Figure 14.15

Étape 3 — Envoyer le fichier Choisissez le fichier sur votre ordinateur et cliquez sur Ajouter pour l’envoyer sur Dolibarr. Cliquez ensuite sur le pictogramme en fin de ligne.

Figure 14.16 – Étape 3 — Envoi du fichier

Figure 14.16

Étape 4 — Mapper les champs La colonne de gauche affiche les champs du fichier importé ; la colonne de droite affiche les champs Dolibarr. Déplacez les champs par drag and drop (en saisissant la flèche) pour aligner chaque champ du fichier avec le champ Dolibarr correspondant. Les champs à ne pas importer doivent être déplacés sous la ligne Champs du fichier source non importé.

Astuce : Si un champ du fichier ne correspond à aucun champ Dolibarr, utilisez la ligne Aucun champ en face. En passant la souris sur le point d’interrogation en fin de ligne, vous obtenez les informations sur les valeurs attendues, contraintes et exemples.

Figure 14.17 – Étape 4 — Correspondance des champs

Figure 14.17

Étape 5 — Simulation puis import Cochez ou décochez Ne pas importer la première ligne du fichier source (si elle contient les en-têtes), puis cliquez sur Lancer la simulation de l’import. La simulation tente d’insérer en base en annulant toutes les opérations à la fin. Un rapport des erreurs est affiché.

Avertissement : Les erreurs lors de la simulation proviennent souvent de la première ligne si celle-ci correspond aux intitulés des champs. Décochez l’import de la première ligne dans ce cas.

Si aucune erreur n’est détectée, cliquez sur Lancer import final (définitif). Les données importées s’ajoutent aux données existantes.

Figure 14.18 – Étape 5 — Simulation de l’import

Figure 14.18

Figure 14.19 – Résultat de la simulation

Figure 14.19

Figure 14.20 – Résultat de l’import final

Figure 14.20

Astuce : Pays : pensez à ajouter une colonne pays avec la valeur 1 (France) car l’import ne met pas de pays par défaut. Traçabilité : toutes les données importées reçoivent le champ import_key avec la date de l’import. En cas de problème, retrouvez facilement les lignes dans votre éditeur SQL.

Options cachées

Figure 14.21 – Options cachées de l’import

Figure 14.21

Constante                                                          Effet
IMPORT_CSV_SEPARATOR_TO_USE                                        Délimiteur CSV (défaut : ,). Ex.
                                                                   IMPORT_CSV_SEPARATOR_TO_USE=;
IMPORT_CSV_FORCE_CHARSET                                           Encodage du fichier CSV (défaut :
                                                                   UTF-8). Ex.
                                                                   IMPORT_CSV_FORCE_CHARSET=ISO-8859-1