---

Supprimer le tableau de bord

Supprimez définitivement un tableau de bord que vous avez créé. Cette opération ne peut pas être annulée et supprimera tous les graphiques, segments de graphiques et configurations de partage du tableau de bord.

Exemple de base

mutation DeleteDashboard {
  deleteDashboard(id: "dashboard_123") {
    success
    message
  }
}

Paramètres d'entrée

Paramètre	Type	Requis	Description
id	String!	✅ Oui	Identifiant unique du tableau de bord à supprimer

Champs de réponse

MutationResult

Champ	Type	Description
success	Boolean!	Indique si la suppression a été réussie
message	String	Message d'état concernant l'opération

Autorisations requises

Créateur uniquement

• Seul le créateur du tableau de bord peut supprimer un tableau de bord
• Les utilisateurs ayant un accès ÉDITEUR ne peuvent pas supprimer de tableaux de bord
• Les administrateurs de l'entreprise ne peuvent pas supprimer les tableaux de bord créés par d'autres

Authentification

• Doit être authentifié et avoir accès à l'entreprise du tableau de bord

Qu'est-ce qui est supprimé

Lorsque vous supprimez un tableau de bord, les données suivantes sont définitivement supprimées :

Données du tableau de bord

• Titre et métadonnées du tableau de bord
• Horodatages de création et de modification
• Configurations de partage des utilisateurs du tableau de bord

Données des graphiques

• Tous les graphiques dans le tableau de bord
• Segments de graphiques et leurs configurations
• Valeurs et calculs des segments de graphiques
• Paramètres d'affichage et de formatage des graphiques

Données connexes

• Attributions de rôles des utilisateurs du tableau de bord
• Toute souscription ou connexion en temps réel au tableau de bord

Réponses d'erreur

Tableau de bord non trouvé

{
  "errors": [{
    "message": "Dashboard not found",
    "extensions": {
      "code": "DASHBOARD_NOT_FOUND"
    }
  }]
}

Permission refusée

{
  "errors": [{
    "message": "Only the creator of a dashboard can delete it",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Authentification requise

{
  "errors": [{
    "message": "You must be authenticated to perform this action",
    "extensions": {
      "code": "UNAUTHENTICATED"
    }
  }]
}

Considérations importantes

Action permanente

• Ne peut pas être annulée : Une fois supprimé, le tableau de bord et toutes ses données ne peuvent pas être récupérés
• Pas de suppression douce : Le tableau de bord est définitivement supprimé de la base de données
• Effet immédiat : La suppression a lieu immédiatement

Impact sur d'autres utilisateurs

• Les utilisateurs partagés perdent l'accès : Les utilisateurs ayant un accès VUE ou ÉDITEUR ne pourront plus accéder au tableau de bord
• Sessions actives : Les utilisateurs visualisant actuellement le tableau de bord perdront la connexion
• Abonnements : Toute souscription en temps réel au tableau de bord sera terminée

Dépendances de données

• Pas de dépendances externes : La suppression d'un tableau de bord n'affecte pas les projets, les tâches ou d'autres données de l'entreprise
• Autonome : Seules les données spécifiques au tableau de bord sont supprimées

Meilleures pratiques

Avant la suppression

• Exporter les données importantes : Enregistrez toute configuration de graphique critique ou tout aperçu
• Notifier les utilisateurs partagés : Informez les membres de l'équipe ayant accès au tableau de bord
• Envisager de copier : Utilisez la fonction de copie de tableau de bord pour créer une sauvegarde si nécessaire
• Documenter les aperçus : Enregistrez tout aperçu ou découverte commerciale important

Actions alternatives

• Supprimer le partage : Envisagez de retirer les utilisateurs du tableau de bord au lieu de le supprimer
• Approche d'archivage : Il n'y a pas de fonction d'archivage intégrée, mais vous pourriez renommer le tableau de bord pour indiquer qu'il est archivé

Cas d'utilisation courants

Nettoyer les tableaux de bord inutilisés

# First, list dashboards to identify unused ones
query FindUnusedDashboards {
  dashboards(filter: { companyId: "company_123" }) {
    items {
      id
      title
      updatedAt
      dashboardUsers {
        id
      }
    }
  }
}

# Then delete specific dashboard
mutation CleanupDashboard {
  deleteDashboard(id: "old_dashboard_id") {
    success
    message
  }
}

Supprimer les tableaux de bord de test

mutation RemoveTestDashboard {
  deleteDashboard(id: "test_dashboard_123") {
    success
    message
  }
}

Notes de sécurité

Vérification du créateur

• Le système vérifie que l'utilisateur demandeur est le créateur original
• L'ID utilisateur est vérifié par rapport au champ createdById du tableau de bord
• Aucun remplacement basé sur le rôle n'est autorisé (même les propriétaires d'entreprise ne peuvent pas supprimer les tableaux de bord des autres)

Journal d'audit

• Les événements de suppression de tableau de bord sont enregistrés à des fins d'audit
• L'horodatage de la suppression et l'utilisateur demandeur sont enregistrés
• Les administrateurs de l'entreprise peuvent consulter les journaux de suppression

Opérations connexes

• Lister les tableaux de bord - Voir les tableaux de bord disponibles
• Copier le tableau de bord - Créer une sauvegarde avant la suppression
• Créer un tableau de bord - Créer un nouveau tableau de bord (documentation en attente)
• Modifier le tableau de bord - Modifier le tableau de bord au lieu de le supprimer (documentation en attente)