> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/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.2/wedocs-4.0/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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FaqpInkQHgGTO7aUPbSYd%2Fimage.png?alt=media&amp;token=cc70cce4-a386-4f90-b727-e2a63ef9c716" 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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2Fc2xjLQz7tIcKSIPTmlnL%2Fimage.png?alt=media&amp;token=4462c436-152a-48fb-b315-67c8cea77980" 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"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2F5N1gkbgA2YyBbjb4VFGJ%2Fimage.png?alt=media&amp;token=1cf8c0fa-3e91-4c00-b8b4-ea59f5b8ad6a" alt=""></div>

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

**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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FlylTzEEZu64B36fD18K3%2Fimage.png?alt=media&amp;token=e9b89246-bf84-4a7a-8387-ed5f01d743b2" alt=""></div>

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

![](https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FYbKdQtDIhuBOkqPxYbOe%2Fimage.png?alt=media\&token=107c3f45-73f4-48ed-a5f4-7a5a2cf13d3a)

**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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FjhwnX09v0DoLiqEpGTqG%2Fimage.png?alt=media&amp;token=956b04d1-26d9-4f9a-a3af-2c24d9d259ff" alt=""></div>

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FJEs8SIquv9yJbNkDEJLn%2F8?alt=media" alt=""></div>

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

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FpVm4ogH6plTAJAE8Ztmb%2F9?alt=media" alt=""></div>

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

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FU3nHt5nUs99Zx8vPOrNY%2F10?alt=media" 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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FYBzB41GMumcJ2jTdEl9N%2F11?alt=media" alt=""></div>

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

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FQDu5TpqP7bh8sEQIM86a%2Fimage.png?alt=media&amp;token=d0b56ae1-ad2c-4e49-acd6-021633341931" 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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FmeJws5WrbYz5Q2mGOlcX%2Fimage.png?alt=media&amp;token=079df6d3-b44f-4bf1-a5a7-eb3a6e4e931c" 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://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FgLEdl10DUxB9ABQ8Srku%2Fimage.png?alt=media&amp;token=963798bb-dad5-4f11-9e1d-b4908855edc1" alt=""><figcaption></figcaption></figure></div>

**Modo Padrão**:

<figure><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FUU4vzrQqcaqRe8UE04gw%2Fimage.png?alt=media&amp;token=0ff5b2c2-1f28-4a7d-8405-902237c62310" alt=""><figcaption></figcaption></figure>

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

<div align="left"><figure><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FubDGTokmKn2Oj2zX6trD%2Fimage.png?alt=media&amp;token=c5814352-0a8b-4bf3-9de5-67b568cd82b5" alt=""><figcaption></figcaption></figure></div>
