Aller au contenu principal

Archiver et restaurer des actifs

L'archivage retire un actif de la base de connaissances active sans le supprimer définitivement. L'actif conserve son identifiant, ses propriétés, son historique, ses domaines d'accès et ses références jusqu'à sa restauration ou sa suppression définitive. Les archives se gèrent séparément dans l'inventaire de chaque type d'actif.

Comprendre le cycle

Un actif peut passer par trois états.

ÉtatSignificationActions disponibles
ActifL'actif apparaît dans l'inventaire et peut alimenter les visualisationsModifier ou archiver
ArchivéL'actif est conservé hors de l'inventaire actifConsulter, restaurer ou supprimer définitivement
Supprimé définitivementL'actif et ses données conservées sont retirésAucune récupération

L'archivage est l'action normale de retrait. La suppression définitive est une action distincte, disponible uniquement après l'archivage.

Droits nécessaires

Les archives utilisent les mêmes règles de type d'actif et de domaine d'accès que les actifs non archivés. Quand plusieurs rôles et domaines correspondent, le droit effectif le plus élevé s'applique.

ActionType minimalDroit sur l'actif
Ouvrir le contrôle des archivesÉditeurLes résultats restent filtrés par view_asset
Archiver un actifÉditeurdelete_asset
Restaurer un actifÉditeuredit_asset
Supprimer définitivement un actifÉditeurdelete_asset

Le droit est évalué pour le type d'actif et les domaines d'accès portés par chaque actif. Pour un actif sans domaine, Boldo utilise la ligne système Aucun domaine d'accès.

Sur les plans sans gouvernance granulaire, le type d'utilisateur global contrôle ces actions. Les éditeurs, administrateurs et propriétaires reçoivent les droits de gestion correspondants.

Pour le modèle complet, lisez Comprendre le modèle d'accès.

Archiver des actifs

Vous pouvez archiver un actif depuis le menu de sa ligne ou sa fenêtre de modification.

  1. Ouvrez Inventaires et sélectionnez le type d'actif
  2. Ouvrez le menu Actions de l'actif, ou sa fenêtre de modification
  3. Depuis le menu Actions, sélectionnez Supprimer ; dans la fenêtre de modification, cliquez sur l'icône corbeille (Supprimer) dans le pied
  4. Consultez l'éventuel avertissement sur son utilisation dans des tableaux de bord
  5. Confirmez

Malgré le libellé Supprimer, cette première action déplace l'actif dans les archives. Elle ne le supprime pas définitivement.

Pour archiver plusieurs actifs :

  1. Utilisez l'affichage tableau
  2. Activez la sélection multiple
  3. Sélectionnez les actifs
  4. Cliquez sur Supprimer dans la barre de sélection
  5. Vérifiez les actifs que vos droits vous autorisent à archiver
  6. Confirmez

Les actifs pour lesquels vous n'avez pas delete_asset restent actifs et apparaissent séparément dans la fenêtre de confirmation.

L'archivage enregistre l'opération dans l'historique et mémorise la date d'archivage. Il désactive aussi les relations actives de l'actif. Ces relations restent conservées pour une éventuelle restauration.

Après que la fenêtre de confirmation a écarté les actifs que vos droits ne permettent pas d'archiver, l'opération en masse envoyée est tout-ou-rien. Si un actif envoyé échoue, aucun n'est archivé. Le même comportement transactionnel s'applique à la restauration et à la suppression définitive en masse.

Consulter les archives

Les archives sont disponibles dans l'inventaire de chaque type d'actif. Il n'existe pas de page unique qui regroupe tous les types.

  1. Ouvrez Inventaires et sélectionnez un type d'actif
  2. Cliquez sur Voir les archives dans la barre du tableau
  3. Cliquez de nouveau sur ce contrôle pour revenir aux actifs non archivés

La liste archivée conserve les outils de la vue courante. Vous pouvez rechercher, filtrer, trier, regrouper, modifier les champs visibles et changer le mode d'affichage. Le tableau ajoute aussi une colonne Archivé le et une option de tri équivalente.

Utilisez les filtres habituels pour isoler les actifs archivés selon leurs propriétés, domaines, dates de création ou de mise à jour et autres champs disponibles. La date d'archivage est disponible comme colonne et option de tri, mais pas comme filtre. La recherche porte uniquement sur les actifs archivés du type courant. Les résultats respectent toujours vos droits view_asset effectifs et vos domaines d'accès.

Les actifs archivés sont en lecture seule. La modification des cellules, la conversion en diagramme, la création et les actions de mise à jour sont indisponibles dans ce mode. Ouvrez l'aperçu ou la page Actif 360 pour consulter les informations, relations visibles, diagrammes, droits, historique et commentaires.

La page Actif 360 archivée affiche les relations conservées lorsque l'autre extrémité est active. Une relation entre deux actifs archivés reste stockée, mais peut ne s'afficher sur aucune des deux pages archivées tant qu'une extrémité n'est pas restaurée.

Restaurer des actifs

La restauration réactive le même actif. Elle conserve son identifiant, ses propriétés, son historique, ses domaines et ses références.

Pour restaurer un actif :

  1. Ouvrez son inventaire archivé
  2. Ouvrez le menu Actions de sa ligne
  3. Sélectionnez Restaurer
  4. Confirmez

Vous pouvez aussi ouvrir la page Actif 360 de l'actif archivé et cliquer sur Restaurer dans l'en-tête.

Pour restaurer plusieurs actifs :

  1. Utilisez l'affichage tableau des archives
  2. Activez la sélection multiple
  3. Sélectionnez les actifs
  4. Cliquez sur Restaurer
  5. Vérifiez les actifs éligibles et ignorés
  6. Confirmez

Les actifs pour lesquels vous n'avez pas edit_asset sont ignorés. Après la restauration, les autres actifs quittent les archives et reviennent dans leur inventaire actif. La restauration est enregistrée dans l'historique de chaque actif.

Les relations désactivées par l'archivage sont restaurées quand les deux actifs reliés sont actifs. Si l'autre actif reste archivé, la relation reste inactive jusqu'à sa restauration. Une relation supprimée manuellement avant l'archivage n'est pas recréée.

Effets sur les visualisations

L'archivage conserve les références afin de replacer le même actif dans ses contextes précédents après restauration.

ContenuPendant l'archivageAprès restauration
Inventaire, recherche et vuesL'actif quitte les résultats actifs et la recherche globaleIl revient s'il correspond aux filtres courants
Graphiques et cartes imbriquéesL'actif ne contribue plus aux calculs ou parcoursIl contribue de nouveau s'il correspond aux règles
DiagrammesLe nœud reste en place et apparaît inactifLe même nœud redevient actif
Tableaux de bordUn widget Actif direct indique que l'actif est suppriméLe widget affiche de nouveau l'actif
Flux de processusUn actif référencé reste visible comme inactif ; un processus archivé n'est plus modifiableUne référence restaurée redevient active ; restaurer le processus réactive la modification si les droits de flux le permettent
Liens de partageL'actif archivé est indisponible par son lien publicUn lien existant peut de nouveau résoudre l'actif

La position, la taille, l'apparence et le lien du nœud sont conservés dans les diagrammes. La restauration ne crée donc pas un nouveau nœud et ne demande aucun repositionnement.

Les vues, graphiques et cartes imbriquées sont calculés à partir des données actives. Restaurer un actif ne force pas son affichage : leurs filtres, parcours de relations et règles d'accès continuent de s'appliquer.

Supprimer définitivement

La suppression définitive retire l'actif archivé et empêche toute restauration ultérieure. Un actif actif doit toujours être archivé au préalable.

Pour supprimer définitivement un actif :

  1. Ouvrez l'inventaire archivé ou la page de l'actif archivé
  2. Sélectionnez Supprimer définitivement dans le menu Actions de la ligne, ou cliquez sur ce bouton dans l'en-tête de la page
  3. Cochez la confirmation du caractère irréversible
  4. Confirmez

Pour plusieurs actifs, activez la sélection multiple dans le tableau des archives, sélectionnez les lignes, puis cliquez sur Supprimer définitivement. La confirmation sépare les actifs autorisés de ceux ignorés pour droits insuffisants.

Suppression définitive

Cette action retire l'actif, son historique, ses commentaires et ses relations restantes. Elle ne peut pas être annulée.

La suppression définitive retire aussi l'actif de ses contextes précédents :

  • les widgets Actif directs des tableaux de bord perdent leur source
  • les nœuds de diagramme deviennent des espaces réservés non liés pour le type d'actif
  • les flèches de diagramme liées aux relations deviennent des flèches visuelles lorsque cela reste possible
  • les références des flux deviennent des espaces réservés pour le type d'actif
  • si l'actif supprimé possède un flux de processus, ses étapes sont supprimées
  • les liens publics vers l'actif cessent définitivement de fonctionner

Utilisez cette action uniquement quand la conservation et la restauration ne sont plus nécessaires.

Suppression d'un type d'actif

Supprimer un type d'actif du métamodèle contourne ce cycle d'archivage. Cette action supprime définitivement tous les actifs actifs et archivés de ce type, avec leurs données dépendantes.

Comportement de l'API

Dans l'API V1, DELETE /api/v1/assets/{id} archive l'actif. Cette requête ne le supprime pas définitivement.

L'API V1 n'expose ni la restauration ni la suppression définitive des actifs. Utilisez l'interface des archives pour ces actions.

Résoudre les problèmes courants

Si une action attendue manque ou reste désactivée, vérifiez d'abord le type d'utilisateur global, puis le droit effectif sur le type et les domaines de l'actif.

  • Contrôle des archives absent : votre type global est inférieur à Éditeur
  • Actif archivé absent : vos rôles n'accordent pas view_asset sur l'un de ses domaines d'accès
  • Restauration indisponible : vous n'avez pas edit_asset
  • Suppression définitive indisponible : vous n'avez pas delete_asset, ou l'actif est encore actif
  • Relation toujours inactive : l'autre actif est archivé, ou la relation avait été supprimée avant l'archivage
  • Actif restauré absent d'une vue : il ne correspond plus aux filtres ou droits d'accès actuels