Dashboards#

A seção Dashboards é destinada à visualização de métricas, criação de dashboards, gerenciamento de templates e configuração de widgets. O conjunto de botões disponíveis depende dos direitos do usuário para leitura, criação, modificação e exclusão.

Na seção Dashboards está listado todos os dashboards criados. Abaixo está a aba Configuração de dashboards, onde é possível fazer alterações no dashboard (caso o usuário tenha os direitos apropriados). Mais abaixo está a aba Configuração de templates. Nela, é possível criar, modificar e excluir templates para dashboards.

1. Visualização do dashboard#

Abra Dashboards no menu à esquerda e selecione o dashboard desejado na lista aninhada.

No modo de visualização, não é possível fazer alterações no dashboard, mas é possível inserir dados em variáveis globais, alterando assim os dados exibidos nos gráficos.

2. Registro de dashboards#

Abra Dashboards → Configuração de dashboards.

Na tabela são exibidos o nome, a descrição, as datas de criação e modificação. Ações disponíveis:

  • Criar — criar um dashboard vazio;
  • Do template — criar um dashboard a partir de um template básico ou personalizado;
  • Excluir selecionados — excluir os dashboards marcados;
  • Clonar painel — criar uma cópia do dashboard;
  • Criar template de ... — criar um template com base no dashboard selecionado (o dashboard original permanece na lista).

Na coluna de ações de cada linha estão:

  • engrenagem — modificar o nome e a descrição;
  • ícone de layout — abrir Designer de widgets;
  • lixeira — excluir o dashboard.

O nome pode ser editado diretamente na tabela. Após concluir a edição, o valor é salvo automaticamente.

3. Criação de um dashboard vazio#

  • Na página de configuração, clique em Criar.
  • Insira um nome obrigatório com no máximo 64 caracteres.
  • Se necessário, preencha a descrição.
  • Clique em OK.

Um dashboard vazio não está automaticamente vinculado a um projeto ou processo. Após a criação, abra seu construtor e adicione widgets.

4. Criação a partir de um template#

  • Clique em Do template.
  • Encontre o template básico ou personalizado desejado na lista que se abre.
  • Clique em Criar ao lado do template selecionado.

O template transfere para o novo dashboard widgets, suas dimensões, localização, consultas e variáveis. Esta é a maneira mais rápida de obter um conjunto funcional de gráficos.

Para um dashboard de um projeto específico, use a seção Processos:

  1. Selecione o projeto.
  2. Marque exatamente um de seus processos.
  3. Clique em Criar dashboard.
  4. Selecione o template.

O processo selecionado é usado como ponto de ancoragem: o servidor determina seu projeto e pode inserir processos desse projeto em widgets de projeto.

5. Gerenciamento de templates#

Abra Dashboards → Configuração de templates.

Um template personalizado pode ser criado, modificado, aberto no construtor ou excluído. Templates básicos são fornecidos pelo sistema e usados na criação de dashboards prontos.

Para transformar um dashboard existente em um template:

  1. Abra o registro de dashboards.
  2. Selecione a linha com o dashboard desejado.
  3. Clique em Criar template de ....

O dashboard original permanece no registro, e o novo template aparece na seção de templates.

6. Construtor de dashboard#

Abra o registro e clique na linha desejada em Designer de widgets.

Outra opção para acessar o modo de edição é clicar nos três pontos ao lado do nome do dashboard. Na janela pop-up, selecione a opção Designer de widgets.

No modo construtor, é possível:

  • adicionar widgets;
  • arrastar widgets pelo marcador de movimentação;
  • alterar seu tamanho;
  • copiar um widget;
  • abrir configurações;
  • excluir um widget;
  • retornar ao registro de dashboards.

A posição e os tamanhos são salvos automaticamente após concluir a movimentação ou alteração de tamanho.

Adicionando um widget#

Clique em Adicionar widget e escolha o tipo.

Estão disponíveis:

  • Histograma;
  • Linha do tempo;
  • Linha do tempo por dias;
  • Gráfico de linhas;
  • Número;
  • Gráfico de pizza;
  • Tabela;
  • Gráfico de Sankey;
  • Gráfico de bolhas;
  • Comentário;
  • Variável global.

Após adicionar, abra as configurações do widget clicando no botão com o lápis.

Contrato de dados para novos widgets:

  • Gráfico de Sankey — linhas source, target e value (ou count);
  • Gráfico de bolhas — linhas x, y e size (ou z). Opcionalmente name (dica) e series (agrupamento de cores);
  • Comentário — texto estático. Definido no campo Texto do comentário ao configurar o widget.

7. Configurações do widget#

Para widgets comuns, estão disponíveis dois modos.

Construtor#

A configuração é realizada em etapas:

  1. Principal — nome e tipo do widget.
  1. Tabelas — fontes de dados. Nesta aba, é necessário selecionar a tabela do banco de dados.
  2. Relações — condições pelas quais as tabelas serão relacionadas entre si (se o usuário selecionou mais de uma tabela). Isso é análogo ao comando JOIN em SQL.
  1. Filtros — parâmetros de filtragem são definidos.
  1. Totais — seleção de colunas de dados, agregação de dados, agrupamento, ordenação e limite.

Para gráficos, são importantes os nomes das linhas resultantes:

  • histograma, linha e gráfico de pizza — count e name;
  • linha do tempo — name e StartTime, opcionalmente FinishTime;
  • widget numérico — utiliza o valor da primeira linha.

Modo avançado#

SQL

No modo avançado, a consulta é inserida manualmente. Na parte inferior do formulário, são exibidos exemplos prontos para o tipo de widget selecionado e as variáveis disponíveis do dashboard.

Use:

  • Teste — executar uma verificação preliminar e ver o resultado;
  • Salvar — aplicar as configurações;
  • Cancelar — fechar o formulário sem salvar.

Importante: fechar as configurações através do botão de fechar, Escape ou clicar no fundo pode salvar automaticamente um formulário válido. Para garantir que você não deseja salvar as alterações, use exatamente Cancelar.

Antes de salvar um widget SQL, é recomendável sempre executar Teste.

8. Variáveis globais#

Uma variável global armazena um valor que pode ser utilizado por outros widgets. Números, strings, datas e listas de seleção são suportados.

Valor estático#

Defina Valor e, se necessário, Padrão nas configurações do widget. No dashboard, o usuário pode alterar o valor no campo da variável global.

Fonte de dadosAtive Especificar fonte de dados — então a lista de valores permitidos é obtida do banco de dados, e o valor atual é selecionado pelo usuário no painel em modo de visualização.#

Tipos de fonte disponíveis:

  • Dinâmico (BD) — tabela e coluna;
  • Consulta SQL — SELECT arbitrário;
  • Lista fixa — enumeração de valores manualmente.

Para o tipo date, o calendário destaca os dias para os quais há dados. Ao abrir, ele vai para a data disponível mais próxima. O campo é bloqueado até que a lista de datas seja carregada.

Com a fonte configurada, os campos Valor e Padrão no construtor estão ocultos — a seleção é feita apenas no painel.

Para aplicar uma variável global em outros widgets, especifique-a nos filtros ou SQL através do placeholder {{widget:<guid>}}.

9. Dados Adicionais no construtor#

Se, ao carregar os logs CSV do processo, campos adicionais (Dados Adicionais) foram mapeados, eles aparecem no Construtor de widgets como colunas do tipo mining_data.{chave} (AdditionalData).

Use-os na etapa Tabelas ou Totais da mesma forma que colunas normais mining_data.

10. Exportar painel para PDF e PNG#

Na página de visualização do painel, clique em Exportar:

  • Todo o painel em PDF — PDF de várias páginas;
  • Todo o painel em PNG (ZIP) — arquivo com imagens dos widgets;
  • Selecionar widgets... — marque os widgets desejados, depois Exportar selecionados para PDF ou Exportar selecionados para PNG.

Variáveis globais não são incluídas na exportação.

11. Importar e exportar JSON#

Configuração de painéis:

  • Exportar para JSON — salvar painéis selecionados em um arquivo;
  • Importar de JSON — restaurar painéis de um arquivo.

Configuração de templates:

  • Exportar para JSON — salvar templates selecionados;
  • Importar de JSON — restaurar templates de um arquivo.

Isso é conveniente para transferir configurações entre ambientes e para backup.