---

Dashboard löschen

Löschen Sie dauerhaft ein Dashboard, das Sie erstellt haben. Dieser Vorgang kann nicht rückgängig gemacht werden und entfernt alle Diagramme, Diagrammsegmente und Konfigurationen zur Freigabe des Dashboards.

Grundlegendes Beispiel

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

Eingabeparameter

Parameter	Typ	Erforderlich	Beschreibung
id	String!	✅ Ja	Eindeutiger Identifikator des zu löschenden Dashboards

Antwortfelder

MutationResult

Feld	Typ	Beschreibung
success	Boolean!	Ob die Löschung erfolgreich war
message	String	Statusnachricht über den Vorgang

Erforderliche Berechtigungen

Nur für Ersteller

• Nur der Ersteller des Dashboards kann ein Dashboard löschen
• Benutzer mit EDITOR-Zugriff können keine Dashboards löschen
• Unternehmensadministratoren können keine von anderen erstellten Dashboards löschen

Authentifizierung

• Muss authentifiziert sein und Zugriff auf das Unternehmen des Dashboards haben

Was gelöscht wird

Wenn Sie ein Dashboard löschen, werden die folgenden Daten dauerhaft entfernt:

Dashboard-Daten

• Dashboard-Titel und Metadaten
• Erstellungs- und Änderungszeitstempel
• Konfigurationen zur Benutzerfreigabe des Dashboards

Diagrammdaten

• Alle Diagramme innerhalb des Dashboards
• Diagrammsegmente und deren Konfigurationen
• Werte und Berechnungen der Diagrammsegmente
• Anzeigeeinstellungen und Formatierungen der Diagramme

Verwandte Daten

• Benutzerrollenzuweisungen für das Dashboard
• Alle Dashboard-Abonnements oder Echtzeitverbindungen

Fehlerantworten

Dashboard nicht gefunden

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

Berechtigung verweigert

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

Authentifizierung erforderlich

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

Wichtige Überlegungen

Dauerhafte Aktion

• Kann nicht rückgängig gemacht werden: Einmal gelöscht, kann das Dashboard und alle seine Daten nicht wiederhergestellt werden
• Keine weiche Löschung: Das Dashboard wird dauerhaft aus der Datenbank entfernt
• Sofortige Wirkung: Die Löschung erfolgt sofort

Auswirkungen auf andere Benutzer

• Freigegebene Benutzer verlieren den Zugriff: Benutzer, die VIEWER- oder EDITOR-Zugriff hatten, können nicht mehr auf das Dashboard zugreifen
• Aktive Sitzungen: Benutzer, die das Dashboard derzeit anzeigen, verlieren die Verbindung
• Abonnements: Alle Echtzeit-Abonnements für das Dashboard werden beendet

Datenabhängigkeiten

• Keine externen Abhängigkeiten: Das Löschen eines Dashboards hat keine Auswirkungen auf Projekte, To-dos oder andere Unternehmensdaten
• Selbstständig: Nur dashboardspezifische Daten werden entfernt

Best Practices

Vor der Löschung

• Wichtige Daten exportieren: Speichern Sie alle kritischen Diagrammkonfigurationen oder Erkenntnisse
• Freigegebene Benutzer benachrichtigen: Informieren Sie Teammitglieder, die Zugriff auf das Dashboard haben
• Überlegen Sie, eine Kopie zu erstellen: Verwenden Sie die Funktion "Dashboard kopieren", um bei Bedarf eine Sicherung zu erstellen
• Erkenntnisse dokumentieren: Speichern Sie wichtige geschäftliche Erkenntnisse oder Ergebnisse

Alternative Aktionen

• Freigabe entfernen: Ziehen Sie in Betracht, die Dashboard-Benutzer zu entfernen, anstatt zu löschen
• Archivansatz: Es gibt keine integrierte Archivfunktion, aber Sie könnten das Dashboard umbenennen, um anzuzeigen, dass es archiviert ist

Häufige Anwendungsfälle

Bereinigung ungenutzter Dashboards

# 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
  }
}

Test-Dashboards entfernen

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

Sicherheitsnotizen

Erstellerüberprüfung

• Das System überprüft, ob der anfordernde Benutzer der ursprüngliche Ersteller ist
• Die Benutzer-ID wird mit dem createdById-Feld des Dashboards überprüft
• Es sind keine rollenbasierten Überschreibungen erlaubt (sogar Unternehmensinhaber können die Dashboards anderer nicht löschen)

Prüfprotokoll

• Ereignisse zur Dashboard-Löschung werden zu Prüfzwecken protokolliert
• Zeitstempel der Löschung und anfordernder Benutzer werden aufgezeichnet
• Unternehmensadministratoren können Löschprotokolle einsehen

Verwandte Vorgänge

• Dashboards auflisten - Verfügbare Dashboards anzeigen
• Dashboard kopieren - Sicherung vor der Löschung erstellen
• Dashboard erstellen - Neues Dashboard erstellen (Dokumentation ausstehend)
• Dashboard bearbeiten - Dashboard ändern, anstatt es zu löschen (Dokumentation ausstehend)