Permanently ta bort en instrumentpanel och alla dess associerade diagram och data
Ta bort instrumentpanel
Permanently ta bort en instrumentpanel som du har skapat. Denna åtgärd kan inte ångras och kommer att ta bort alla diagram, diagramsegment och konfigurationer för delning av instrumentpanelen.
Grundläggande exempel
mutation DeleteDashboard {
deleteDashboard(id: "dashboard_123") {
success
message
}
}
Inmatningsparametrar
Parameter | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
id |
String! | ✅ Ja | Unik identifierare för instrumentpanelen som ska tas bort |
Svarsfält
MutationResult
Fält | Typ | Beskrivning |
---|---|---|
success |
Boolean! | Om borttagningen var framgångsrik |
message |
String | Statusmeddelande om åtgärden |
Obligatoriska behörigheter
Endast skapare
- Endast skaparen av instrumentpanelen kan ta bort en instrumentpanel
- Användare med EDITOR-åtkomst kan inte ta bort instrumentpaneler
- Företagsadministratörer kan inte ta bort instrumentpaneler som skapats av andra
Autentisering
- Måste vara autentiserad och ha åtkomst till företagets instrumentpanel
Vad som tas bort
När du tar bort en instrumentpanel tas följande data permanent bort:
Instrumentpanelsdata
- Instrumentpanelens titel och metadata
- Tidsstämplar för skapande och modifiering
- Konfigurationer för delning av instrumentpanelen
Diagramdata
- Alla diagram inom instrumentpanelen
- Diagramsegment och deras konfigurationer
- Värden och beräkningar för diagramsegment
- Inställningar och formatering för diagramvisning
Relaterad data
- Tilldelningar av användarroller för instrumentpanelen
- Eventuella prenumerationer på instrumentpanelen eller realtidsanslutningar
Felmeddelanden
Instrumentpanel hittades inte
{
"errors": [{
"message": "Dashboard not found",
"extensions": {
"code": "DASHBOARD_NOT_FOUND"
}
}]
}
Åtkomst nekad
{
"errors": [{
"message": "Only the creator of a dashboard can delete it",
"extensions": {
"code": "FORBIDDEN"
}
}]
}
Autentisering krävs
{
"errors": [{
"message": "You must be authenticated to perform this action",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
Viktiga överväganden
Permanent åtgärd
- Kan inte ångras: När den har tagits bort kan instrumentpanelen och all dess data inte återställas
- Ingen mjuk borttagning: Instrumentpanelen tas permanent bort från databasen
- Omedelbar effekt: Borttagningen sker omedelbart
Påverkan på andra användare
- Delade användare förlorar åtkomst: Användare som hade VIEWER- eller EDITOR-åtkomst kommer inte längre att kunna få åtkomst till instrumentpanelen
- Aktiva sessioner: Användare som för närvarande visar instrumentpanelen kommer att förlora anslutningen
- Prenumerationer: Eventuella realtidsprenumerationer på instrumentpanelen kommer att avslutas
Databeroenden
- Inga externa beroenden: Borttagning av en instrumentpanel påverkar inte projekt, att-göra-listor eller annan företagsdata
- Självständig: Endast instrumentpanel-specifik data tas bort
Bästa praxis
Innan borttagning
- Exportera viktig data: Spara eventuella kritiska diagramkonfigurationer eller insikter
- Meddela delade användare: Informera teammedlemmar som har åtkomst till instrumentpanelen
- Överväg att kopiera: Använd funktionen för att kopiera instrumentpanelen för att skapa en säkerhetskopia om det behövs
- Dokumentera insikter: Spara eventuella viktiga affärsinsikter eller fynd
Alternativa åtgärder
- Ta bort delning: Överväg att ta bort användare från instrumentpanelen istället för att ta bort den
- Arkiveringsmetod: Det finns ingen inbyggd arkiveringsfunktion, men du kan döpa om instrumentpanelen för att indikera att den är arkiverad
Vanliga användningsfall
Rensa oanvända instrumentpaneler
# 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
}
}
Ta bort testinstrumentpaneler
mutation RemoveTestDashboard {
deleteDashboard(id: "test_dashboard_123") {
success
message
}
}
Säkerhetsanteckningar
Verifiering av skapare
- Systemet verifierar att den begärande användaren är den ursprungliga skaparen
- Användar-ID kontrolleras mot instrumentpanelens
createdById
fält - Inga rollbaserade överskrivningar tillåts (även företagsägare kan inte ta bort andras instrumentpaneler)
Revisionsspår
- Händelser för borttagning av instrumentpaneler loggas för revisionsändamål
- Tidsstämpel för borttagning och begärande användare registreras
- Företagsadministratörer kan se loggar för borttagning
Relaterade åtgärder
- Lista instrumentpaneler - Visa tillgängliga instrumentpaneler
- Kopiera instrumentpanel - Skapa en säkerhetskopia innan borttagning
- Skapa instrumentpanel - Skapa ny instrumentpanel (dokumentation pågår)
- Redigera instrumentpanel - Modifiera instrumentpanelen istället för att ta bort den (dokumentation pågår)