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

# 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="/files/n84IKId8x8DZxD8nPrF8" 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="/files/zPJ2gTvpjkzGkTeXmDJa" 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="/files/eP4Y6OmLivNXYxq9Mfr1" 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="/files/IUNGE0k5dd6JSqKsjZAo" alt=""></div>

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

![](/files/rK8wZ7NTytKY1FOqSKMm)

**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="/files/H85aWDsNpe87XbOCfWIk" alt=""></div>

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

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

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

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

<div align="left"><img src="/files/EKwKgjNDskSJRq2riLJz" 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="/files/1Yg8ddrq6UABbsD9PH3W" alt=""></div>

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

<div align="left"><img src="/files/yJdShtmEjhY1QVTVhb0t" 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="/files/dDX2o6hueaQ6VSF0Lo4k" 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="/files/zcsafNWmW8Hr1fxEcu9k" alt=""><figcaption></figcaption></figure></div>

**Modo Padrão**:

<figure><img src="/files/O5HaPKcJWDoEdnZ1CZg4" alt=""><figcaption></figcaption></figure>

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

<div align="left"><figure><img src="/files/TeTxZNMfbywDOkv5tui9" alt=""><figcaption></figcaption></figure></div>
