Préparer votre fichier CSV
Un fichier CSV 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 - mettre les noms de colonnes sur la première ligne
- utiliser une ligne par actif
- garder un séparateur cohérent dans tout le fichier
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, vérifiez que votre fichier contient une colonne Name stable.
Pour l’instant, le parcours d’import fait correspondre les lignes par le nom de l’actif.
Cette colonne doit donc être :
- stable dans le temps
- non vide
- unique
- cohérente dans les imports futurs
Si les noms ne sont pas assez stables, corrigez d’abord le fichier avant d’importer.
Utilisez une colonne Name stable pour la correspondance pendant l’import.
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
- 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 :
- testez sur un petit échantillon
- validez le résultat dans Boldo
- corrigez la mise en correspondance si nécessaire
- importez ensuite le fichier complet
Si votre CSV porte le même nom que le type d’actif, Boldo peut présélectionner ce type d’actif automatiquement.
Si votre CSV 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 très petit CSV depuis l’inventaire cible avec Actions > Exporter en CSV, puis de modifier ce fichier au lieu de repartir de zéro.
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 CSV quand le fichier est prêt. Si le résultat semble encore incorrect, utilisez Résoudre les problèmes d’import CSV.