Listar Painéis

Recupere painéis aos quais você tem acesso para visualizar. Isso inclui painéis que você criou e painéis que foram compartilhados com você.

Exemplo Básico

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

Exemplo Avançado

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

Parâmetros de Entrada

DashboardFilterInput

Opções de Ordenação

Parâmetros de Paginação

Campos de Resposta

DashboardPagination

Dashboard

DashboardUser

Controle de Acesso

Visibilidade do Painel

Você só pode ver painéis onde você é:

• O criador do painel
• Acesso explicitamente concedido via compartilhamento de painel

Permissões Necessárias

• Autenticação Necessária: Você deve estar logado
• Acesso à Empresa: Você deve ter acesso à empresa especificada
• Acesso ao Projeto: Se filtrando por projeto, você deve ter acesso a esse projeto

Respostas de Erro

Empresa Não Encontrada

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

Projeto Não Encontrado

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

Casos de Uso Comuns

Listar Todos os Painéis da Empresa

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

Listar Painéis Específicos do Projeto

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

Lista de Painéis Paginada

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

Melhores Práticas

Desempenho

• Use paginação para melhor desempenho com grandes listas de painéis
• Solicite apenas os campos que você precisa em sua aplicação
• Considere armazenar em cache listas de painéis para dados acessados com frequência

Filtragem

• Sempre filtre por empresa para garantir o isolamento adequado dos dados
• Use filtragem de projeto ao trabalhar com painéis específicos de projeto
• Combine filtros para restringir resultados de forma eficiente

Ordenação

• A ordenação padrão é por updatedAt_DESC (mais recentemente atualizado primeiro)
• Use ordenação por título para organização alfabética
• Combine múltiplos critérios de ordenação para necessidades de ordenação complexas

Operações Relacionadas

• Criar Painel - Criar novos painéis
• Copiar Painel - Duplicar painéis existentes
• Renomear Painel - Renomear painéis ou gerenciar usuários
• Excluir Painel - Remover painéis permanentemente