PHSYS - Wiki

Conceito

O Dashboard é a funcionalidade do sistema que reúne, em um único painel visual, indicadores e gráficos configuráveis, permitindo o acompanhamento rápido de informações relevantes do negócio sem a necessidade de gerar relatórios manualmente. Cada dashboard é composto por um conjunto de itens — cada um exibindo um Widget do tipo indicador numérico (card) ou gráfico (barra, linha ou pizza) — organizados em um layout de grade dentro da tela.

O que é

O Dashboard é uma tela de visualização somente leitura, formada por blocos (itens) distribuídos em grade. Cada item exibe o resultado de um Widget previamente configurado no sistema, que pode assumir dois tipos:

• Indicador (card): exibe um único valor em destaque, geralmente representando uma contagem, total.
• Gráfico: exibe uma série de dados no formato de barra, linha ou pizza.

A montagem do dashboard (quais itens existem, em que ordem, com que tamanho e com que Widget) é feita previamente pelos cadastros de Dashboard, Itens do Dashboard e Widget. A tela do Dashboard em si apenas exibe o resultado já configurado — não é nela que se adiciona, remove ou redimensiona itens. Cada item é alimentado por uma consulta SQL própria (Expressão SQL), definida no cadastro do Widget correspondente. Opcionalmente, um Dashboard pode ter um Formulário vinculado, permitindo ao usuário filtrar os dados exibidos sem precisar de um novo cadastro.

Para que serve

Quando compreendemos a funcionalidade do Dashboard, conseguimos acompanhar de forma visual e centralizada os principais números da operação, tomando decisões com mais agilidade e sem depender da geração manual de relatórios para obter uma visão geral da situação atual.

Quais os benefícios e/ou ganhos de uso

Ao concentrar as informações mais relevantes em um único painel visual, o usuário reduz o tempo gasto navegando por diferentes telas e relatórios para entender a situação do negócio. Isso favorece a identificação rápida de tendências, desvios e pontos de atenção, além de padronizar a forma como diferentes usuários enxergam os mesmos indicadores, evitando interpretações divergentes sobre os mesmos dados.

Exemplos

Um dashboard pode reunir, por exemplo, um Widget indicador com o total de pedidos em aberto, um Widget gráfico de barras com o volume de vendas por período e um Widget gráfico de pizza com a participação de cada categoria de produto no faturamento. Dessa forma, em uma única tela, o usuário consegue visualizar tanto números pontuais quanto tendências ao longo do tempo.

Cadastro

O Dashboard é composto por dois cadastros: o Dashboard propriamente dito e os Itens do Dashboard. Cada item, por sua vez, exibe um Widget já cadastrado (do tipo Gráfico ou Indicador) — o cadastro do Widget (onde entram título, cores, formato e a Expressão SQL) é tratado em página própria (veja Sugestão de Leitura).

Dashboard

• Nome: Nome interno do dashboard, utilizado também como identificador ao exportar/importar sua configuração.
• Legenda: Subtítulo/legenda exibida para o usuário.
• Formulário: Formulário (tela de filtro) opcional vinculado ao dashboard. Quando informado, a tela de Dashboard passa a exibir o botão "Filtrar", permitindo restringir os dados exibidos nos itens configurados com Filtros do Item (veja abaixo).
• Data/Hora: Data e horário da última alteração. Preenchido automaticamente pelo sistema.
• É Sistema: Indica se o dashboard é nativo do sistema (padrão) ou foi criado pelo usuário.

Itens do Dashboard

• Dashboard: Dashboard ao qual o item pertence.
• Sequência: Posição/ordem do item dentro do dashboard.
• Nome: Nome interno do item.
• Título: Título exibido no topo do item. Quando deixado em branco, o item assume o título configurado no próprio Widget.
• Altura: Altura do item na grade do dashboard.
• Largura: Largura do item na grade do dashboard (a grade possui 16 unidades de largura por linha; itens são distribuídos lado a lado até completar esse limite, quebrando para a linha seguinte quando necessário).
• Widget: Widget já cadastrado (do tipo Gráfico ou Indicador) a ser exibido neste item.
• Filtros do Item: Disponível apenas quando o Dashboard tem um Formulário vinculado. Mapeia cada campo do Formulário para um Campo já catalogado (via "Incluir Campos") do Widget deste item, definindo a operação a aplicar (igual, diferente, maior ou igual, menor ou igual, contém, está na lista) quando o usuário preencher aquele campo no filtro. Um campo do Formulário sem mapeamento fica disponível para preenchimento, mas não afeta a consulta deste item específico.
• Data/Hora: Data e horário da última alteração. Preenchido automaticamente pelo sistema.
• É Sistema: Indica se o item é nativo do sistema (padrão) ou foi criado pelo usuário.

Comportamentos

• Atualizar: Permite recarregar o dashboard por completo, buscando novamente a estrutura e os dados de todos os itens.
• Carregamento por item: Cada item do dashboard é carregado de forma independente: a estrutura visual (títulos, cores, formato) aparece imediatamente, enquanto os dados de cada item são buscados individualmente e exibidos em seguida, com uma animação de entrada.
• Indicação de carregamento: Enquanto os dados de um item ainda não retornaram, é exibido um indicador de carregamento (spinner) sobre o item.
• Sem dados / Erro ao carregar: Caso a consulta de um item não retorne dados, ou ocorra uma falha ao buscá-los, o item exibe uma mensagem informando a situação, sem impedir a exibição dos demais itens do dashboard.
• Distribuição em grade: Os itens são organizados automaticamente em uma grade de 16 colunas, respeitando a largura e altura configuradas em cada item, se ajustando ao tamanho da tela.
• Filtrar: Quando o dashboard tem um Formulário vinculado, um botão "Filtrar" aparece no topo da tela, abrindo uma janela com os campos configurados. Ao confirmar, todos os itens com Filtros do Item configurados são recarregados considerando os valores informados.
• Lembrar filtro: Se o Formulário vinculado estiver marcado para "Salvar", o último filtro confirmado pelo usuário é lembrado entre acessos, inclusive reabrindo o dashboard em outro momento. Se essa opção não estiver marcada, o filtro é considerado apenas enquanto a tela permanecer aberta — ao reabrir o dashboard, os campos voltam ao valor padrão configurado no Formulário.
• Baixar/Copiar imagem: Ao clicar com o botão direito sobre um Widget do tipo gráfico, é possível baixar a imagem gerada (PNG) ou copiá-la para a área de transferência, para uso em outros documentos ou apresentações.
• Disponível no aplicativo: Os dashboards liberados para o grupo do usuário também são exibidos no aplicativo, com a mesma configuração de itens e o mesmo resultado. A barra superior mostra o dashboard aberto e, havendo mais de um disponível, um botão ao lado permite escolher qual exibir.
• Exportar: No cadastro de Dashboards, gera um arquivo com a configuração completa do dashboard: seus itens, os Widgets utilizados (com Campos, Colunas e configuração visual) e os Filtros do Item. O Formulário vinculado é referenciado pelo nome, mas não vai dentro do arquivo.
• Importar: Lê um arquivo gerado pela exportação, no mesmo ambiente ou em outro. Os registros são identificados pelo Nome — dashboard, Widget e Campos — de modo que a importação cria o que ainda não existe e atualiza o que já existe, sem duplicar. Antes de gravar, o arquivo é validado por inteiro: havendo qualquer problema, nada é importado e é apresentada a lista completa das correções necessárias, indicando o item e o Widget de cada uma.
• Sem armazenamento temporário (cache): Toda abertura ou atualização do dashboard executa novamente, em tempo real, a Expressão SQL de todos os seus itens — não há reaproveitamento de um resultado buscado anteriormente.

Como Configurar um Dashboard

Esta seção resume, o que precisa ser feito para configurar um dashboard.

Cadastre primeiro o Widget (do tipo Gráfico ou Indicador) que você quer usar no dashboard — é lá que ficam o título, as cores, o formato e a Expressão SQL que busca os dados (veja a página de Widgets em Sugestão de Leitura). Cadastre o Dashboard, informando nome e legenda. (Opcional) Para permitir que o usuário filtre os dados do dashboard, cadastre um Formulário com os campos desejados e vincule-o ao Dashboard. Cadastre os Itens do Dashboard, vinculando cada item ao Dashboard criado e ao Widget já cadastrado, e definindo seu título, posição e tamanho na grade. (Opcional) Se o Dashboard tiver um Formulário vinculado, configure em cada Item os Filtros do Item que devem respeitar o filtro, mapeando o campo do Formulário para o Campo correspondente do Widget. Abra a tela de Dashboard apontando para o dashboard desejado — os itens cadastrados aparecem automaticamente, cada um já exibindo seu resultado.

Se você recebeu um dashboard pronto em arquivo, todo esse roteiro pode ser substituído pelo botão Importar no cadastro de Dashboards: o dashboard, seus itens e os Widgets utilizados são criados de uma só vez.

Pontos de atenção

• Como a Expressão SQL é texto livre, o controle de quem pode ver informações sensíveis num dashboard depende de quem tem permissão para visualizar os Dashboard.
• Ao importar um dashboard que tenha Formulário vinculado, o Formulário precisa existir na base de destino antes da importação — cadastre-o ou importe-o primeiro, senão a importação é recusada informando qual Formulário está faltando.

Conclusão

O Dashboard é o recurso responsável por consolidar, em uma única tela, os principais indicadores e gráficos definidos para acompanhamento do negócio. Por ser inteiramente configurável através dos cadastros de Dashboard e Itens — que reaproveitam Widgets já cadastrados, permite que diferentes visões sejam montadas conforme a necessidade de cada área ou perfil de usuário, sem exigir alterações no sistema. Dessa forma, contribui para uma tomada de decisão mais ágil, baseada em informação centralizada e sempre atualizada.

Assuntos Relacionados

Widgets

Layout Importação Dashboards

Criando Dashboards com IA