Préparer un fichier d’import
Un import associe les colonnes d’un tableur à un type d’actif ou de relation existant. Préparer les identifiants et les valeurs permet de modifier les bons éléments sans créer de doublons involontaires.
Utilisez un fichier distinct par type d’actif ou de relation. L’import de données ne crée pas de types ni de propriétés dans le métamodèle.
Partir d’un modèle
Vous devez avoir un compte Administrateur ou Propriétaire dans l’organisation pour accéder aux imports.
- Ouvrez les paramètres de l’organisation et sélectionnez Imports.
- Sous Téléchargez un template vierge :, choisissez un type d’actif ou de relation.
- Ouvrez Comment remplir pour lire les colonnes, les choix et les contraintes attendus.
- Fermez l’aide et sélectionnez CSV ou XLSX.
- Ouvrez le fichier téléchargé et ajoutez vos données sous les en-têtes.
- Enregistrez une copie de travail en conservant les identifiants d’origine.
Le modèle d’actifs contient Name, Owner, les propriétés saisissables et les colonnes de relations. Ces deux en-têtes restent en anglais, même dans l’interface française. Les propriétés calculées et masquées sont exclues.
Un modèle de relations contient le Boldo ID de la relation, sa source, sa cible, ses propriétés saisissables et Archivé. Laissez l’identifiant de relation vide pour créer une instance. Pour une mise à jour, utilisez l’identifiant de l’instance existante.
Choisir les identifiants
Le nom d’un actif le décrit ; son Boldo ID identifie l’enregistrement. Une propriété de type clé unique peut l’identifier entre systèmes, si votre organisation en a configuré une.
| Opération souhaitée | Préparation |
|---|---|
| Créer des actifs | Renseignez les noms et les propriétés à remplir. |
| Mettre à jour par nom | Conservez les noms existants. Un autre nom peut créer un actif supplémentaire. |
| Renommer un actif | Utilisez son Boldo ID existant ou sa clé unique stable, avec le nouveau nom. |
| Modifier une relation précise | Privilégiez son Boldo ID, surtout en présence de relations parallèles. |
| Créer des relations | Identifiez une source et une cible par ligne, avec des propriétés distinguant les instances parallèles. |
Conservez les identifiants au format texte dans Excel. Cela préserve les zéros initiaux et évite la conversion des longues valeurs en notation scientifique. N’inventez pas de Boldo ID pour de nouveaux éléments.
L’identifiant choisi pour l’import doit être renseigné. Dans un import d’actifs, une ligne dont la clé est vide est ignorée, même si son nom est présent. Consultez les règles de correspondance avant de mélanger créations et mises à jour.
Organiser les colonnes et les lignes du fichier
Boldo accepte les fichiers CSV et XLSX. Convertissez les anciens formats Excel en XLSX avant de les charger. Placez les en-têtes sur la première ligne et donnez un nom distinct à chaque colonne utile.
Pour XLSX, Boldo lit le premier onglet. Déplacez-y les données ou enregistrez un classeur séparé. Les colonnes sans en-tête sont ignorées, les en-têtes répétés sont renommés et les lignes entièrement vides sont écartées. Vérifiez les colonnes obtenues plutôt que de compter sur ces corrections.
Pour CSV, UTF-8 préserve les accents. Boldo peut détecter virgules, points-virgules, tabulations et barres verticales comme séparateurs de colonnes. Si les colonnes sont incorrectes, renseignez Délimiteur. Si les accents sont altérés, vérifiez Encodage ; ISO-8859-1 et windows-1252 sont également proposés.
Le délimiteur entre colonnes est distinct de celui d’une cellule contenant plusieurs valeurs. Un CSV séparé par des points-virgules peut contenir SaaS,Mobile dans une cellule de liste multiple. Utilisez l’export CSV du tableur pour protéger correctement les cellules contenant séparateurs ou retours à la ligne.
Formater les valeurs
Consultez Comment remplir pour le type choisi : longueurs maximales, bornes des scores et choix disponibles dépendent de la configuration de votre organisation.
| Valeur | Exemple et format attendu |
|---|---|
| Date | 2026-10-01 ou 2026/10/01 ; les formes jour/mois ou mois/jour suivent le Format des dates de la colonne. |
| Nombre ou devise | 1234.50 ou 1234,50, sans symbole monétaire ni unité. |
| Score | Un entier dans les bornes configurées pour la propriété. |
| Liste ou oui/non | Des valeurs cohérentes, puis une vérification de leur association aux choix de Boldo. |
| Liste multiple | Valeurs séparées par le délimiteur de cellule configuré, une virgule par défaut. |
| Texte enrichi | Markdown, comme **Important**, plutôt que du balisage copié depuis une page. |
| Propriétaires | Adresses email de membres de l’organisation, séparées par le délimiteur de cellule configuré. |
| Actifs liés dans un import d’actifs | Noms, identifiants ou clés uniques correspondant au mode choisi pour la colonne. |
Pour les dates, ouvrez les options de colonne et vérifiez Format des dates : jj/mm/aaaa ou mm/jj/aaaa. Les barres obliques et les tirets sont acceptés. Boldo propose le mois en premier seulement si des valeurs non ambiguës le justifient, sans valeur indiquant l’ordre inverse. Sinon, il propose le jour en premier : vérifiez les dates ambiguës comme 03/04/2026. Les dates commençant par l’année gardent le même sens dans les deux modes. Cela concerne les propriétés d’actifs et de relations.
Pour les champs oui/non, Boldo associe automatiquement true, vrai, oui, yes, 1 et x à vrai. Il associe false, faux, non, no et 0 à faux, sans tenir compte de la casse, des accents et des espaces autour des valeurs. Cela concerne les propriétés d’actifs et de relations. Vérifiez l’association proposée et affectez vous-même les autres valeurs.
Dans un import autonome de relations, chaque cellule source ou cible identifie un seul actif. Ce n’est pas une liste de cibles.
Par exemple, un fichier d’actifs peut contenir :
Name;Editor;Yearly Licence;TSA End date
Portail client;Fournisseur exemple;1234.50;2026-10-01
Ces noms de propriétés sont des exemples. Utilisez ceux de votre propre modèle et vérifiez le mappage détecté.
Vérifier le fichier avant de l’importer
- Confirmez le type contenu dans le fichier et le premier onglet à lire.
- Vérifiez les identifiants, les lignes en double, les dates et les choix.
- Retirez les colonnes inutiles, notamment un nom indésirable lors d’une mise à jour par ID ou clé unique.
- Décidez si les cellules vides doivent conserver ou effacer les propriétés existantes.
- Décidez si les colonnes de relations complètent ou remplacent les liens existants.
- Commencez par un petit fichier représentatif et examinez son aperçu.
Une colonne reconnue comme nom peut fournir un nom ou une correspondance de repli lors d’un import par ID ou clé unique. Retirez une colonne indésirable plutôt que de supposer qu’un nom non mappé n’a aucun effet.
Poursuivez avec l’import d’actifs ou l’import de relations. Pour un fichier volumineux, utilisez des lots maîtrisés et vérifiez chaque résultat avant de continuer.