---

Lijst Dashboards

Haal dashboards op waar je toegang toe hebt om te bekijken. Dit omvat dashboards die je hebt gemaakt en dashboards die met jou zijn gedeeld.

Basis Voorbeeld

query ListDashboards {
  dashboards(filter: { companyId: "company_123" }) {
    items {
      id
      title
      createdBy {
        id
        name
        email
      }
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

Geavanceerd Voorbeeld

query ListDashboardsAdvanced {
  dashboards(
    filter: { 
      companyId: "company_123"
      projectId: "proj_456"  # Optional: filter by project
    }
    sort: [updatedAt_DESC, title_ASC]
    skip: 0
    take: 10
  ) {
    items {
      id
      title
      createdBy {
        id
        name
        email
      }
      dashboardUsers {
        id
        role
        user {
          id
          name
          email
        }
      }
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

Invoervelden

DashboardFilterInput

Parameter	Type	Vereist	Beschrijving
companyId	String!	✅ Ja	Bedrijfs-ID om dashboards te filteren
projectId	String	Nee	Optionele project-ID om dashboards te filteren

Sorteeropties

Sorteerwaarde	Beschrijving
title_ASC	Sorteer op titel oplopend
title_DESC	Sorteer op titel aflopend
createdBy_ASC	Sorteer op maker oplopend
createdBy_DESC	Sorteer op maker aflopend
updatedAt_ASC	Sorteer op update tijd oplopend
updatedAt_DESC	Sorteer op update tijd aflopend (standaard)

Paginatieparameters

Parameter	Type	Standaard	Beschrijving
skip	Int	0	Aantal items om over te slaan
take	Int	20	Aantal items om terug te geven (max 100)

Antwoordvelden

DashboardPaginatie

Veld	Type	Beschrijving
items	[Dashboard!]!	Array van dashboardobjecten
pageInfo	PageInfo!	Paginatie-informatie

Dashboard

Veld	Type	Beschrijving
id	ID!	Unieke identificatie voor het dashboard
title	String!	Weergavenaam van het dashboard
createdBy	User!	Gebruiker die het dashboard heeft gemaakt
dashboardUsers	[DashboardUser!]	Gebruikers met toegang tot dit dashboard
createdAt	DateTime!	Wanneer het dashboard is gemaakt
updatedAt	DateTime!	Wanneer het dashboard voor het laatst is gewijzigd

DashboardGebruiker

Veld	Type	Beschrijving
id	ID!	Unieke identificatie voor de dashboardgebruiker
role	DashboardRole!	Rol van de gebruiker (BEKIJKER of BEWERKER)
user	User!	Gebruikersinformatie

Toegangscontrole

Dashboardzichtbaarheid

Je kunt alleen dashboards zien waar je:

• De maker van het dashboard bent
• Expliciet toegang is verleend via dashboarddeling

Vereiste Machtigingen

• Authenticatie Vereist: Je moet ingelogd zijn
• Bedrijfstoegang: Je moet toegang hebben tot het opgegeven bedrijf
• Projecttoegang: Als je filtert op project, moet je toegang hebben tot dat project

Foutantwoorden

Bedrijf Niet Gevonden

{
  "errors": [{
    "message": "Company not found",
    "extensions": {
      "code": "COMPANY_NOT_FOUND"
    }
  }]
}

Project Niet Gevonden

{
  "errors": [{
    "message": "Project not found", 
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Veelvoorkomende Gebruikscases

Lijst Alle Bedrijfsdashboards

query CompanyDashboards {
  dashboards(filter: { companyId: "company_123" }) {
    items {
      id
      title
      createdBy { name }
    }
  }
}

Lijst Project-specifieke Dashboards

query ProjectDashboards {
  dashboards(filter: { 
    companyId: "company_123"
    projectId: "proj_456"
  }) {
    items {
      id
      title
    }
  }
}

Gepagineerde Dashboardlijst

query PaginatedDashboards {
  dashboards(
    filter: { companyId: "company_123" }
    skip: 20
    take: 10
  ) {
    items {
      id
      title
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}

Beste Praktijken

Prestatie

• Gebruik paginering voor betere prestaties met grote dashboardlijsten
• Vraag alleen de velden op die je nodig hebt in je applicatie
• Overweeg om dashboardlijsten te cachen voor vaak geraadpleegde gegevens

Filteren

• Filter altijd op bedrijf om een goede gegevensisolatie te waarborgen
• Gebruik projectfiltering wanneer je werkt met project-specifieke dashboards
• Combineer filters om resultaten efficiënt te verkleinen

Sorteren

• Standaard sortering is op updatedAt_DESC (meest recent bijgewerkt eerst)
• Gebruik titelsortering voor alfabetische organisatie
• Combineer meerdere sorteercriteria voor complexe ordeningsbehoeften

Gerelateerde Operaties

• Dashboard Aanmaken - Maak nieuwe dashboards aan
• Dashboard Kopiëren - Dupliceer bestaande dashboards
• Dashboard Hernoemen - Hernoem dashboards of beheer gebruikers
• Dashboard Verwijderen - Verwijder dashboards permanent