Importer des relations et leurs propriétés

Un import de relations vise des connexions individuelles. Utilisez-le pour renseigner leurs propriétés, distinguer des liens parallèles ou modifier une instance précise par son Boldo ID.

Vous devez avoir un compte Administrateur ou Propriétaire dans l’organisation. Vérifiez l’organisation et le contexte réel ou scénario. Pour les propriétés d’actifs, utilisez l’import d’actifs.

Charger le fichier et associer ses colonnes

Préparez un fichier par type de relation. Une création nécessite une source et une cible par ligne. Une relation existante peut être identifiée par son ID ou sa clé unique sans répéter ses deux extrémités.

1. Ouvrez Imports dans l’organisation et sélectionnez votre CSV ou XLSX.
2. Choisissez Relations, puis le type voulu. Vérifiez ensemble le type source, la relation et le type cible.
3. Associez la colonne Boldo ID de la relation si le fichier contient des identifiants existants.
4. Associez les colonnes source et cible, en choisissant leur mode d’identification : nom, ID ou clé unique.
5. Associez les propriétés de relation et leurs choix. Marquez les propriétés distinguant les instances parallèles lorsque nécessaire.
6. Associez Archivé uniquement si le fichier doit piloter l’archivage ou la restauration.
7. Relisez le traitement des relations existantes, des lignes dupliquées, des valeurs vides et des actifs manquants aux extrémités.
8. Sélectionnez Vérifier.

Sous la destination de chaque colonne, cliquez sur le récapitulatif des options pour ouvrir ses réglages. Selon la colonne, vérifiez la correspondance des valeurs, Résoudre par, le comportement si l’actif manque et Distingue les relations multiples.

Pour une propriété de date, vérifiez Format des dates dans les options de colonne ; l’interprétation des dates suit ce choix. Aucune valeur peut traiter les marqueurs du fichier comme du vide, selon le réglage des valeurs vides ci-dessous. Les règles de correspondance s’appliquent aussi aux propriétés de relation.

Chaque cellule d’extrémité identifie un seul actif. Les listes de cibles séparées par des virgules d’un import d’actifs ne sont pas interchangeables avec ce format.

Identifier chaque relation à mettre à jour

Un ID de relation existant est prioritaire. Il identifie la connexion elle-même, pas sa source ni sa cible. Si les extrémités sont également renseignées, elles doivent correspondre à cette instance. L’import ne déplace pas une connexion existante vers d’autres actifs.

Sans ID reconnu, une clé unique de relation configurée peut identifier l’instance. Une valeur inconnue de clé unique décrit une nouvelle instance, sans repli sur la connexion de mêmes source, type et cible. La création exige toujours des extrémités valides et le respect des contraintes d’unicité. Une instance archivée peut garder une valeur qu’une instance active porte désormais ; la valeur désigne alors l’instance active.

Sans clé unique renseignée, Boldo recherche la source, le type de relation et la cible. Les propriétés marquées Distingue les relations multiples précisent cette correspondance. Plusieurs instances actives correspondantes sans distinction suffisante bloquent l’aperçu.

Un ID de relation inconnu peut encore retrouver une instance existante grâce aux autres informations de correspondance. Il ne crée jamais d’instance sans correspondance ; la ligne est alors ignorée.

Par exemple, deux allocations entre la même application et la même capacité peuvent porter sur des périodes différentes. Pour changer une seule allocation, fournissez son ID de relation. Les seuls noms des extrémités n’identifient pas l’allocation voulue.

Traiter les données existantes

Le réglage des relations existantes permet de modifier les instances correspondantes, les ignorer, signaler une erreur ou créer une autre instance si le type accepte des propriétés. Un ID ou une clé unique continue d’identifier une instance existante. Choisir la création ne transforme pas cette identité explicite en doublon.

Pour les lignes dupliquées, choisissez la fusion ou le rejet. Ne supposez pas que chaque ligne du tableur produit une relation distincte : examinez l’aperçu. Les instances parallèles exigent toujours des propriétés saisies différentes et des clés uniques valides.

Ignorer les valeurs vides conserve les propriétés existantes. Écraser par une valeur vide efface les propriétés correspondantes laissées vides. Les nouvelles relations conservent, lorsqu’elles s’appliquent, les valeurs par défaut de leur type.

Pour une source ou cible manquante, la résolution par nom ou clé unique peut proposer Créer l’actif ou une erreur bloquante. Une création par clé unique utilise sa valeur comme nom. Un ID d’extrémité inconnu ne crée pas d’actif et peut faire ignorer la ligne.

Archiver et restaurer

Une valeur vraie dans Archivé demande l’archivage ; une valeur fausse demande la restauration. Vérifiez la correspondance des valeurs plutôt que de supposer que toutes les variantes de oui ou non sont reconnues.

Sans valeur d’archivage explicite, une relation archivée retrouvée est normalement restaurée lorsque les relations existantes sont traitées. Le choix d’ignorer les relations existantes la conserve, sauf si une valeur fausse explicite demande sa restauration.

Une valeur d’archivage explicite peut donc changer l’état de la relation même lorsque vous avez choisi d’ignorer les relations existantes. Relisez ces actions séparément des modifications de propriétés.

Échanger des clés uniques

Deux relations ne peuvent pas échanger directement leurs valeurs de clé unique dans le même import. Le contrôle bloque aussi les cycles entre plusieurs relations. Utilisez les Boldo ID pour conserver l’identité des relations pendant l’échange.

Par exemple, A porte CLE-A et B porte CLE-B :

1. Importez une valeur temporaire inutilisée pour A, puis vérifiez le résultat.
2. Préparez un second import : B reçoit CLE-A et A reçoit CLE-B.
3. Vérifiez l’aperçu, confirmez et contrôlez les deux relations.

Une restauration doit aussi respecter les clés conservées par l’archive, même si ces colonnes ne figurent pas dans le fichier. Corrigez une clé en conflit dans la ligne identifiée par le Boldo ID, ou libérez sa valeur avant de restaurer.

Confirmer l’import et vérifier le résultat

1. Lisez les compteurs de l’aperçu et dépliez les entrées concernées.
2. Rapprochez les numéros de lignes et les changements détaillés de votre fichier. Vérifiez les extrémités affichées, les actifs créés et les actions d’archivage ou de restauration.
3. Corrigez les instances ambiguës, les conflits de clés et les extrémités incompatibles. Relancez Vérifier après correction.
4. Sélectionnez Confirmer l’importation lorsque l’aperçu est correct.
5. Attendez le résultat final et ouvrez l’inventaire de relations.
6. Contrôlez quelques instances, leurs identifiants et leurs propriétés. Activez Voir les archives pour vérifier les relations archivées.

Les détails de l’aperçu peuvent être tronqués ; les compteurs peuvent dépasser le nombre de lignes visibles. Sans changement, le dialogue propose Fermer.

Les données sont vérifiées de nouveau à l’exécution. Un nouveau conflit peut empêcher l’import malgré un premier aperçu valide. En cas d’erreur ou d’interruption, inspectez le résultat avant de réessayer. Une erreur signalée après enregistrement ne prouve pas l’absence de changements.

Pour les commandes courantes de l’inventaire, consultez la gestion des relations. En cas de résultat inattendu, suivez le dépannage des imports.