Dashboards#

Os dashboards reúnem tabelas, indicadores e diagramas para analisar o trabalho. Selecione um painel existente no menu "Dashboards". "Customize Dashboards" permite criar e editar painéis, e "Customize Templates", preparar conjuntos reutilizáveis de widgets.

Direitos de acesso#

Os direitos de acesso determinam as operações permitidas com dashboards e modelos.

1. Visualização do dashboard#

A visualização de um dashboard permite avaliar indicadores e alterar filtros sem editar o painel.

Expanda "Dashboards" no menu esquerdo e selecione um nome. No modo de consulta, altere os valores dos filtros-variáveis usados por outros widgets. "Refresh" atualiza os dados. O Construtor de dashboard permite modificar os widgets e sua distribuição.

Exemplo: o painel mostra cinco ações de solicitações, um contador de 14 eventos e o filtro Лимит строк com valor 5.

2. Registro de dashboards#

O registro de dashboards permite localizar um painel e gerenciar sua configuração.

"Customize Dashboards" mostra "Name", "Description", "Created" e "Updated". Os filtros das colunas ajudam a localizar um painel. As caixas das linhas selecionam registros para operações em grupo.

Botões acima da tabela:

• "New" — abre o formulário de um painel vazio;
• "From template" — mostra conjuntos prontos de widgets;
• "Delete Selected" — exclui os painéis selecionados após confirmação;
• "Clone Dashboard" — copia os painéis selecionados;
• "Export JSON" — salva suas configurações em um arquivo;
• "Import JSON" — carrega configurações de um arquivo JSON;
• "Create template from…" — cria um modelo de um painel selecionado. Seu nome é incluído no botão.

Cada linha tem "Edit" , "Form Designer" e "Delete" . JSON permite transferir configurações entre ambientes e criar cópias de segurança. Os eventos dos processos não são transferidos.

Exemplo: o filtro de "Name" deixa apenas Обзор заявок. Sua caixa está marcada para ações em grupo.

Para alterar o nome diretamente no registro, clique duas vezes na célula "Name", informe o novo nome e pressione Enter. A alteração é salva automaticamente. Esc cancela a edição.

3. Criação de um dashboard vazio#

Um dashboard vazio permite escolher widgets para a tarefa do usuário.

Botão "New"#

"New" abre a janela pop-up "Create new dashboard".

O painel vazio não é ligado automaticamente a um projeto ou processo. Os widgets são adicionados depois de salvá-lo.

Campos obrigatórios:

• "Name*" — nome do painel, com até 64 caracteres.

Parâmetros adicionais:

• "Access folder" — restringe o acesso pela pasta selecionada;
• "Description" — explica a finalidade do painel.

"OK" cria o painel e "Cancel" fecha sem criá-lo.

Exemplo: "Name*" contém Обзор заявок e "Description", Количество и состав событий обработки заявок. Nenhuma pasta de acesso foi selecionada.

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

A criação a partir de um modelo fornece um conjunto de widgets que pode ser adaptado aos próprios dados.

Botão "From template"#

"From template" abre uma janela com grupos separados de modelos predefinidos e personalizados.

"Create" ao lado de um modelo cria um painel com seus widgets, distribuição, consultas e variáveis.

Exemplo: Шаблон обработки заявок está disponível nos modelos personalizados. A partir desse modelo, é possível criar um painel com tabela de eventos, contador e filtro de limite de linhas. Para criá-lo, clique em "Create" na linha do modelo selecionado.

Criação de um painel para um processo#

Em "Processes", escolha um projeto, marque um processo e clique em "Create Dashboard".

A janela mostra o nome do processo e o campo obrigatório "Select template*". Escolha um modelo e clique em "OK". "Cancel" cancela a operação.

Exemplo: em "Select template*", está selecionado Базовый дашборд (пример) para Обработка заявок. No painel criado, o filtro de processo terá o valor Обработка заявок selecionado.

5. Gerenciamento de templates#

Os modelos permitem reutilizar um conjunto de widgets ao criar outros painéis.

Selecione um painel no registro e clique em "Create template from…" para preservar seu conjunto de widgets.

O painel original permanece na lista. O modelo aparece em "Customize Templates", onde seu nome, descrição e widgets podem ser editados, ou o modelo excluído. A tela também permite criar modelos vazios e intercambiar JSON.

Exemplo: um modelo foi criado de Обзор заявок e renomeado Шаблон обработки заявок, com descrição События заявок, счетчик и лимит строк.

6. Construtor de dashboard#

O Construtor de dashboard permite adicionar widgets e alterar suas posições e tamanhos.

Botão "Form Designer"#

"Form Designer" em uma linha abre o Construtor de dashboard.

Outra forma de acesso é clicar em "Dashboard actions" ao lado do nome do painel no menu esquerdo e selecionar "Form Designer".

Arraste os widgets pelo controle de movimento e redimensione-os pelo canto inferior direito. A posição e o tamanho são salvos após a alteração. Os controles permitem copiar, configurar e excluir um widget.

No Construtor de dashboard, clique no botão de edição do widget para abrir "Widget settings". Para tabelas e gráficos, essa janela pop-up contém o construtor de consultas do widget, que permite escolher a fonte de dados, as relações e as condições de filtragem desse widget. O botão "Constructor" ativa a preparação visual da consulta, enquanto "Advanced mode" permite inserir SQL manualmente. Grafos, BPMN, filtros-variáveis e outros widgets especiais têm parâmetros próprios.

Exemplo: o painel contém a tabela События заявки, o indicador Количество событий e o filtro Лимит строк com valor 5. O Construtor de dashboard mostra os três e os controles de composição.

Adicionando um widget#

Adicionar um widget inclui outra visualização de dados no painel.

Botão "Add widget"#

O botão "Add widget" abre uma janela com blocos de tipos de widget. É necessário selecionar um bloco e clicar em "Add". Estão disponíveis os seguintes tipos de widget:

• "Bar chart" — compara valores por categoria, como a quantidade de eventos de cada ação;
• "Timeline" — mostra a ordem e a duração dos eventos em um eixo de tempo;
• "Timeline by days" — distribui os intervalos por dia para comparar a atividade entre datas;
• "Line chart" — mostra a variação de uma métrica ao longo do tempo;
• "Number" — exibe um único total, como a quantidade de eventos;
• "Pie chart" — mostra a participação de cada categoria no total;
• "Box plot" — mostra a distribuição de valores numéricos por categoria com caixas, bigodes e valores discrepantes;
• "Sankey diagram" — mostra fluxos e transições entre grupos de dados;
• "Bubble chart" — compara itens pela posição e pelo tamanho das bolhas;
• "Table" — mostra registros originais e valores calculados em linhas;
• "Variable filter" — fornece um valor selecionado a outros widgets para filtrar dados;
• "Comment" — adiciona ao painel um texto explicativo sem formatação;
• "Text" — adiciona ao painel um bloco formatado em Markdown;
• "BPMN schema" — mostra a sequência de trabalho em notação BPMN;
• "Process graph" — mostra as ações do processo e as transições entre elas;
• "Process cost analytics" — permite analisar o tempo e o custo do trabalho por processo ou funcionário;
• "Data quality" — mostra métricas de erros para verificar a qualidade dos eventos originais;
• "Pivot table" — agrupa os dados por linhas e colunas e mostra métricas agregadas nas interseções;
• "Area chart" — mostra uma métrica com a área abaixo da linha preenchida;
• "Funnel" — compara valores de etapas sucessivas para identificar perdas;
• "Percentage KPI" — mostra a relação entre numerador e denominador em uma escala circular;
• "Gauge" — mostra um valor em relação a um máximo definido em uma escala semicircular;
• "Image" — adiciona uma imagem ao dashboard;
• "Container" — agrupa vários widgets em abas de uma célula.

Exemplo: para mostrar eventos de um processo, é necessário selecionar "Table" e clicar em "Add". O novo widget aparece no Construtor de dashboard.

Widget "Text"#

O widget exibe no painel títulos, listas, links e outros elementos definidos em Markdown. Não carrega dados do banco de dados.

No Construtor de dashboard, clique em "Add widget" e selecione o tipo "Text".

Em seguida abra as configurações do widget com o botão de edição .

A janela "Widget settings" contém os seguintes elementos.

Campos obrigatórios:

• Campo "Widget name*" — título do bloco no painel.

Campos adicionais:

• Campo "Text (Markdown)" — conteúdo a ser exibido.

O bloco "Preview" mostra a formatação e não é preenchido manualmente.

Exemplo: para mostrar um resumo do processamento, é necessário informar o nome Итоги обработки, inserir o texto abaixo em "Text (Markdown)" e clicar em "Save". O painel mostra um título, uma lista e um link.

## Краткий итог
- Среднее время обработки — **2,5 ч**
- Подробнее — [инструкция по дашбордам](https://docs.sherparpa.ru/sherpa-process-discovery/rabota-v-sherpa-process-discovery/ekrany/dashbordy)

"Save" aplica as configurações. "Cancel" fecha a janela sem alterações.

O widget "Comment" continua armazenando texto simples em "Comment text" e não aplica Markdown. Use "Text" quando precisar de explicações formatadas.

HTML e scripts arbitrários não são suportados: apenas elementos de marcação seguros são exibidos.

Widget "Container"#

Um contêiner reúne vários widgets em abas dentro de uma célula do dashboard. Ele permite alternar visualizações de dados e economizar espaço no painel.

No Construtor de dashboard, clique em "Add widget", escolha "Container" e clique em "Add".

Abra as configurações do contêiner adicionado pelo botão de edição .

A janela pop-up "Widget settings" contém um campo obrigatório:

Elementos obrigatórios:

• Campo "Widget name*" — define o nome do contêiner.

Elementos adicionais:

Este tipo de widget não tem campos adicionais. "Save" salva o contêiner. O botão para adicionar uma aba fica indisponível até salvar o contêiner.

Exemplo: informe Пояснения em "Widget name*" e clique em "Save".

Ao salvar, o contêiner vazio mostra "No tabs yet". Os widgets das abas não ocupam células separadas.

Botão para adicionar uma aba#

O botão na linha de abas adiciona outra visualização de dados ao contêiner salvo. Ele abre a janela pop-up "Add widget". Para adicionar uma explicação, escolha "Comment" e clique em "Add".

"Container" não aparece porque contêineres aninhados não são permitidos.

Para "Image", "Comment", "Text", "BPMN schema", "Process graph", "Process cost analytics" e "Data quality", as configurações são abertas após a seleção. É necessário salvá-las para criar a aba.

Para "Comment", a janela pop-up "Widget settings" contém estes elementos:

Elementos obrigatórios:

• Campo "Widget name*" — define o nome da aba no contêiner.
• Lista "Type" — seleciona o conteúdo da aba. Para uma explicação em texto, mantenha "Comment" selecionado.

Elementos adicionais:

• Campo "Comment text" — define a explicação dentro da aba. Se estiver vazio, a aba não contém texto de comentário.

"Save" cria a aba e "Cancel" fecha as configurações sem criá-la.

Exemplo: informe Назначение панели em "Widget name*" e mantenha "Comment" em "Type". Informe Панель показывает учебные примеры обработки заявок. em "Comment text" e clique em "Save".

Abas do contêiner#

As abas permitem escolher um widget sem abrir outro painel. Para mudar de aba, clique em seu nome na parte superior do contêiner. No Construtor de dashboard, os botões abaixo da linha de abas permitem mudar a ordem , editar ou excluir a aba selecionada. Mover para a esquerda fica indisponível na primeira aba, e mover para a direita fica indisponível na última. No modo de consulta, aparecem os seletores de abas sem controles para alterar o conteúdo do contêiner.

Exemplo: a aba Назначение панели está selecionada no contêiner Пояснения. Sua explicação aparece abaixo dos controles das abas.

Ao clonar um painel, criar um painel a partir de um modelo ou transferi-lo por YAML, o contêiner e suas abas são preservados. Excluir um contêiner também exclui todos os seus widgets filhos.

Widget "Funnel"#

O widget compara valores de etapas consecutivas do Processo e ajuda a identificar os passos com maiores perdas. As etapas aparecem de cima para baixo na ordem dos dados de origem.

No Construtor de dashboard, é necessário clicar em "Add widget", selecionar o bloco "Funnel" no grupo "Charts" e clicar em "Add".

Para configurar o widget adicionado, é necessário clicar no botão de edição .

Na janela pop-up "Widget settings", os seguintes elementos são usados no funil do exemplo.

Elementos obrigatórios:

• Campo "Widget name*" da etapa "Basic" — define o título do funil no painel.
• Lista "Type" da etapa "Basic" — determina o tipo de gráfico. Para esta configuração, é necessário selecionar "Funnel".
• Campo "SQL" da etapa com o mesmo nome — define a consulta no "Advanced mode". Neste exemplo, a consulta retorna os nomes das etapas na coluna name e seus valores na coluna count.

Elementos adicionais:

• Bloco "Preview" — mostra uma prévia do gráfico. A indicação "Demo data" significa que a interface exibe valores de exemplo em vez do resultado do SQL inserido. Este bloco não é preenchido manualmente.
• Bloco "Example Requests" — contém exemplos de SQL para configurar o widget. Eles não são necessários para o exemplo a seguir.

No construtor de consultas do widget, os botões "Constructor" e "Advanced mode" no cabeçalho alternam o método de preparação dos dados. No modo "Constructor", é necessário definir uma ou mais dimensões para as etapas e medidas para os valores. Para inserir uma consulta manualmente, é necessário selecionar "Advanced mode" e depois a etapa "SQL". Uma consulta com valores constantes não exige selecionar uma tabela na etapa "Tables".

Exemplo: para comparar etapas do processamento de solicitações, selecione "Advanced mode". Na etapa "Basic", insira Обработка заявок no campo "Widget name*" e selecione "Funnel" na lista "Type".

Abra a etapa "SQL" e insira a consulta a seguir. Ela define os números 100, 72 e 50 sem consultar o registro de eventos. Mantenha os nomes russos das etapas exatamente como escritos para reproduzir as capturas.

SELECT 'Получено' AS name, 100 AS count, 1 AS stage
UNION ALL SELECT 'Проверено', 72, 2
UNION ALL SELECT 'Завершено', 50, 3
ORDER BY stage

Clique em "Save". No Construtor de dashboard, o funil Обработка заявок mostra as etapas Получено — 100, Проверено — 72 e Завершено — 50. A conversão em relação à etapa anterior é de 72 % e 69,4 %. O valor da última etapa corresponde a 50 % da primeira.

Ao posicionar o ponteiro sobre a etapa Завершено, a dica mostra o valor 50, a conversão de 69,4 % em relação à etapa anterior e 50 % da primeira etapa.

A ordem das etapas é determinada por SQL ORDER BY ou pela ordem do resultado do construtor de consultas do widget. O funil não reordena as etapas por valor.

O botão "Cancel" fecha a janela pop-up "Widget settings" sem salvar as alterações.

Widget "Percentage KPI"#

O widget permite avaliar quanto do valor desejado o indicador atual representa. Ele exibe a relação entre numerador e denominador em porcentagem numa escala circular que começa no topo.

No Construtor de dashboards, é necessário clicar no botão "Adicionar widget", escolher o bloco "Percentage KPI" no grupo "Tabelas e números" e clicar em "Adicionar".

A janela pop-up "Configurações do widget" é aberta. Para alterar um indicador salvo, utiliza-se o botão de edição no cartão. A etapa "Básico" contém:

Campos obrigatórios:

• Campo "Nome do widget*" — rótulo obrigatório do indicador no dashboard. No exemplo, é necessário inserir Доля выполненных.

Campos adicionais e configurações:

• Lista "Tipo" — contém "Percentage KPI" após a escolha do bloco.
• Grupo "Numerador" — define o valor cuja proporção será calculada. O padrão é "Constante" com valor 0.
• Grupo "Denominador (em relação a quê)" — define o valor de referência. O padrão é "Constante" com valor 100.

A origem do valor é escolhida de forma independente em cada grupo:

• Botão "Constante" — abre o campo numérico "Número". É necessário inserir um valor fixo. Esse método serve para conferir o cálculo e definir uma referência constante.
• Botão "Variável" — abre a lista "Filtro-variável". É necessário escolher um widget de filtro-variável do mesmo dashboard que retorne um número. Uma string não numérica ou um valor vazio produz 0.
• Botão "Calculado" — abre a lista "Medida do construtor". É necessário configurar uma medida na etapa "Resultados" do construtor de consultas do widget, voltar a "Básico" e selecionar seu nome. Para obter um total geral, a consulta deve retornar um único agregado sem agrupamento por dimensões. Se houver vários valores, utiliza-se o primeiro, não a soma das linhas.

As etapas "Tabelas", "Relações", "Filtros" e "Resultados" aparecem se "Calculado" estiver selecionado em pelo menos um grupo. Para constantes e variáveis, fica apenas "Básico". O widget não mostra o seletor "Modo avançado": as origens do numerador e denominador são escolhidas separadamente. As instruções do construtor de consultas do widget explicam a configuração de medidas.

Exemplo: para o percentual concluído, é necessário selecionar "Constante" em "Numerador" e inserir 72 em "Número". Em "Denominador (em relação a quê)", seleciona-se "Constante" e insere-se 100 em "Número".

Após clicar em "Salvar", o widget Доля выполненных mostra 72 %. "Cancelar" fecha a configuração sem aplicar as alterações.

O resultado é numerador / denominador × 100, arredondado para uma casa decimal. Um denominador zero produz 0 %. Valores negativos mantêm o sinal. A escala é preenchida de acordo com o valor absoluto do resultado, até 100 %. Se o valor absoluto superar 100 %, aparecem reticências ao lado do número. Por exemplo, 150 em relação a 100 produz 150 % com a escala completa e reticências.

Widget "Gauge"#

O medidor permite comparar o indicador atual com uma meta ou limite. A posição do ponteiro e o preenchimento da escala semicircular dependem da relação entre indicador e máximo. O indicador aparece abaixo da escala e o máximo, sob a extremidade direita do arco.

Para adicionar o medidor no Construtor de dashboards, é necessário clicar em "Adicionar widget", escolher o bloco "Gauge" em "Tabelas e números" e clicar em "Adicionar".

O novo medidor é configurado na janela pop-up "Configurações do widget". Para um medidor salvo, o botão de edição no cartão abre essas configurações. A etapa "Básico" inclui os campos e controles abaixo.

Campos obrigatórios:

• Campo "Nome do widget*" — define o rótulo do medidor no dashboard. O exemplo utiliza Выполнение плана.

Campos adicionais e configurações:

• Lista "Tipo" — fica definida como "Gauge" após a inclusão do bloco escolhido.
• Grupo "Valor" — define o indicador atual. Um medidor novo utiliza a constante 0.
• Grupo "Máximo (intervalo)" — define o limite superior da escala. Sua constante inicial é 100. Para exibir uma proporção normal, o limite precisa ser positivo.

Cada grupo possui seus próprios botões para escolher a origem:

• Botão "Constante" — permite inserir um valor fixo no campo numérico "Número". É utilizado quando o indicador ou seu máximo não depende dos dados do Processo.
• Botão "Variável" — mostra a lista "Filtro-variável" para escolher um filtro numérico no mesmo dashboard. Uma seleção vazia ou não numérica fornece 0 ao cálculo.
• Botão "Calculado" — permite escolher o indicador em "Medida do construtor". Primeiro é necessário criar a medida na etapa "Resultados" do construtor de consultas do widget e depois selecionar seu nome em "Básico". Um total geral exige um agregado sem agrupamento por dimensões. As linhas não são somadas automaticamente: o medidor utiliza o primeiro valor da medida escolhida.

Ao escolher "Calculado" em qualquer grupo, aparecem "Tabelas", "Relações", "Filtros" e "Resultados". Se ambos os grupos utilizarem "Constante" ou "Variável", basta a etapa "Básico". O medidor oculta o seletor geral "Modo avançado", pois o valor e o máximo são configurados separadamente. A seção do construtor de consultas do widget explica a preparação da consulta.

Exemplo: para o medidor Выполнение плана, é necessário escolher "Constante" em "Valor" e inserir 72 em "Número". Em "Máximo (intervalo)", escolhe-se "Constante" e insere-se 100 em "Número".

Após clicar em "Salvar", o cartão do medidor mostra 72 com máximo de 100. O arco está preenchido em 72 % e o ponteiro indica a mesma proporção. "Cancelar" permite sair sem aplicar as alterações.

Se um máximo positivo for ultrapassado, o arco fica totalmente preenchido e o ponteiro chega à extremidade. Aparecem reticências ao lado do indicador, cujo valor continua visível no rótulo. Um indicador negativo deixa o arco vazio e o ponteiro no início. Um máximo zero ou negativo também deixa a escala vazia, sem substituir os números dos rótulos.

O segundo exemplo mostra a abreviação de números grandes: compara-se 385.68 com o máximo de 1300000000. O rótulo do máximo exibe 1.3B, que representa 1,3 bilhão. A abreviação não muda o valor utilizado no cálculo da escala.

Widget de qualidade de dados#

O widget ajuda a avaliar a confiabilidade dos dados de origem: mostra a quantidade de erros de importação e sua proporção em relação aos eventos do projeto ou processo selecionado.

A janela pop-up "Widget settings" contém os seguintes parâmetros.

Elementos obrigatórios:

• Campo "Widget name*" — define o título do indicador.
• Lista "Type" — seleciona o tipo de indicador. Neste exemplo, é necessário escolher "Data quality".

É necessário indicar pelo menos um projeto ou processo. Quando ambos são informados, o processo é utilizado. Se apenas um projeto for selecionado, todos os seus processos são incluídos.

Elementos adicionais:

Os seguintes elementos permitem selecionar os dados diretamente:

• Opção "Use filter variable" no grupo de projetos — desativada mostra a lista "Project".
• Lista "Project" — seleciona o projeto do cálculo quando nenhum processo foi escolhido.
• Opção "Use filter variable" no grupo de processos — desativada mostra a lista "Process".
• Lista "Process" — seleciona o processo cujos eventos serão verificados.

Exemplo: "Widget name*" contém Качество данных e "Type" está como "Data quality". As duas opções "Use filter variable" estão desativadas. Em "Project" e "Process", está selecionado Обработка заявок. O processo informado define os eventos do cálculo. "Save" aplica esses parâmetros.

Para utilizar o valor selecionado em outro widget, é necessário ativar "Use filter variable" no grupo correspondente. A seleção direta é substituída por estas listas:

• "Filter variable" no grupo de projetos — seleciona o widget que fornece o identificador do projeto.
• "Filter variable" no grupo de processos — seleciona o widget que fornece o identificador do processo.

Na captura de tela seguinte, as duas opções estão ativadas e as duas listas "Filter variable" estão vazias. A configuração ainda não está pronta para o cálculo: antes de salvar, é necessário criar os widgets de filtro-variável adequados no dashboard e selecioná-los. Sua configuração está descrita na subseção Variáveis globais deste artigo. "Cancel" fecha a janela sem modificar a seleção direta salva.

Ao cancelar a alternativa incompleta, a seleção direta do projeto e processo Обработка заявок permanece salva. Para esses dados, o widget mostra 14 eventos, 0 erros e uma proporção de erros de 0 %. Os valores podem variar para outro processo.

O widget está incluído em Базовый дашборд e Демо-дашборд.

7. Configurações do widget#

As configurações do widget permitem escolher dados, filtros e apresentação dos resultados.

Abra as configurações do widget selecionado no Construtor de dashboard. Os campos dependem do tipo. Tabelas e gráficos oferecem o construtor de consultas do widget e a entrada SQL.

Construtor de consultas do widget#

O construtor de consultas do widget define o tipo, tabelas, relações, filtros e séries do resultado em etapas sucessivas. As etapas são descritas em:

• Etapa "Basic";
• Etapa "Tables";
• Etapa "Joins";
• Etapa "Filters";
• Etapa "Results".

Etapa "Basic"#

"Basic" contém dois campos obrigatórios:

• "Widget name*" — explica os dados mostrados;
• "Type" — define sua representação. As opções são descritas em "Adicionando um widget".

Exemplo: "Widget name*" é События заявки e "Type" é "Table".

Etapa "Tables"#

Selecione uma ou mais fontes em "Tables". Cada tabela adicionada aparece como uma etiqueta. O botão de remoção da etiqueta exclui a tabela da consulta.

Exemplo: somente mining_data, o log de eventos dos processos, está selecionada. Nenhuma outra tabela foi adicionada.

Etapa "Joins"#

As relações combinam várias tabelas em uma consulta. Cada condição utiliza "Column 1", "Operator" e "Column 2". "Add conditions (Join)" adiciona outra condição. Uma única tabela não precisa de relações.

Em "Joins", "Operator" oferece:

• = — relaciona registros com valores iguais nas colunas;
• != — relaciona registros com valores diferentes;
• > — relaciona registros se o valor da primeira coluna for maior que o da segunda;
• < — relaciona registros se o valor da primeira coluna for menor que o da segunda.

Exemplo: mining_data é a única tabela selecionada. Os campos de relação ficam vazios e nenhuma condição adicional é inserida.

Etapa "Filters"#

Os filtros limitam os registros incluídos no widget. Cada condição exige:

• "Column" — coluna usada para selecionar registros;
• "Operator" — método de comparação;
• "Value" — valor comparado com a coluna.

"Add condition" amplia o grupo atual. "Add filter" cria outro grupo. Várias condições são ligadas por AND ou OR. O controle de ligação ao lado do valor permite usar um filtro-variável do painel.

O ID do processo aparece em ProcessID, no painel de detalhes de eventos em Dados. Ele permite selecionar os eventos de um processo.

A lista "Operator" depende do tipo da coluna:

• = — mantém os registros iguais ao valor informado;
• != — exclui os registros iguais ao valor informado;
• LIKE — compara texto com um padrão. % representa qualquer quantidade de caracteres e _, um caractere;
• NOT LIKE — exclui textos que correspondem ao padrão;
• > — seleciona números maiores ou datas posteriores;
• < — seleciona números menores ou datas anteriores;
• >= — inclui também os valores iguais ao limite inferior;
• <= — inclui também os valores iguais ao limite superior.

Para texto, estão disponíveis =, !=, LIKE e NOT LIKE. Para números e datas, =, !=, >, <, >= e <=.

As condições são conectadas por:

• AND — o registro deve atender a todas as condições conectadas;
• OR — basta atender a pelo menos uma das condições conectadas.

Exemplo: uma condição seleciona o processo de treinamento Обработка заявок. "Column" é mining_data.ProcessID, "Operator" é = e "Value" é 41.

Etapa "Results"#

A etapa "Results" define agrupamento, cálculos e tamanho do resultado. Para tabelas e gráficos comuns, "Available fields" fica à esquerda e "Slices" e "Measures" à direita. A pesquisa permite encontrar uma coluna.

É necessário arrastar um campo para a área desejada. Sua caixa de seleção também o adiciona com uma função sugerida. Para usá-lo como medida, ele deve ser arrastado para "Measures". O botão retira o campo da consulta.

• Área "Slices" — campos de agrupamento. "Slice name" define o título do resultado. Várias dimensões formam uma combinação. Sem medidas, combinações idênticas podem ser agrupadas em uma linha. Para mostrar eventos individuais, é necessário incluir seu identificador exclusivo.
• Área "Measures" — valores calculados. Cada ficha permite escolher a função e preencher "Measure name". COUNT em "Action" conta valores de ação não vazios.
• Bloco "Sort" — a lista "Column" escolhe o campo de ordenação; ASC e DESC definem ordem crescente e decrescente.
• Campo "Number of rows" — limita o resultado. Seu valor inicial é 1000.

Funções disponíveis:

• SUM — soma valores numéricos para obter um total;
• AVG — calcula a média incluindo valores repetidos;
• AVG (DISTINCT) — calcula a média apenas de valores distintos. Use quando as repetições não devem afetar o resultado;
• COUNT — conta os valores da coluna;
• COUNT (DISTINCT) — conta valores distintos, como computadores diferentes;
• MIN — obtém o menor valor;
• MAX — obtém o maior valor.

"Preview" é atualizado quando as configurações mudam. "Real data" identifica uma resposta da origem selecionada. "Demo data" é um exemplo. Durante a carga ou diante de um erro, o resultado não confirma os novos ajustes. "Save" salva os parâmetros. Para descartá-los, é necessário usar "Cancel": a cruz, Esc ou um clique fora podem salvar uma ficha válida automaticamente.

Time,Activity,UserName,ComputerName,AppName,CaseId
2026-11-06 09:00:00,Прием заявки,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 09:01:00,Проверка данных,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 09:03:00,Закрытие заявки,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 10:00:00,Прием заявки,qa.reviewer,QA-PC-2,Requests.exe,CASE-002
2026-11-06 10:02:00,Закрытие заявки,qa.reviewer,QA-PC-2,Requests.exe,CASE-002

Exemplo: após importar, é necessário filtrar mining_data pelo identificador do processo de teste usando ProcessID =. O valor é obtido em ProcessID nos detalhes de um evento em Dados. Em "Results", "Action" é adicionado a "Slices" e a "Measures" com COUNT e o nome Количество событий. "Number of rows" é definido como 5. Ao salvar, são mostrados Прием заявки — 2, Проверка данных — 1 e Закрытие заявки — 2.

Para gráficos de barras e linhas com várias dimensões ou medidas, a disposição oferece dois modos:

• "On one chart" / "Single chart" usa a primeira dimensão para as categorias e todas as medidas para as séries quando há várias medidas. Com uma medida e várias dimensões, a primeira dimensão define as categorias e a segunda define as séries;
• "Separate charts" exibe os dados em painéis separados. As dimensões e medidas são associadas por ordem. Se as listas tiverem tamanhos diferentes, o último elemento da lista mais curta será reutilizado. A altura do widget é dividida entre os painéis, e painéis idênticos são combinados.

Gráficos de pizza com várias dimensões ou medidas sempre usam gráficos separados. O seletor de disposição não está disponível.

As linhas do tempo usam name e StartTime, opcionalmente FinishTime. Um widget numérico usa o primeiro valor. Os diagramas de Sankey usam source, target e value ou count. Os gráficos de bolhas usam x, y e size ou z, opcionalmente name e series. O widget de comentário usa texto em vez de uma consulta.

Modo avançado#

O modo avançado permite escrever SQL quando o construtor de consultas do widget não oferece a consulta necessária. É necessário escolher "Advanced mode" e abrir "SQL". Exemplos e variáveis do painel aparecem aqui. "Save" aplica a consulta e "Cancel" fecha sem salvar. Uma prévia de demonstração não confirma a execução do SQL: o resultado deve ser conferido no widget salvo.

A consulta usa mining_data, o log de eventos. A coluna ProcessID armazena o identificador do processo, e ProcessID = '41' mantém apenas seus eventos. O valor 41 vem de ProcessID no painel de detalhes de um evento: em Dados, o projeto e o processo Обработка заявок foram selecionados e uma linha de evento foi aberta com um clique duplo.

ID contém o identificador do evento. count(DISTINCT ID) conta eventos com identificadores distintos, e AS count dá à coluna resultante o nome count. Esta consulta não usa variáveis do dashboard.

Exemplo: é informado Количество событий em "Widget name*", escolhido "Number" e inserida a consulta abaixo em "SQL". Ao clicar em "Save", o widget mostra 14 para o processo de exemplo com 14 eventos. O identificador 41 pertence a esse exemplo. Em outra instalação deve ser usado o identificador do próprio processo.

SELECT count(DISTINCT ID) AS count
FROM mining_data
WHERE ProcessID = '41'

8. Variáveis globais#

As variáveis globais são widgets "Variable filter". Elas fornecem o valor escolhido pelo usuário a outros widgets do painel.

Valor estático#

Um valor estático define o valor inicial do filtro sem consultar uma fonte de dados.

"Variable filter" armazena um valor usado por outros widgets. "Widget name*", "Type" e "Variable type" são obrigatórios. Em "Type", escolha "Variable filter".

A lista "Variable type" oferece:

• Int — número inteiro, como um limite de linhas;
• String — valor de texto, como o nome de um computador para filtrar eventos;
• Date — data e hora para filtrar eventos por período;
• Number — número com parte decimal para condições numéricas;
• "Select (multi)" — seleção de um ou mais registros de uma fonte de dados.

Sem fonte de dados, "Variable value" e "Default value" ficam disponíveis. O valor atual é alterado no modo de consulta. Date utiliza um calendário. Com uma fonte de datas, ele marca em azul os dias com dados e abre a data disponível mais próxima. O campo fica temporariamente bloqueado enquanto as datas carregam.

Exemplo: "Widget name*" é Лимит строк, "Type" é "Variable filter" e "Variable type" é Int. "Specify data source" está desmarcado. "Variable value" e "Default value" contêm 5.

Para usar a variável em outro widget, selecione seu nome em uma condição de filtro. Em SQL, obtenha sua referência na lista de variáveis abaixo da consulta. Ao executar a consulta, a referência é substituída pelo valor atual.

Fonte de dados#

A fonte de dados preenche o filtro com valores de uma tabela, consulta SQL ou lista preparada.

A lista "Data source selection" oferece:

• "Dynamic (database)" — obtém valores de uma tabela e coluna. Use para nomes de computadores ou aplicativos do log de eventos;
• "SQL query" — obtém valores do resultado de uma consulta. Use para filtrar ou transformar as opções;
• "Fixed list" — define valores manualmente. Use para um conjunto conhecido, como categorias de solicitações.

"Fixed list" está disponível apenas para "Select (multi)". Os outros tipos com fonte de dados oferecem "Dynamic (database)" e "SQL query".

Filtro-variável de uma tabela#

A fonte de dados fornece valores para selecionar no modo de consulta. "Select (multi)" sempre usa uma fonte. Para outros tipos, ative "Specify data source". Os campos de valor atual e padrão ficam ocultos.

Em "Dynamic (database)", selecione "Source table" e "Source column". Também são preenchidos "Widget name*", "Type" e "Variable type".

Exemplo: "Widget name*" é Компьютер, "Type" é "Variable filter" e "Variable type" é "Select (multi)". "Data source selection" é "Dynamic (database)", "Source table" é mining_data e "Source column" é mining_data.ComputerName.

Filtro-variável de SQL#

"SQL query" obtém os valores do resultado de uma consulta. Informe a seleção em "Source SQL query". Depois de salvar, o item atual é escolhido no dashboard.

A consulta seleciona valores distintos de AppName, os nomes dos aplicativos, no log mining_data. ProcessID = '41' mantém os eventos de Обработка заявок. O valor 41 vem de ProcessID no painel de detalhes de um evento em Dados. O alias value nomeia a coluna da qual o filtro obtém os aplicativos da lista. A consulta não usa variáveis do dashboard.

Exemplo: "Widget name*" é Приложение, "Type" é "Variable filter" e "Variable type" é "Select (multi)". "Data source selection" é "SQL query". "Source SQL query" contém SELECT DISTINCT AppName AS value FROM mining_data WHERE ProcessID = '41'.

Filtro-variável com lista fixa#

"Fixed list" define os valores manualmente. Cada campo "Value" contém um item. O botão com sinal de mais adiciona uma linha e o controle de exclusão remove um item.

Exemplo: "Widget name*" é Вид заявки, "Type" é "Variable filter" e "Variable type" é "Select (multi)". "Data source selection" é "Fixed list". Os dois campos "Value" contêm Отчет e Заявка.

9. Additional Data no construtor de consultas do widget#

Additional Data permite usar detalhes adicionais de eventos importados no construtor de consultas do widget.

Additional Data contém dados adicionais dos eventos fornecidos ao importar CSV, como o departamento que atende uma solicitação. Ao carregar logs CSV em "Processes", associe a coluna necessária a "Additional Data".

As colunas adicionais disponíveis são escolhidas em "Column" ao configurar filtros e séries do resultado. Seus nomes usam mining_data.{key}, em que a chave é o nome original da coluna CSV. Se um campo não aparecer, confira o mapeamento da importação. Se estiver correto, peça ao administrador para verificar a disponibilidade do campo.

Exemplo: em "Results", a busca de Отдел em "Column" não encontra uma coluna adicional. A importação e disponibilidade precisam ser verificadas antes da seleção.

10. Exportar painel para PDF e PNG#

A exportação permite salvar indicadores escolhidos para relatórios ou compartilhamento.

Botão "Export"#

"Export" no modo de consulta oferece:

• "Entire dashboard as PDF" — salva um PDF com várias páginas;
• "Entire dashboard as PNG (ZIP)" — salva imagens dos widgets em um arquivo;
• "Select widgets…" — permite selecionar widgets e usar "Export selected as PDF" ou "Export selected as PNG".

Os filtros-variáveis não são incluídos nos arquivos exportados.

Exemplo: "Export" está aberto para salvar a tabela e o indicador numérico. "Entire dashboard as PDF" exporta ambos para um arquivo.

11. Importar e exportar JSON#

JSON permite transferir configurações e criar cópias de segurança. Em "Customize Dashboards", encontre o painel e marque a caixa da linha. "Export JSON" salva a configuração em um arquivo.

Para carregar configurações, use "Import JSON" na mesma tela e selecione um arquivo preparado. Os eventos dos processos não são incluídos.

Exemplo: Обзор заявок está selecionado no registro. "Export JSON" salva sua configuração.

Comparação de processos em um dashboard#

A comparação permite identificar diferenças entre a rota real e um processo de referência.

Expanda "Dashboards" no menu esquerdo e selecione Сравнение маршрутов. A criação do painel a partir de um modelo é descrita em "Grafo", seção "1. Criar um gráfico".

O painel de filtros contém dois elementos:

• "Process" — seleciona a rota real;
• "Reference process" — seleciona outro processo do mesmo projeto.

Deixar "Reference process" vazio desativa a comparação.

O widget Process graph deve obter o processo do filtro-variável Process e a referência do filtro-variável Reference process. Em "Project ID", informe o projeto ao qual os dois processos pertencem. O exemplo de treinamento usa o ID 24. Para seus dados, use o ID do seu próprio projeto.

Exemplo: "Process" tem Обработка заявок selecionado. Digite Эталон обработки заявок em "Search", acima de "Reference process", e selecione esse registro. Selecione exatamente um registro em cada filtro.

O grafo mostra as duas rotas. A legenda marca as transições comuns com uma linha azul contínua, as exclusivas do processo real com uma linha vermelha tracejada e as exclusivas da referência com uma linha verde contínua.

Neste exemplo, o nó Уточнение данных aparece apenas no percurso real, enquanto o nó Оформление заявки aparece apenas no percurso de referência.

Para desativar a comparação, remova a seleção de referência. Consulte Grafo.

Aparência do dashboard#

A aparência permite ajustar fundos, bordas e texto para facilitar a leitura dos indicadores.

"Dashboard appearance" abre sua janela pop-up no Construtor de dashboard. "Save" aplica as alterações. Fechar sem salvar mantém a aparência anterior.

A lista "Background mode" oferece:

• "Default" — usa a aparência padrão;
• "Solid color" — preenche o fundo com uma cor selecionada;
• "Upload picture" — usa uma imagem no fundo do dashboard. Não está disponível para os widgets;
• "Gradient" — cria uma transição entre duas cores selecionadas.

Após escolher "Upload picture", o botão aceita arquivos PNG, JPEG, GIF ou WebP de até 5 MB.

Elementos obrigatórios do fundo:

• "Background mode" em "Dashboard background" — fundo do painel;
• "Background mode" em "All widget backgrounds" — fundos dos widgets.

Parâmetros adicionais:

• "Color" em um bloco de fundo — cor uniforme;
• "First color" — início do gradiente;
• "Second color" — fim do gradiente;
• "Gradient angle, °" — direção do gradiente;
• "Transparency" — fundos opacos em 0 % e transparentes em 100 %;
• "Customize border" — ativa uma borda comum para os widgets;
• "Color" em "All widget borders" — cor da borda;
• "Width, px (0–10)" — espessura da borda;
• "Customize text color" — ativa uma cor comum do texto;
• "Color" em "Dashboard text color" — cor do texto;
• "Padding (px)" — espaço interno;
• "Corner radius (px)" — cantos arredondados;
• "Apply to all users" — salva a aparência compartilhada da conta. Sem marcar, a configuração é pessoal e tem prioridade sobre a compartilhada.

Exemplo: o fundo do painel usa um gradiente de azul-claro para branco em 90°. Os widgets têm fundo branco uniforme e transparência 0 %. Uma borda cinza-clara de 1 px e texto escuro estão ativados. O espaço interno é 12 px e o raio, 8 px. "Apply to all users" está desmarcado.