---

Usuń pulpit nawigacyjny

Trwale usuń pulpit nawigacyjny, który utworzyłeś. Ta operacja nie może zostać cofnięta i usunie wszystkie wykresy, segmenty wykresów oraz konfiguracje udostępniania pulpitu nawigacyjnego.

Podstawowy przykład

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

Parametry wejściowe

Parametr	Typ	Wymagany	Opis
id	String!	✅ Tak	Unikalny identyfikator pulpitu nawigacyjnego do usunięcia

Pola odpowiedzi

MutationResult

Pole	Typ	Opis
success	Boolean!	Czy usunięcie było udane
message	String	Komunikat o statusie operacji

Wymagane uprawnienia

Tylko dla twórcy

• Tylko twórca pulpitu nawigacyjnego może usunąć pulpit nawigacyjny
• Użytkownicy z dostępem EDITOR nie mogą usuwać pulpitów nawigacyjnych
• Administratorzy firmy nie mogą usuwać pulpitów nawigacyjnych utworzonych przez innych

Uwierzytelnienie

• Musisz być uwierzytelniony i mieć dostęp do firmy pulpitu nawigacyjnego

Co zostanie usunięte

Gdy usuniesz pulpit nawigacyjny, następujące dane zostaną trwale usunięte:

Dane pulpitu nawigacyjnego

• Tytuł pulpitu nawigacyjnego i metadane
• Znaczniki czasu utworzenia i modyfikacji
• Konfiguracje udostępniania użytkowników pulpitu nawigacyjnego

Dane wykresów

• Wszystkie wykresy w obrębie pulpitu nawigacyjnego
• Segmenty wykresów i ich konfiguracje
• Wartości segmentów wykresów i obliczenia
• Ustawienia wyświetlania wykresów i formatowanie

Powiązane dane

• Przypisania ról użytkowników pulpitu nawigacyjnego
• Jakiekolwiek subskrypcje pulpitu nawigacyjnego lub połączenia w czasie rzeczywistym

Odpowiedzi błędów

Pulpit nawigacyjny nie znaleziony

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

Odrzucono uprawnienia

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

Wymagana autoryzacja

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

Ważne uwagi

Działanie trwałe

• Nie można cofnąć: Po usunięciu pulpit nawigacyjny i wszystkie jego dane nie mogą zostać odzyskane
• Brak miękkiego usunięcia: Pulpit nawigacyjny jest trwale usuwany z bazy danych
• Natychmiastowy efekt: Usunięcie następuje natychmiast

Wpływ na innych użytkowników

• Użytkownicy udostępnieni tracą dostęp: Użytkownicy, którzy mieli dostęp VIEWER lub EDITOR, nie będą mogli uzyskać dostępu do pulpitu nawigacyjnego
• Aktywne sesje: Użytkownicy aktualnie przeglądający pulpit nawigacyjny stracą połączenie
• Subskrypcje: Jakiekolwiek subskrypcje w czasie rzeczywistym do pulpitu nawigacyjnego zostaną zakończone

Zależności danych

• Brak zewnętrznych zależności: Usunięcie pulpitu nawigacyjnego nie wpływa na projekty, zadania ani inne dane firmy
• Samodzielne: Usuwane są tylko dane specyficzne dla pulpitu nawigacyjnego

Najlepsze praktyki

Przed usunięciem

• Eksportuj ważne dane: Zapisz wszelkie krytyczne konfiguracje wykresów lub spostrzeżenia
• Powiadom użytkowników udostępnionych: Poinformuj członków zespołu, którzy mają dostęp do pulpitu nawigacyjnego
• Rozważ skopiowanie: Użyj funkcji kopiowania pulpitu nawigacyjnego, aby utworzyć kopię zapasową, jeśli to konieczne
• Dokumentuj spostrzeżenia: Zapisz wszelkie ważne spostrzeżenia biznesowe lub odkrycia

Alternatywne działania

• Usuń udostępnianie: Rozważ usunięcie użytkowników pulpitu nawigacyjnego zamiast usuwania
• Podejście archiwizacyjne: Nie ma wbudowanej funkcji archiwizacji, ale możesz zmienić nazwę pulpitu nawigacyjnego, aby wskazać, że jest zarchiwizowany

Typowe przypadki użycia

Czyszczenie nieużywanych pulpitów nawigacyjnych

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

Usuń pulpity nawigacyjne testowe

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

Uwagi dotyczące bezpieczeństwa

Weryfikacja twórcy

• System weryfikuje, że użytkownik składający żądanie jest oryginalnym twórcą
• Identyfikator użytkownika jest sprawdzany w odniesieniu do pola pulpitu nawigacyjnego createdById
• Nie są dozwolone żadne nadpisania oparte na rolach (nawet właściciele firmy nie mogą usuwać pulpitów nawigacyjnych innych użytkowników)

Ślad audytu

• Wydarzenia usunięcia pulpitu nawigacyjnego są rejestrowane w celach audytowych
• Znacznik czasu usunięcia i użytkownik składający żądanie są rejestrowane
• Administratorzy firmy mogą przeglądać dzienniki usunięcia

Powiązane operacje

• Lista pulpitów nawigacyjnych - Zobacz dostępne pulpity nawigacyjne
• Kopiuj pulpit nawigacyjny - Utwórz kopię zapasową przed usunięciem
• Utwórz pulpit nawigacyjny - Utwórz nowy pulpit nawigacyjny (dokumentacja w toku)
• Edytuj pulpit nawigacyjny - Zmodyfikuj pulpit nawigacyjny zamiast go usuwać (dokumentacja w toku)