DeltiaAide

Importer des composants dans le catalogue

Choisir le type d'import, télécharger le modèle CSV, déposer le fichier et corriger les erreurs de ligne signalées

À quoi ça sert

Reprendre une bibliothèque de prix existante — un tableur de main d'œuvre, une liste de fournitures, un bordereau de sous-traitance — sans ressaisir chaque poste un par un.

L'assistant d'import lit un fichier CSV et crée un composant par ligne dans le catalogue de composants. Il se déroule en trois étapes : choisir le type d'import, récupérer le modèle de fichier, puis déposer le fichier rempli. Les erreurs de format sont signalées ligne par ligne avant tout enregistrement.

L'import ne crée que des composants. Les ouvrages, eux, se construisent depuis le catalogue : voir Catalogue d'ouvrages.

Concepts clés

  • Modèle — le fichier CSV d'exemple fourni par l'application, avec la ligne d'en-tête attendue et quatre lignes d'illustration.
  • Séparateur — le caractère qui sépare les colonnes du fichier. L'assistant le détecte seul et affiche celui qu'il a retenu.
  • Colonnes détectées — les en-têtes lus dans votre fichier, affichés pour contrôle avant l'import.
  • Erreur de validation — une ligne dont la désignation manque ou dont le type n'est pas reconnu. Tant qu'il en reste une, l'import est bloqué.

Comment faire

Ouvrir l'assistant d'import

  1. Dans le menu, ouvrez « Chiffrage » puis « Catalogue ».
  2. Cliquez sur le bouton « + » situé en haut à droite du bloc de liste.
  3. Choisissez « Importer ».

Étape 1 — choisir le type d'import

  1. L'écran affiche « Étape 1/3: Sélection du type d'import ».
  2. Laissez « Importer des composants » sélectionné.
  3. Cliquez sur « Suivant ».

L'option « Importer des ouvrages + composants » est présentée mais inactive, avec la mention « Prochainement disponible ».

Étape 2 — télécharger le modèle

  1. L'écran affiche « Étape 2/3: Téléchargement du modèle ».
  2. Cliquez sur « Télécharger le modèle (.csv) ». Le fichier modele_composants.csv est enregistré sur votre poste.
  3. Ouvrez-le, remplacez les lignes d'exemple par vos données, enregistrez-le au format CSV.
  4. Revenez dans l'assistant et cliquez sur « Suivant ».

Le bouton « Précédent » ramène à l'étape 1.

Étape 3 — déposer le fichier et lancer l'import

  1. L'écran affiche « Étape 3/3: Import du fichier ».
  2. Cliquez sur la zone « Glissez-déposez votre fichier ici » et choisissez votre fichier.
  3. Vérifiez ce que l'assistant affiche sous « Fichier sélectionné : » — le « Séparateur détecté : » et les « Colonnes détectées : ».
  4. Contrôlez l'aperçu : les cinq premières lignes lues sont affichées, suivies de « + {count} lignes supplémentaires ».
  5. Si un bloc « Erreurs de validation » apparaît, corrigez le fichier, puis cliquez sur « Précédent » et « Suivant » avant de le redéposer. Le bouton « Importer » reste inactif tant qu'une erreur subsiste.
  6. Cliquez sur « Importer ».

Le volet se ferme et le message « Les composants ont été importés » s'affiche. La liste du catalogue se rafraîchit : chaque composant importé apparaît dans la vue de son type. En cas d'échec, le message est « Les composants n'ont pas été importés ».

Le bouton « Précédent » ramène à l'étape 2 et vide le fichier déjà déposé, avec son aperçu et ses erreurs. C'est le seul moyen de repartir d'une lecture propre : déposer un second fichier sans revenir en arrière ajoute ses lignes et ses erreurs à celles du premier.

Référence

Colonnes du modèle

Ligne d'en-tête du fichier modele_composants.csv :

Désignation;Type (MO|FRS|MAT|ST);Unité;Prix unitaire d'achat;Prix unitaire de vente;Catégorie

ColonneObligatoireContenu attendu
DésignationOuiLe nom du composant
TypeOuiMO, FRS, MAT ou ST
UnitéNonh, ml, m², j…
Prix unitaire d'achatNonNombre ; la virgule et le point sont acceptés
Prix unitaire de venteNonNombre ; la virgule et le point sont acceptés
CatégorieNonLibellé libre, partagé avec les ouvrages

Les codes de type correspondent aux libellés du catalogue : MO pour « Main d'œuvre », FRS pour « Fourniture », MAT pour « Matériel », ST pour « Sous-traitance ».

En-têtes reconnus

Les intitulés de colonnes sont reconnus sans tenir compte de la casse, des accents ni des espaces, et plusieurs variantes sont acceptées :

DonnéeVariantes acceptées
Désignationdesignation, nom, libelle, description
Typetype, type composant, types
Unitéunite, unites, unit, u
Prix d'achatprix unitaire d'achat, prix achat, pa, cout
Prix de venteprix unitaire de vente, prix vente, pv, prix
Catégoriecategorie, categories, cat, famille

Une colonne absente du fichier laisse la donnée vide sur le composant créé.

Erreurs signalées

MessageCause
« Impossible de détecter automatiquement le séparateur du fichier CSV. Veuillez vérifier le format du fichier. »Le séparateur de colonnes n'a pas pu être identifié
« Séparateur CSV non détectable. Vérifiez le format du fichier. »Même cause, message affiché en notification
« Aucune donnée trouvée dans le fichier. »Le fichier ne contient aucune ligne exploitable
« Format de fichier non valide. Veuillez télécharger et utiliser le modèle fourni. »Le fichier n'a pas pu être lu
« {count} erreur(s) de parsing détectée(s). »Des lignes n'ont pas pu être découpées en colonnes
« La désignation est requise »Une ligne sans désignation
« Veuillez d'abord importer un fichier valide. »L'import est lancé sans fichier

Les erreurs de ligne sont listées sous « Erreurs de validation », précédées de « Ligne {row}: » suivi du champ en cause. Le numéro compte les lignes de données, la ligne d'en-tête n'étant pas comptée : « Ligne 1 » désigne la première ligne sous les en-têtes.

Comportements automatiques

  • Un composant dont la désignation existe déjà au catalogue est ignoré. La comparaison ne tient compte ni de la casse ni des espaces de début et de fin. Aucun composant existant n'est écrasé ni modifié par un import.
  • Les prix sont lus indifféremment avec une virgule ou un point comme séparateur décimal, et les espaces sont ignorés.
  • Toutes les lignes valides du fichier sont importées, quel que soit le type des composants : l'import ne dépend pas de la vue affichée au moment où vous l'avez lancé.

Questions fréquentes

Puis-je importer un fichier Excel ?

Non. L'assistant lit des fichiers CSV, et le modèle fourni est au format CSV. Enregistrez votre tableur au format CSV avant de le déposer.

Puis-je mettre à jour des prix existants par un import ?

Non. Un import ne fait que créer des composants, et il ignore les désignations déjà présentes. Pour changer un prix, ouvrez le composant depuis le catalogue et modifiez-le. Voir Catalogue de composants.

Puis-je importer des ouvrages avec leur décomposition ?

Pas pour l'instant. L'option existe dans la première étape mais elle est inactive et porte la mention « Prochainement disponible ».

Que se passe-t-il si mon fichier contient un type inconnu ?

La ligne est signalée dans « Erreurs de validation » et l'import reste bloqué tant qu'elle n'est pas corrigée. Seuls MO, FRS, MAT et ST sont acceptés.

Sur cette page