Difference between revisions of "Module Imports FR"

Latest revision as of 07:39, 8 September 2023

Imports
Numéro/ID du module	250
Doc utilisateur du module	Cette page
Doc développeur du module	Cette page

Introduction

Pour importer des données dans Dolibarr, il existe plusieurs méthodes. Cette page décrit la méthode utilisant le module d'import. Les autres méthodes d'imports sont décrites sur la page Imports de masse

Installation

Ce module est livré en standard avec la distribution de Dolibarr, aussi il est déjà installé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Voir également la page Paramétrage_Divers, pour modifier le séparateur et le charset des fichiers CSV d'import/export.

Utilisation

Pour importer un fichier:

Aller dans le menu Outils - Nouvel import.
Etape 1: Consiste à choisir le type d'import. Sélectionner le en cliquant sur le bouton en fin de ligne.
Etape 2: Cliquer ensuite sur le bouton en fin de ligne pour choisir le format de fichier que vous voulez importer. Rem: Vous pouvez en télécharger un en cliquant sur "Télécharger un exemple vierge de fichier".
Etape 3: Choisir le fichier à importer qui est sur votre ordinateur et cliquez sur ajouter pour l'envoyer sur Dolibarr. Une fois le fichier transférer, cliquer sur le bouton en fin de ligne pour passer à l'étape suivante.
Etape 4: Dans la colonne de gauche se trouve les champs trouvés dans votre fichier soumis. A droite se trouve les champs dans Dolibarr. Déplacer les champs de la colonne de gauche en les montant ou descendant par un drag and drop depuis la flêche, afin que chaque champ du fichier d'entrée se trouve devant la ligne du champ Dolibarr. Si un champ du fichier d'entrée ne doit pas être importé, il faut le déplacer en bas sous la ligne "Champs du fichier source non importé".

Rem: En fin de ligne, en passant la souris au dessus du point d'interrogation, vous pouvez avoir des informations sur les valeurs attendus à mettre dans le champ Dolibarr, avec contraintes et éventuellement exemples de valeurs. Une fois la correspondance terminée, cliquer sur "Etape suivante".

Etape 5: Chocher ou décocher la case "Ne pas importer la première ligne du fichier source", puis cliquer sur "Lancer la simulation de l'import". La simulation va tenter d'insérer en base en annulant les opérations à la fin. Un rapport des erreurs est ensuite affichés. Si il n'y a pas d'erreur, il est possible de cliquer sur "Lancer import final" qui lui sera définif. Les données importées sont ajoutées aux existantes.
Toutes les données importés dans dolibarr le sont avec le champ import_key à une valeur qui correspond à la date de l'import. En cas de problème détecté après coup, vous pourrez avec un éditeur SQL retrouver aisément les lignes en question.

Problèmes connus

Les problèmes suivants sont possibles avec la version 3.1. Ils sont corrigés avec les versions supérieures.

Import des tiers :

Non affichage des tiers après un import avec le module, il est neccessaire de modifier le statut prospect (llx_societe.fk_stcomm) de NULL à '0' (besoin de détail à propos des valeurs possibles, la clé étrangère correspond elle à la table 'llx_c_stcomm' ?).

Exemple de requête SQL à passer après l'import pour corriger le problème :

UPDATE `llx_societe` SET `fk_stcomm` = '0' WHERE fk_stcomm IS NULL

Import des produits :

Non affichage des produits après un import avec le module, il est neccessaire de modifier le type de produit (llx_product.fk_product_type) de NULL à '0' (besoin de détail à propos des valeurs possibles).

Exemple de requête SQL à passer après l'import pour corriger le problème :

UPDATE `llx_product` SET `fk_product_type` = '0' WHERE fk_product_type IS NULL

Exemples de cas d'utilisation

UCMI01:
Situation	J'ai un fichier Excel avec 3000 produits. Je veux les importer dans Dolibarr.
Actions	Aller dans le menu Outils -> Assistant import -> Nouvel import et choisir Produits et services.

UCMI02:
Situation	J'ai un fichier texte de 1000 prospects. Je veux les importer dans Dolibarr.
Actions	Aller dans le menu Outils -> Assistant import -> Nouvel import et choisir Tiers

Copies écrans

Etape1

@@ Line 1: / Line 1: @@
+<!-- BEGIN interlang links -->
+<!-- Do NOT edit this section
+     Links below are automatically managed by PolyglotBot
+     You can edit links on the English source page : Module_Imports -->
+[[en:Module_Imports]]
+[[es:Módulo_Importaciones]]
+[[zh:导入模块]]
+<!-- END interlang links -->
 [[Category:Admin]]
 [[Category:Imports]]
@@ Line 10: / Line 19: @@
 = Introduction =
-Pour importe des données dans Dolibarr, il existe plusieurs méthode. Cette page décrit la méthode utilisant le module d'import.
+Pour importer des données dans Dolibarr, il existe plusieurs méthodes. Cette page décrit la méthode utilisant le module d'import.
 Les autres méthodes d'imports sont décrites sur la page [[Imports de masse]]
@@ Line 19: / Line 28: @@
 {{ActivationModuleFr}}
-Il est à noter, lors de la création du fichier CVS, l'importance des champs obligatoires.
+Voir également la page [[Paramétrage_Divers]], pour modifier le séparateur et le charset des fichiers CSV d'import/export.
-Voici un descriptif détaillé des champs :
-Le séparateur est la , et il vaut mieux encadrer les champs par des "
+= Utilisation =
-Exemple : "Sofie Durant","SD","1","0",...
+Pour importer un fichier:
+* Aller dans le menu Outils - Nouvel import.
+* Etape 1: Consiste à choisir le type d'import. Sélectionner le en cliquant sur le bouton en fin de ligne.
+* Etape 2: Cliquer ensuite sur le bouton en fin de ligne pour choisir le format de fichier que vous voulez importer. Rem: Vous pouvez en télécharger un en cliquant sur "Télécharger un exemple vierge de fichier".
+* Etape 3: Choisir le fichier à importer qui est sur votre ordinateur et cliquez sur ajouter pour l'envoyer sur Dolibarr. Une fois le fichier transférer, cliquer sur le bouton en fin de ligne pour passer à l'étape suivante.
+* Etape 4: Dans la colonne de gauche se trouve les champs trouvés dans votre fichier soumis. A droite se trouve les champs dans Dolibarr. Déplacer les champs de la colonne de gauche en les montant ou descendant par un drag and drop depuis la flêche, afin que chaque champ du fichier d'entrée se trouve devant la ligne du champ Dolibarr. Si un champ du fichier d'entrée ne doit pas être importé, il faut le déplacer en bas sous la ligne "Champs du fichier source non importé".
+Rem: En fin de ligne, en passant la souris au dessus du point d'interrogation, vous pouvez avoir des informations sur les valeurs attendus à mettre dans le champ Dolibarr, avec contraintes et éventuellement exemples de valeurs.
+Une fois la correspondance terminée, cliquer sur "Etape suivante".
+* Etape 5: Chocher ou décocher la case "Ne pas importer la première ligne du fichier source", puis cliquer sur "Lancer la simulation de l'import". La simulation va tenter d'insérer en base en annulant les opérations à la fin. Un rapport des erreurs est ensuite affichés. Si il n'y a pas d'erreur, il est possible de cliquer sur "Lancer import final" qui lui sera définif. Les données importées sont ajoutées aux existantes.
+* Toutes les données importés dans dolibarr le sont avec le champ import_key à une valeur qui correspond à la date de l'import. En cas de problème détecté après coup, vous pourrez avec un éditeur SQL retrouver aisément les lignes en question.
+= Problèmes connus =
+Les problèmes suivants sont possibles avec la version 3.1. Ils sont corrigés avec les versions supérieures.
-Descriptif du champs (note) "exemple"
+* Import des tiers :
-_____________________
-Nom ou raison sociale : "Sofie Durant"
+Non affichage des tiers après un import avec le module, il est neccessaire de modifier le statut prospect (llx_societe.fk_stcomm) de NULL à '0' (besoin de détail à propos des valeurs possibles, la clé étrangère correspond elle à la table 'llx_c_stcomm' ?).
-Préfixe (5 caractères max, ne doit pas contenir de doublon !) : "SD"
-est un client (voir note) : "0"
-est un fournisseur : "0" ou "1" (0 pour non 1 pour oui)
-Date de Creation (AAAA-MM-JJ) : "2010-04-16"
-Code client : "CU01-0001"
-Code fournisseur : "SU01-0001"
-Addresse
-Code postal
-Ville
-Numéro de téléphone (15 caractère max)
-Numero de fax (15 caractère max)
-Site web
-Adresse email
-N° siret
-N° Siren
-Code APE
-RCS/RM : "Perpignan"
-N° TVA Intra
-Capital
-Remarque
-Type (voir note)
-Effectif (voir note)
-Forme juridique (voir fichier joint nommé "forme_juridique.xls")
-Niveau du prospect (voir note) => A VALIDER car non testé (dansle doute laisser vide)
-Status du prospect (OBLIGATOIRE ! Le laissé vide bloque l'affichage du tier dans la liste globale) (voir note)
+Exemple de requête SQL à passer après l'import pour corriger le problème :
+<source lang="sql">UPDATE `llx_societe` SET `fk_stcomm` = '0' WHERE fk_stcomm IS NULL</source>
+* Import des produits :
-NOTES
+Non affichage des produits après un import avec le module, il est neccessaire de modifier le type de produit (llx_product.fk_product_type) de NULL à '0' (besoin de détail à propos des valeurs possibles).
-_____
-- Clien
+Exemple de requête SQL à passer après l'import pour corriger le problème :
-: est ni client ni prospect
+<source lang="sql">UPDATE `llx_product` SET `fk_product_type` = '0' WHERE fk_product_type IS NULL</source>
-: est client
-: est prospect
-: est client et prospect
-- Type
+= Exemples de cas d'utilisation =
-: Inconnue
+{{ExamplesCaseEn
-: Grand groupe
+|name=UCMI01:
-: PME/PMI
+|situation=J'ai un fichier Excel avec 3000 produits. Je veux les importer dans Dolibarr.
-: TPE
+|actions=Aller dans le menu Outils -> Assistant import -> Nouvel import et choisir Produits et services.
-: Administration
+}}&nbsp;
-: Grossite
-: Revendeur
-: Particulier
-: Autres
-- Effectif
+{{ExamplesCaseEn
-: Pas d'effectif
+|name=UCMI02:
-: entre 1 et 5 salariés
+|situation=J'ai un fichier texte de 1000 prospects. Je veux les importer dans Dolibarr.
-: entre 6 et 10 salariés
+|actions=Aller dans le menu Outils -> Assistant import -> Nouvel import et choisir Tiers
-: entre 11 et 50 salariés
+}}&nbsp;
-: entre 51 et 100 salariés
-: entre 100 et 500 salariés
-: plus de 500 salariés
-- Niveau du prospect
-PL_HIGH : Haut
-PL_LOW : Faible
-PL_MEDIUM : Moyen
-PL_NONE : Aucun
-- Status du prospect
--1 : Ne pas contacter
-: Jamais contacté
-: A contacter
-: Contact en cours
-: Contactée
-= Exemples de cas d'utilisation =
-{{ToComplete}}
+=Copies écrans=
-{{ExamplesCaseFr
+Etape1
-|nom=UCMI01:
+[[File:Nouvel_import_-_2018-Etape1.jpg]]
-|situation=
-|actions=
-}}&nbsp;