Imports de masse

Suite à une installation neuve de Dolibarr, les bases sont vides. Parfois on désire démarrer avec des données importées d'un autre système. Il existe plusieurs méthodes possibles. Les chapitres suivante présentes quelques informations pour vous y aider. Les informations sur l'export sont décrites sur la page Module Exports. Attention, si l'objectif est d'importer depuis une autre base Dolibarr, ce n'est pas l'import/export de masse qu'il faut utiliser (dédiés aux imports/exports avec d'autres systèmes), mais les procédures de Sauvegardes et Restaurations.

= Utiliser le module Import de Dolibarr = La méthode recommandée pour vos imports est l'utilisation du Module Imports de Dolibarr. Elle offre un assistant qui vous guide dans les différentes étapes. Voir la page Module Imports pour plus d'informations.

Pour les cas non prévus par ce module générique, les autres méthodes décrites ci-dessous sont également opérationnelles.

= Utiliser OpenOffice = Vous pouvez utiliser OpenOffice qui est capable d'injecter le contenu d'un tableau dans la base une base de donnée Mysql comme celle de Dolibarr. Voici un tutorial sur cette méthode : Importer des données avec OpenOffice

= Développer son propre script d'import =

Import des tiers et contacts
Il faut distinguer les tiers des contacts physiques. Dans les tiers on aura toutes les entités sujettes à facturation (aussi bien entreprises, association que particuliers). Les tiers sont obligatoires. Les contacts physiques sont optionnels. Il s'agit juste d'un annuaire de personnes (avec téléphone et fonction) liées à un tiers. Dans le cas d'un tiers entreprise, il pourra y avoir plusieurs contacts physiques. Dans le cas d'un particulier, le contact physique sera unique et identique au tiers (voire le contact physique ne sera pas renseigné).

L'import des tiers consiste à insérer des lignes dans la table Table llx_societe. S'assurer que les champs importants sont bien renseignés:
 * Nom: Doit contenir le nom de la société
 * Client: Doit contenir 1 si client, 2 si prospect, 0 sinon
 * Fournisseur: Doit contenir 1 si fournisseur, 0 sinon

L'import des contacts physiques consiste à insérer des lignes dans la table Table llx_socpeople. S'assurer que les champs importants sont bien renseignés:
 * Name: Doit contenir le nom de la personne
 * Firstname: Doit contenir le prénom de la société
 * fk_soc: Doit contenir l'id de la ligne Tiers dans la Table llx_societe.

Import des factures
A compléter

Import des produits ou services
L'import des tiers consiste à insérer des lignes dans la table Table llx_product. S'assurer que les champs importants sont bien renseignés:
 * Ref: Doit contenir la référence courte du produit
 * Nom: Doit contenir le libellé du produit
 * Type: Doit contenir 0 pour un produit, 1 pour un service

Mise en pratique
La page Développement de scripts vous explique comment créer votre propre script de traitement Dolibarr.

Quelques didacticiels/exemples soumis par la communauté
Des scripts exemples sont disponibles avec la distribution snapshot de Dolibarr dans le répertoire /dev/samples.

D'autres exemples sont soumis par des contributeurs:
 * Importer des clients en automatique