> 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.2/client-desktop/criacao-e-edicao-de-dashboards/componente-planilha.md).

# Componente Planilha

Weknow Client Desktop –  Criação e Edição de Dashboards - Componente Planilha

### Exemplo:

Antes de iniciar a edição do componente Planilha, deve-se ter em mente qual o tipo de planilha necessária para o contexto que se deseja atender:

* Planilha monodimensional (apenas com linhas e N colunas básicas);
* Planilha multidimensional (que cruzam linhas e colunas em N dimensões);

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/emr5x8CFhM05oH2it5HR/image.png" alt=""></div>

Ao lado esquerdo temos os *<mark style="color:blue;">Campos disponíveis</mark>*, sendo uma lista de itens que são disponibilizados para utilização conforme o metadado informado em fase anterior durante a parametrização do componente.

**1)** Para uma lista simples, basta arrastar todos os campos para a área *Dados:*

**2)** Em *<mark style="color:blue;">Ordenação</mark>* é possível selecionar por quais campos a planilha será ordenada, também é possível usar função agregada e o sentido da ordenação (crescente/decrescente e A/Z).

***3)** Para planilhas que cruzam linhas e colunas, arraste os campos necessários distribuindo entre as áreas <mark style="color:blue;">Linhas, Colunas e Medidas</mark>. Feito isso, será possível:*

* Associar os valores a *<mark style="color:blue;">Funções agregadas</mark>* (Contar, Somar, Média, Mínimo, Máximo, Contar Distinto, Listar e Listar Distinto).
* *Indicar de trata-se de um <mark style="color:blue;">Campo percentual</mark> de acordo com a distribuição do valor em colunas ou linhas.*

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/VElrLfs1KBTjKffr8y6b/image.png" alt=""></div>

Para cada campo selecionado em *<mark style="color:blue;">Medidas</mark>*<mark style="color:blue;">,</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Linhas</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Colunas</mark>*, é possível clicar em seu nome para alterar seus títulos (de acordo com as áreas distribuídas).

<div align="left"><figure><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/CZuwbfA7rq6rKquK8v56/image.png" alt=""><figcaption></figcaption></figure></div>

Em Medidas é possível classificá-lo por Percentual, Ranking, Variação percentual e Variação absoluta.

**5)** Quando estiver marcada a opção “*<mark style="color:blue;">Pré-visualizar</mark>*” mostrará o resultado de acordo com os parâmetros e configurações realizadas até o momento, caso não esteja acionada a opção de atualização automática.

**6)** Ao clicar em *<mark style="color:blue;">Configurações Avançadas</mark>*, é possível ter acesso às *Opções* *Gerais* para adequar a planilha conforme a necessidade. Dentre elas:

1. Formatação de valores dos campos selecionados;
2. Inversão de layout entre colunas e linhas (Interessante quando sabemos que o resultado trata apenas uma linha, e ao usar a opção “Transpor linhas e colunas”, o componente se apresenta como uma caixa de resumo Sintetizado);
3. Exibição e fórmulas de cálculos em Rodapés;
4. Exibir/Ocultar colunas ou linhas Totais;
5. Expandir Linhas/Colunas por padrão;
6. Formatação condicional de células; entre outras opções de personalização.

**7)** A opção de *<mark style="color:blue;">Formatação Condicional</mark>* das células, conforme valor apresentado, está disponível em *<mark style="color:blue;">Configurações Avançadas</mark>*<mark style="color:blue;">>></mark>*<mark style="color:blue;">Dados</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark>*<mark style="color:blue;">Inserir</mark>* *<mark style="color:blue;">formatação</mark>* (*botão direito do mouse*).

Nesta funcionalidade o Weknow apresenta no ícone “***\****” pré-definições que auxiliarão a configuração, que sempre deverá ser estudada de forma individual, obedecendo aos critérios da regra de negócio em questão no indicador:

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/PQQfkXC9DFi0SLxARyST/image.png" alt=""></div>

#### ***Exemplo:***

![](https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/GcCN2bTcaISfussZmTpq/image.png)

**8*****)*** Para pré-visualização de possíveis resultados, clique em **APLICAR**.

**9)** Ao concluir a edição das opções avançadas, clique em **OK**.

### Rolagem Automática

A opção **ROLAGEM AUTOMÁTICA** faz com planilha no modo monodimensional possa efetuar a rolagem automática em um dashboard em exibição, bastando estar presente na aba deste dashboard.

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/1A33J5nAIZ7S75ckFsRl/image.png" alt=""></div>

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/4krBcSdZ3ETR5T1FdCzB/8" alt=""></div>

Basta escolher o tipo de transição (Registro ou Página).

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/7aqyOgteJs3HT1krXeG4/9" alt=""></div>

Em duração será possível selecionar o tempo desejado (Milissegundos, Segundos ou Minutos).

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/iqGvkgaS9eFpCoqjORDP/10" alt=""></div>

Em intervalo será possível selecionar os intervalos (Milissegundos, Segundos ou Minutos).

Ao definir a transição, duração e intervalo, a rolagem começará automaticamente:

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/qmOlBgrEZsnmuTnz5mW6/11" alt=""></div>

A rolagem automática também funcionará nas apresentações:

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/j5I1k095ZH24HNaacc6m/image.png" alt=""></div>

### Alerta Sonoro

A opção **ALERTA SONORO** faz com que qualquer planilha possa avaliar uma condição a ser alertada de forma sonora em um dashboard em exibição, mesmo que seja indiretamente, bastando estar presente em qualquer aba deste dashboard.

#### Observações

1. Para mudança do mp3 padrão, dentro da instalação server acesse a pasta: Server\WWW\Data\ e inclua um arquivo MP3 nomeado como “alert” neste diretório.
2. Para que este som seja assumido em um dashboard ativo no momento, e com alerta sonoro configurado em um objeto planilha, atualize o browser com o atalho SHIFT + F5.

<div align="left"><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/bne9VxIKFoaXFOFlrTL2/image.png" alt=""></div>

Retornando à Edição do componente Planilha, para finalizar a edição deste componente, clique em **CONCLUIR**.

### Disposição das Linhas

A opção de **DISPOSIÇÃO DAS LINHAS** está disponível somente no *modo Multidimensional* com as seguintes alternativas:

* Padrão;
* Árvore.

A opção visa ajudar na visualização da planilha.

<div align="left"><figure><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/1IXXidg8CwubyvL0k8t2/image.png" alt=""><figcaption></figcaption></figure></div>

**Modo Padrão**:

<figure><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/F0H7h2ljKsVGYPOL0HuT/image.png" alt=""><figcaption></figcaption></figure>

**Modo Árvore**: A opção Árvore visa ser o modo mais compacto.

<div align="left"><figure><img src="https://content.gitbook.com/content/iXDNJ6WZritGdWRfF2yM/blobs/m6PFGzXf0pqNpq7nHzgh/image.png" alt=""><figcaption></figcaption></figure></div>