---

Elimina Dashboard

Elimina permanentemente una dashboard che hai creato. Questa operazione non può essere annullata e rimuoverà tutti i grafici, segmenti di grafico e configurazioni di condivisione della dashboard.

Esempio di Base

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

Parametri di Input

Parametro	Tipo	Richiesto	Descrizione
id	String!	✅ Sì	Identificatore univoco della dashboard da eliminare

Campi di Risposta

MutationResult

Campo	Tipo	Descrizione
success	Boolean!	Se l'eliminazione è stata effettuata con successo
message	String	Messaggio di stato riguardo all'operazione

Permessi Richiesti

Solo Creatore

• Solo il creatore della dashboard può eliminare una dashboard
• Gli utenti con accesso EDITOR non possono eliminare le dashboard
• Gli amministratori aziendali non possono eliminare le dashboard create da altri

Autenticazione

• Deve essere autenticato e avere accesso all'azienda della dashboard

Cosa Viene Eliminato

Quando elimini una dashboard, i seguenti dati vengono rimossi permanentemente:

Dati della Dashboard

• Titolo e metadati della dashboard
• Timestamp di creazione e modifica
• Configurazioni di condivisione degli utenti della dashboard

Dati del Grafico

• Tutti i grafici all'interno della dashboard
• Segmenti di grafico e le loro configurazioni
• Valori e calcoli dei segmenti di grafico
• Impostazioni di visualizzazione e formattazione del grafico

Dati Correlati

• Assegnazioni di ruolo degli utenti della dashboard
• Eventuali abbonamenti alla dashboard o connessioni in tempo reale

Risposte di Errore

Dashboard Non Trovata

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

Permesso Negato

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

Autenticazione Richiesta

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

Considerazioni Importanti

Azione Permanente

• Non può essere annullata: Una volta eliminata, la dashboard e tutti i suoi dati non possono essere recuperati
• Nessuna eliminazione soft: La dashboard viene rimossa permanentemente dal database
• Effetto immediato: L'eliminazione avviene immediatamente

Impatto sugli Altri Utenti

• Gli utenti condivisi perdono accesso: Gli utenti che avevano accesso VIEWER o EDITOR non potranno più accedere alla dashboard
• Sessioni attive: Gli utenti che stanno attualmente visualizzando la dashboard perderanno la connessione
• Abbonamenti: Eventuali abbonamenti in tempo reale alla dashboard verranno terminati

Dipendenze dei Dati

• Nessuna dipendenza esterna: L'eliminazione di una dashboard non influisce su progetti, todo o altri dati aziendali
• Autonomo: Vengono rimossi solo i dati specifici della dashboard

Migliori Pratiche

Prima dell'Eliminazione

• Esporta dati importanti: Salva eventuali configurazioni o intuizioni critiche dei grafici
• Notifica gli utenti condivisi: Informare i membri del team che hanno accesso alla dashboard
• Considera di copiare: Usa la funzione di copia della dashboard per creare un backup se necessario
• Documenta le intuizioni: Salva eventuali intuizioni o scoperte aziendali importanti

Azioni Alternative

• Rimuovi condivisione: Considera di rimuovere gli utenti della dashboard invece di eliminarla
• Approccio di archiviazione: Non esiste una funzione di archiviazione integrata, ma puoi rinominare la dashboard per indicare che è archiviata

Casi d'Uso Comuni

Pulizia delle Dashboard Non Utilizzate

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

Rimuovi Dashboard di Test

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

Note di Sicurezza

Verifica del Creatore

• Il sistema verifica che l'utente richiedente sia il creatore originale
• L'ID utente viene controllato rispetto al campo createdById della dashboard
• Non sono consentite sovrascritture basate sui ruoli (anche i proprietari dell'azienda non possono eliminare le dashboard di altri)

Audit Trail

• Gli eventi di eliminazione della dashboard vengono registrati per scopi di audit
• Il timestamp di eliminazione e l'utente richiedente vengono registrati
• Gli amministratori aziendali possono visualizzare i registri di eliminazione

Operazioni Correlate

• Elenca Dashboard - Visualizza le dashboard disponibili
• Copia Dashboard - Crea un backup prima dell'eliminazione
• Crea Dashboard - Crea una nuova dashboard (documentazione in attesa)
• Modifica Dashboard - Modifica la dashboard invece di eliminarla (documentazione in attesa)