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)
Les lignes avec un ID non correspondant et aucun nom correspondant sont ignorées	Le mode Boldo ID ne crée jamais de nouveaux actifs	Ajoutez ou corrigez la colonne Name ou Nom si l’actif existe déjà, ou passez à la correspondance par nom ou par clé unique si vous avez aussi besoin de créer des actifs
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

Messages affichés avant la validation

Boldo bloque l’import tant que la configuration de correspondance est incomplète. Ces messages apparaissent sous le tableur :

Message	Ce qu’il signifie
Choisissez une colonne comme clé pour faire correspondre les lignes à des actifs existants	Aucune colonne de correspondance choisie
La colonne clé sélectionnée n’est pas dans le fichier	Le fichier ne contient plus la colonne de correspondance
La propriété clé unique sélectionnée n'existe plus. Choisissez un autre type de clé.	La propriété de clé unique a été supprimée ou remplacée dans le métamodèle
Aucune colonne nom mappée : les lignes sans correspondance seront ignorées. Mappez une colonne comme « Nom » pour créer de nouveaux actifs.	En mode clé unique, sans colonne Name ou Nom, l’import peut seulement mettre à jour les actifs, pas en créer

Les erreurs de cellule (par exemple Le nom ne peut pas contenir de virgule) apparaissent sur les cellules concernées. Le bas du tableur les compte et garde Vérifier désactivé tant qu’elles ne sont pas corrigées.

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é.