> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards.md).

# Criação e Edição de Dashboards

*<mark style="color:blue;">Dashboards</mark>* são as representações em conjuntos de elementos, compostos por objetos (componentes) de: imagens, textos e indicadores individuais diversos (e estes então associados a mapeamentos de dados - Metadados).

Neste contexto, podemos voltar a destacar que *Pastas* são então estruturas em árvore de forma a organizar sequências de Dashboards e, se necessários, Sub-dashboards.

Para criar um <mark style="color:blue;">DASHBOARD</mark> é necessário <mark style="color:blue;">selecionar uma</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Pasta</mark>* e clicar sobre o menu *<mark style="color:blue;">MENU</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>*:

![](/files/j2OoXlywUDPQPeImDTkR)

É possível criar Sub-dashboards, criando um novo dashboard a partir de um clique sobre outro já existente, e novamente indo na opção *<mark style="color:blue;">MENU</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>*.

Ao clicar na Opção <mark style="color:blue;">ADICIONAR</mark>, as seguintes possibilidades são disponibilizadas

<div align="left"><img src="/files/eY78Fj11vDxnaQWm615E" alt=""></div>

### **Novo Dashboard**

Cria um novo painel de indicadores desde sua fase inicial, sem componentes em tela para que sejam construídos em sua continuidade. Ao clicar em “Novo Dashboard”, na janela que será aberta basta inserir: uma descrição para identificação do novo Dashboard, sua documentação relacionada (se necessário) e a posição que se encontrarão suas abas, se assim houver necessidade. Por fim, clicar em <mark style="color:blue;">SALVAR</mark>.

***Importante:***

Ao criar um Dashboard, ou editar um já existente, em sua tela de cadastro em paralelo a cadastros básicos, também será apresentada opção de REPRESENTAÇÃO POR IMAGENS OU MINIATURAS.

Com esta opção será possível representar dashboards e pastas com imagens ou miniaturas para o usuário final/consumidor de informações, em sua navegação no Weknow via versão navegador web .

Para representar um dashboard: No menu de opções clique em *<mark style="color:blue;">MENU</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Editar</mark>*. Na sequência, selecione o modo da imagem (Miniatura ou Imagem) e clique em Carregar do Disco.

* Miniatura: Representará o dashboard com miniaturas geradas automaticamente com base no tipo do dashboard.
* Imagem: Você poderá selecionar uma imagem do seu computador que representará o dashboard.

<div align="left"><img src="/files/fOdrwXQMxKKFHMLvpV2G" alt=""></div>

<mark style="color:blue;">**Modo fixo (imagem)**</mark>:

<div align="left"><img src="/files/6Pd9Ena5XQPNgKI8YgrN" alt=""></div>

<mark style="color:blue;">**Modo miniatura**</mark>:

<div align="left"><img src="/files/Kxnr8R92Ny9wu4DR3ZrU" alt=""></div>

<mark style="color:blue;">**Exemplos na versão web com o modo imagem**</mark>:

![](/files/gYUv4afJn5cyOxCU0Btx)

<mark style="color:blue;">**Exemplos na versão web com o modo miniatura**</mark>:

<div align="left"><img src="/files/mY2qsn8sACJ86qEgP3xK" alt=""></div>

{% hint style="danger" %} <mark style="color:red;">**IMPORTANTE:**</mark> Para gerar as miniaturas é necessário ativar a opção “Atualização das Miniaturas de Dashboard” no Gerenciador de Tarefas do Weknow.
{% endhint %}

<mark style="color:blue;">**Para representar uma pasta**</mark>**:**

Assim como a edição no cadastro básico de um Dashboard, a edição de Pastas que agregam conjuntos de Dashboards também podem ter representações de imagens em miniatura, que serão exibidas via navegação do Weknow em versão navegador web.

Para isto, no menu de opções clique em *<mark style="color:blue;">MENU</mark>* >> *<mark style="color:blue;">Editar</mark>* >> *<mark style="color:blue;">Editar</mark>*. Na sequência, selecione a imagem e clique em Carregar do Disco:

<div align="left"><img src="/files/BhDIj8RO41Jw1fIHqTZz" alt=""></div>

Ao clicar em carregador do disco será possível selecionar qualquer imagem da máquina.

<div align="left"><img src="/files/6Pd9Ena5XQPNgKI8YgrN" alt=""></div>

### Dashboard já existente

Nesta ação podemos reaproveitar algum Dashboard já existente, citando o mesmo em uma nova área de conhecimento agrupando-o a mais dashboards em outro conjunto de painéis.

***Importante:***

Nesta modalidade de utilização de um Dashboard já existente, ao citá-lo em outra área de conhecimento, o Dashboard ainda é único, ou seja: ele ainda é o mesmo Dashboard origem, porém apenas citado em outro agrupamento. Ele não se torna um dashboard independente;

Para um novo dashboard apenas duplicando elementos de um dashboard já existente, no menu de opções clique em *<mark style="color:blue;">MENU</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>* >> *<mark style="color:blue;">Novo Dashboard</mark>*. Na sequência, com este novo dashboard até o momento ainda completamente em branco, realize a cópia de objetos de outro dashboard via menu de opções clicando em *<mark style="color:blue;">DASHBOARD</mark>* >> <mark style="color:blue;">área</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Conteúdo</mark>* >> *<mark style="color:blue;">Copiar</mark>* e selecione o Dashboard que será referência para esta cópia de objetos componentes.

Opte por “*<mark style="color:blue;">Duplicar os componentes e Copiar filtros do dashboard de Origem</mark>*”, caso deseje que os componentes de origem sejam completamente independentes destes objetos do novo dashboard. Desta forma, os objetos de origem se tornam apenas referência para a cópia desejada, e não serão alterados caso o objeto no dashboard destino seja alterado.

<div align="left"><img src="/files/Y1osfnNzi7ZVlachsz7b" alt=""></div>

Um Dashboard pode ser estruturado com um ou mais *<mark style="color:blue;">componentes de indicadores individuais</mark>*, também identificados como *<mark style="color:blue;">objetos</mark>*.

Os objetos componentes de indicadores individuais são as representações de como as informações serão visualizadas em tela. *<mark style="color:blue;">Em exceção dos objetos imagem e contêiner de filtros</mark>*, todos os outros tipos de objetos possuem aplicabilidade como indicadores de valores, e seus processos de confecção possibilitando associação a mapeamento de dados (<mark style="color:blue;">metadados</mark>). Com isto, objetos indicadores podem citar campos que se façam necessários, e agregações para sumarização de seus valores a partir de sobreposição de filtros aplicados a este metadado relacionado diretamente nesta edição do objeto em questão.

No processo de criação ou edição de cada tipo de objeto a etapa final será diferenciada, de forma a ser configurada de acordo com seu objetivo conceitual e/ou estatístico.

#### Tipos de objetos que podem ser inclusos na composição de um dashboard:

* [Componente Planilha](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-planilha.md);
* [Componente Gráfico](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-grafico.md);
* [Componente Termômetro](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-termometro.md);
* [Componente de Texto](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-texto.md);
* [Componente Mapa](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-mapa.md);
* [Componente Cartão](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-cartao.md);
* [Componente Imagem](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/componente-imagem.md);
* [Filtros](/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/filtro.md).

Para adicionar um novo componente e montar um Dashboard, primeiro selecione qual deverá ser o seu Dashboard;

Através da barra de ferramentas de *<mark style="color:blue;">Dashboard >> Inserir >> Tipo de componente</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">individual que deseja adicionar ao Dashboard</mark>:

<div align="left"><img src="/files/XBr4a3qzvsLDSmlo4APY" alt=""></div>

Ao clicar em um dos tipos de componente para sua inserção no Dashboard, neste momento a área do Dashboard terá destaque sobre as posições onde se poderá alocar este novo componente.

Ao escolher a área onde será alocado o indicador em tela, clique sobre o local desejado, e prossiga as etapas de criação.

A seguir serão descritos os passos gerais de como criar basicamente qualquer tipo de componente:

Selecionar a forma que deseja criar o componente. *Todos os componentes*, possuem as três opções conforme imagem a seguir:

<div align="left"><img src="/files/JR9BKYG2hrSHUccmWFCx" alt=""></div>

* <mark style="color:blue;">**Criar novo componente**</mark>, desde sua fase inicial;
* <mark style="color:blue;">**ou**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Duplicando de um componente já existente**</mark>* (criando um novo componente, independente, mas com configuração inicial idêntica a alguma referência);
* <mark style="color:blue;">**ou,**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Utilizando um componente já existente**</mark>*. Nesta opção deverá ser dado atenção ao fator de que se alterado o componente em algum Dashboard, todas as suas menções em outros dashboards distribuídos pela ferramenta terão esta mesma alteração, pois na prática trata-se de um componente único.

Ao criar um novo componente tipo planilha, a próxima fase é identificar o metadado que será utilizado. Selecione o metadado e clique em <mark style="color:blue;">**AVANÇAR**</mark>;

<div align="left"><img src="/files/ViJhKU4ZGC50LI22t9NW" alt=""></div>

Para alterar as opções de conexão para componentes que não sejam planilha, entre no seguinte caminho: *<mark style="color:blue;">Assistente >> Menu lateral >> Dados</mark>*;

Em sua última fase de edição, cada tipo de componente possui suas peculiaridades, de acordo com seus objetivos e características.

A partir da versão 3.0 todos os objetos componentes, que tenham possibilidade de associação a metadados, possuem uma tela de configuração com opções em tela única, cujas peculiaridades podem ser trabalhadas entre as opções de menu à esquerda da tela:<br>

<div align="left"><img src="/files/tjJJWpxhKeaoUZKUGtUW" alt=""></div>

Dentro do componente ainda, é possível *<mark style="color:blue;">criar novos filtros que atuarão limitando ainda mais linhas do que foi retornado pelo metadado</mark>*. Para isto, à esquerda, clique em *<mark style="color:blue;">**Configuração**</mark>*<mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**e arraste campos que serão filtros para as áreas**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Filtros por registro**</mark>*<mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**e/ou**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Filtros agrupados**</mark>*, onde respectivamente há: necessidade de filtros campos sem agregação, oi. Levando em consideração valores obtidos após aplicar fórmulas de agregação (obtendo comportamento similar à clausula Having SQL):

<div align="left"><img src="/files/Fl5vHHBHYc0vQXFI2GjB" alt=""></div>

Se necessário, adicione os campos e critérios para criação de filtros dos dados que serão trazidos pelo metadado mencionado na opção Dados, conforme escolhido na fase inicial da criação do objeto.

Assim como no cadastro de *Metadados*, todos os componentes individuais (exceto do tipo imagem) também possuem funcionalidade para criação de *campos calculados* em tempo de edição. Estes campos podem se relacionar em qualquer área da edição final do componente, utilizando a sintaxe do banco de dados relacionado à conexão já definida.

Da mesma forma, na edição de todos os indicadores, é possível acionar opção que receba valores externos que façam parte de campos calculados temos a opção de adição de *campos de entrada*:

<div align="left"><img src="/files/dO3hnTfmqP46CcLRVSrr" alt=""></div>

Por fim, caso necessário desconsiderar as ações feitas desde última abertura desta tela de edição, clique em **CANCELAR**.

Para finalizar a inserção de edições do objeto em questão, clique em **CONCLUIR**.

Na área <mark style="color:blue;">**DADOS**</mark>, estão dispostas configurações relacionadas ao metadado escolhido como referência de consulta de dados deste objeto em questão. Alguns destaques desta área:

### **Forçar dados online:**

Caso o metadado do componente seja sob modo de bas, aparecerá a opção “*<mark style="color:blue;">Forçar dados online</mark>*”. Esta opção possibilita exceções, definindo a consulta do componente em específico como “online”, mesmo que seu respectivo metadado seja sob Armazenamento em “modo offline” por padrão. Como benefício, esta opção visa auxiliar desenvolvedores de conteúdo Weknow evitando a duplicidade de manutenção de códigos para que não tenha códigos idênticos onde única diferenciação seria o modo de consulta/armazenamento:

<div align="left"><img src="/files/BoWMNfDNq59XfII3ztk6" alt=""></div>

### Cache de dados:

Quando acionada esta opção em paralelo o campo tempo expiração (minutos) é habilitado, e então o objeto grava temporariamente dados brutos em cache de memória a cada X minutos (indicado em Expiração (minutos). Esta condição faz com que o objeto não consulte o banco de dados citado na conexão principal do metadado ou objeto de forma exclusivamente online (em requisições SEMPRE diretamente nas conexões citadas) pois consulta este online e carrega dados no tempo que pensar ser necessário, ou em atualizações de seus filtros para carregamento de novo conjunto de dados em cache. Configuração NÃO OBRIGATÓRIA. Utilize-a conforme necessidade.<br>

<div align="left"><img src="/files/TmNdb0I9DPuJT3oHZcuG" alt=""></div>

### **Detalhamento**

Local para indicação se o objeto terá opção de detalhamento simples (linha a linha) e quais os campos que serão exibidos ao usuário final (consumidor de informações) assim que este solicitar detalhamento em modo de visualização via navegador;

### **Explorador de Dados**

Local para configuração de ativação/inativação do modo de “Exploração de dados” no indicador em questão a seus usuários finais, quando estes utilizarem este indicador em modo browser. Diferentemente da opção detalhamento, o explorador permite criação de visões pelo usuário final, e cruzamentos de campos criando visões de forma multidimensional (cubos de dados) e alternando entre modo planilha e gráfico.

<div align="left"><img src="/files/kxz7pcZgJufJPlQscLEW" alt=""></div>

### **Aparência**

Local para configuração de formatação de textos/bordas e outras peculiaridades de Conteiner (limites da caixa do indicador), Título e Conteúdo do indicador.

### **Vinculos Áutomaticos**

Local para configuração dos campos que serão utilizados nos vínculos ou serão carregados ao acessar o componente.

### **Documentação**

Local para inclusão de textos que sirvam de documentações e informações que a instituição pense ser importante ao conhecimento de quem analisa o indicador em questão. Aceita tags HTML para formatação de texto da documentação, e com aplicação de formatação em modo navegador ao usuário final. É possível visualizar na versão Weknow web.

<div align="left"><img src="/files/szZnauZcxF6ZQPpJl65K" alt=""></div>

#### Ao clicar em adicionar será aberto 3 opções:

* Novo arquivo: Adicionar um novo arquivo/anexo;
* Nova URL: Adicionar um documento via URL;
* Anexo existente: Arquivos que já foram utilizados em outro dashboard.

Em resultado via versão Browser, veja o tipo de anexo em “Tipo”:

<div align="left"><img src="/files/Ni0yVcyklp0S11CrUVsn" alt=""></div>

A seguir, veja como adicionar documento/anexo a um componente:

<div align="left"><img src="/files/HuumahvRQlrkRZ4Dq106" alt=""></div>

Para visualizar na versão web, clique nos três pontinhos:

<div align="left"><img src="/files/LMtvaNpQy2yxjIJnAIHC" alt=""></div>

E clique em anexos:

![](/files/EFQCBhi05rvzL4oJpgGF)

Com isso, irá abrir o menu com os anexos/documentos anexados:

<div align="left"><img src="/files/vbOkg0tLazeeoqVqixqT" alt=""></div>

### Pré-Visualizar e Plano de Execução

Essas opções gerais estão presentes em todos os componentes (com exceção da *Imagem*) e são as opções mais simples dentro de todas as citadas anteriormente. A primeira tem o objetivo de melhorar a performance e a segunda é utilizada para depuração em caso de falhas no carregamento dos dados.

#### Veja mais detalhes de cada uma das opções:

A *<mark style="color:blue;">Pré-visualização</mark>* dos componentes é a opção responsável por recarregar o indicador toda vez que é feita alguma alteração em sua configuração.

Por padrão os indicadores vêm com a opção *<mark style="color:blue;">Atualizar a pré-visualização automaticamente</mark>* selecionada, o que significa que após fazer uma alteração o sistema automaticamente atualizará o indicador. Caso contrário a cada nova alteração é necessário clicar em *<mark style="color:blue;">Pré-visualizar</mark>* para que o indicador seja atualizado.

<div align="left"><img src="/files/uPhbvuLS0O0MKShk1F0Y" alt=""></div>

*<mark style="color:blue;">**Atenção!**</mark>* Para certos indicadores é sugerido que a opção automática seja desabilitada uma vez que caso o SQL utilizado no *<mark style="color:blue;">Metadado</mark>* seja muito pesado pode comprometer a performance do sistema para recarregar o indicador.

A opção *<mark style="color:blue;">Plano de execução</mark>* é basicamente uma lista de funções que são executadas incluindo a execução do código *SQL*, para chegar ao resultado do indicador configurado. São levados em conta os dados e ainda quaisquer funções habilitadas, como filtros e outros. Segue exemplo:

<div align="left"><img src="/files/KD7Ycdx7K0SBO4NDxTJm" alt=""></div>

Como mencionado anteriormente, o objetivo dessa tela é ajudar na depuração de possíveis erros por parte da equipe especializada de correção do Weknow. Logo sob o ponto de vista do usuário final não possui valor funcional. O seu código poderá ser solicitado em atendimentos do Suporte.