Préparer votre fichier d’import

Un fichier d’import propre rend l’import beaucoup plus rapide et plus sûr.

La plupart des problèmes d’import sont des problèmes de préparation avant de devenir des problèmes Boldo.

Règles de format de base

Votre fichier doit suivre ces règles :

• utiliser le format .csv ou .xlsx
• mettre les noms de colonnes sur la première ligne
• utiliser une ligne par actif
• pour les fichiers CSV, garder un séparateur cohérent dans tout le fichier

Pour les fichiers CSV, Boldo peut généralement détecter les séparateurs courants :

• virgule
• point-virgule
• tabulation
• pipe

Choisir une bonne clé d’import

Avant d’importer, décidez comment Boldo doit faire correspondre chaque ligne avec un actif existant.

Boldo propose trois modes de correspondance :

• Par nom - Boldo fait correspondre les lignes en utilisant la colonne Name (ou Nom). Le nom doit être stable, non vide, unique et cohérent entre les imports.
• Par Boldo ID - Boldo fait correspondre les lignes en utilisant la colonne Boldo ID. C’est l’identifiant interne inclus lorsque vous exportez depuis Boldo. C’est la méthode de correspondance la plus fiable pour les allers-retours.
• Par clé unique - Boldo fait correspondre les lignes en utilisant une propriété de clé unique définie dans le métamodèle, comme un code produit ou une référence externe. Cette option n’apparaît que lorsque le type d’actif cible possède une propriété de clé unique.

Si votre fichier provient d’un export Boldo antérieur, il contient déjà une colonne Boldo ID. Boldo la détecte automatiquement pendant l’import.

Si vous importez des données depuis une source externe et que le type d’actif possède une propriété de clé unique, la correspondance par clé unique est le choix le plus sûr. La clé unique reste stable entre les systèmes, contrairement aux noms qui peuvent varier en orthographe ou en format.

Si le type d’actif ne possède pas de clé unique, utilisez la colonne Name (ou Nom). Assurez-vous que les noms sont suffisamment stables pour éviter des doublons accidentels.

Nettoyer les données

Avant d’importer :

• supprimez les lignes vides dupliquées
• normalisez l’orthographe pour les statuts et les listes
• retirez les espaces accidentels
• vérifiez les formats de date. Boldo accepte YYYY-MM-DD, YYYY/MM/DD, DD/MM/YYYY et DD-MM-YYYY pendant l’import.
• confirmez que les valeurs numériques sont bien numériques

Si une propriété peut contenir plusieurs valeurs dans une cellule :

• utilisez un séparateur cohérent
• documentez-le avant la mise en correspondance

Exemple :

Java, React, PostgreSQL

Une colonne de relation doit contenir la valeur utilisée pour retrouver l’actif lié.

Exemples :

• un nom d’équipe
• un nom d’application
• un nom de serveur

Quand une cellule contient plusieurs actifs liés, utilisez le séparateur attendu pendant la mise en correspondance.

Gardez les noms liés cohérents, sinon Boldo peut créer plusieurs actifs liés presque dupliqués.

Faites attention à ces erreurs courantes

Problème	Pourquoi cela pose problème
Ligne d’en-tête manquante	Boldo ne peut pas mettre correctement les colonnes en correspondance
Identifiants dupliqués	Le comportement de création et de mise à jour devient ambigu
Séparateurs mélangés	Les lignes sont mal interprétées
Mauvais encodage	Les caractères apparaissent corrompus
Valeurs de liste incohérentes	La mise en correspondance devient peu fiable

Méthode recommandée

Pour un premier import :

1. testez sur un petit échantillon
2. validez le résultat dans Boldo
3. corrigez la mise en correspondance si nécessaire
4. importez ensuite le fichier complet

Si votre fichier d’import porte le même nom que le type d’actif, Boldo peut présélectionner ce type d’actif automatiquement.

Si votre fichier d’import utilise les noms de colonnes attendus, Boldo peut aussi préremplir automatiquement les propriétés et relations correspondantes.

En pratique, le plus simple est souvent d’exporter un petit fichier depuis l’inventaire cible avec Actions > Exporter, puis de modifier ce fichier au lieu de repartir de zéro. Le fichier exporté inclut une colonne Boldo ID qui rend le ré-import fiable.

Avant de démarrer le vrai import, assurez-vous que :

• l’aperçu est lisible
• la colonne clé est complète et stable
• les propriétés importantes sont suffisamment propres pour être mises en correspondance avec confiance
• les colonnes de relation utilisent des noms cohérents

Continuez avec Importer un fichier quand le fichier est prêt. Si le résultat semble encore incorrect, utilisez Résoudre les problèmes d’import.