Résoudre les problèmes d’import

Quand un import ne produit pas le résultat attendu, le problème vient généralement du format, de la correspondance ou de l’association des colonnes.

Utilisez cette page quand l’import s’exécute techniquement mais que le résultat est incorrect, incomplet ou surprenant. L’aperçu d’import affiché avant l’exécution détecte bon nombre de ces problèmes en amont - examinez-le attentivement avant de confirmer.

Si vous avez besoin de reprendre le parcours complet, revenez à Préparer votre fichier d’import ou Importer un fichier.

Problèmes courants

Problème	Cause probable	Ce qu’il faut vérifier
L’aperçu semble cassé	Mauvais séparateur ou encodage	Changez le séparateur ou l’encodage à l’étape de configuration
Des lignes sont ignorées	Valeurs de clé de correspondance vides	Vérifiez la colonne clé (Name ou Boldo ID)
Des actifs sont dupliqués	Les valeurs de clé ne sont pas stables ou pas uniques	Revérifiez les valeurs de la colonne clé. Envisagez la correspondance par Boldo ID pour plus de fiabilité
Des propriétés sont vides	Mauvaise association de colonne	Revoyez les associations dans les en-têtes de colonnes du tableur
Les valeurs de liste sont ignorées	Les valeurs du fichier ne correspondent pas aux valeurs Boldo	Revoyez les associations de valeurs dans l’en-tête de colonne
Les relations manquent	Mauvaise association de relation ou mauvais séparateur	Revoyez l’association de relation et le délimiteur par colonne
Des relations sont supprimées de façon inattendue	Des cellules de relation vides combinées au mauvais réglage de relations manquantes	Vérifiez Relations manquantes et Valeurs vides dans les paramètres d’import
Collision de noms détectée	Renommage d’un actif vers un nom déjà utilisé	Corrigez les noms en conflit dans le fichier
Limite d’actifs dépassée	L’import dépasserait le quota d’actifs du plan	Supprimez des lignes ou contactez votre administrateur

Si les caractères semblent corrompus

Cela concerne les fichiers CSV. Essayez un autre encodage, par exemple :

• UTF-8
• ISO-8859-1
• Windows-1252

Les fichiers XLSX gèrent l’encodage en interne, donc ce problème ne s’applique pas.

Si trop de nouveaux actifs sont créés

Cela signifie généralement que Boldo n’a pas pu faire correspondre les lignes avec des actifs existants.

Vérifiez :

• la colonne clé utilisée pour la correspondance (Name ou Boldo ID)
• l’orthographe exacte des valeurs Name si la correspondance se fait par nom
• si les noms ont changé entre deux imports

Si les noms ne sont pas assez stables, passez à la correspondance par Boldo ID. Exportez l’inventaire courant pour obtenir un fichier avec la colonne Boldo ID, puis utilisez cette colonne comme clé de correspondance au ré-import.

Si les valeurs de liste ou oui/non ne correspondent pas

Revoyez l’association manuelle pour :

• les valeurs à choix unique
• les valeurs à choix multiple
• les valeurs oui/non

Les valeurs du fichier doivent correspondre explicitement aux valeurs définies dans le métamodèle.

Si les relations ne sont pas créées correctement

Vérifiez :

• la colonne de relation cible
• les noms d’actifs liés utilisés dans les cellules
• le séparateur quand plusieurs actifs liés sont stockés dans une même cellule

Si une cellule contient plusieurs valeurs liées, utilisez le séparateur attendu de façon cohérente.

Vérifiez aussi le réglage Relations manquantes :

• Conserver les relations manquantes préserve les relations existantes quand le fichier ne les mentionne pas
• Supprimer les relations manquantes supprime les relations existantes absentes du fichier pour cette colonne de relation mappée

Comment diagnostiquer

Vérifiez les problèmes dans cet ordre :

1. format du fichier (.csv ou .xlsx)
2. valeurs de la colonne clé utilisées pour la correspondance
3. association des colonnes dans les en-têtes du tableur
4. association des valeurs pour les listes et les champs oui/non
5. association des relations et délimiteurs

Si le résultat reste flou :

1. arrêtez l’import complet
2. réduisez le fichier à un petit échantillon
3. corrigez un problème à la fois
4. relancez l’import de l’échantillon
5. seulement ensuite, relancez le fichier complet

Cela est presque toujours plus rapide que de déboguer après coup un gros import cassé.