---

Rinomina un Dashboard

La mutazione editDashboard consente di rinominare un dashboard aggiornando il suo titolo. Solo il creatore del dashboard ha il permesso di rinominare un dashboard.

Esempio Base

mutation RenameDashboard {
  editDashboard(
    input: {
      id: "dash_abc123"
      title: "Q4 Sales Dashboard"
    }
  ) {
    id
    title
    updatedAt
  }
}

Esempio Avanzato con Gestione Utenti

La mutazione editDashboard può anche aggiornare gli utenti del dashboard mentre lo si rinomina:

mutation RenameAndUpdateUsers {
  editDashboard(
    input: {
      id: "dash_abc123"
      title: "Updated Sales Dashboard"
      dashboardUsers: [
        {
          userId: "user_123"
          role: EDITOR
        }
        {
          userId: "user_456"
          role: VIEWER
        }
      ]
    }
  ) {
    id
    title
    dashboardUsers {
      id
      user {
        id
        email
        firstName
        lastName
      }
      role
    }
    updatedAt
  }
}

Parametri di Input

EditDashboardInput

Parametro	Tipo	Richiesto	Descrizione
id	String!	✅ Sì	L'identificatore unico del dashboard da rinominare
title	String	No	Il nuovo titolo per il dashboard. Se non fornito, il titolo rimane invariato
dashboardUsers	[EditDashboardUserInput!]	No	Array opzionale per aggiornare i permessi degli utenti del dashboard

EditDashboardUserInput

Parametro	Tipo	Richiesto	Descrizione
userId	String!	✅ Sì	L'ID dell'utente da aggiungere o aggiornare
role	DashboardRole!	✅ Sì	Il ruolo da assegnare all'utente

Valori di DashboardRole

Valore	Descrizione
EDITOR	Può visualizzare e modificare il contenuto del dashboard (grafici, filtri, layout)
VIEWER	Può solo visualizzare il dashboard

Campi di Risposta

La mutazione restituisce un oggetto completo Dashboard:

Campo	Tipo	Descrizione
id	String!	Identificatore unico del dashboard
title	String!	Il titolo aggiornato del dashboard
createdBy	User!	L'utente che ha creato il dashboard
dashboardUsers	[DashboardUser!]!	Elenco degli utenti con accesso al dashboard
createdAt	DateTime!	Quando è stato creato il dashboard
updatedAt	DateTime!	Quando è stato modificato l'ultimo dashboard

Permessi Richiesti

Solo il creatore del dashboard può rinominare un dashboard. Altri utenti con ruoli di EDITOR o VIEWER non possono cambiare il titolo del dashboard.

Tipo di Utente	Può Rinomina Dashboard
Dashboard Creator	✅ Sì
Dashboard Editor	❌ No
Dashboard Viewer	❌ No
Other Company Users	❌ No

Risposte di Errore

Dashboard Non Trovato

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

Permessi Insufficienti

{
  "errors": [{
    "message": "You don't have permission to edit this dashboard",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Errore di Validazione

{
  "errors": [{
    "message": "Dashboard title cannot be empty",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

Note Importanti

• Nessuna mutazione di rinomina separata: Non esiste una mutazione renameDashboard per la rinomina. La rinomina è gestita attraverso la mutazione editDashboard
• Permesso solo per il creatore: Solo il creatore del dashboard può rinominarlo, anche se altri utenti hanno il ruolo di EDITOR
• Validazione del titolo: I titoli dei dashboard devono essere stringhe non vuote
• Operazione atomica: Quando si aggiornano sia il titolo che gli utenti, tutte le modifiche devono avere successo o nessuna viene applicata
• Gestione utenti: Puoi aggiungere, aggiornare o rimuovere utenti del dashboard nella stessa operazione di rinomina

Casi d'Uso

1. Ribrandizzazione dei dashboard: Aggiorna i nomi dei dashboard per riflettere la nuova terminologia o branding aziendale
2. Aggiornamenti stagionali: Rinomina i dashboard per riflettere i periodi di tempo attuali (es. "Vendite Q3 2024" → "Vendite Q4 2024")
3. Evoluzione del progetto: Aggiorna i titoli dei dashboard man mano che i progetti cambiano ambito o focus
4. Miglioramenti di chiarezza: Rinomina i dashboard per essere più descrittivi o seguire le convenzioni di denominazione

Operazioni Correlate

• Elenca Dashboard - Recupera tutti i dashboard per un'azienda o un progetto
• Crea Dashboard - Crea un nuovo dashboard
• Elimina Dashboard - Rimuovi un dashboard
• Copia Dashboard - Duplica un dashboard esistente