> 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/cliente-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/4yXt6ny2DDnDTHV2uaYY/blobs/quTruqFJosNB9tT21IuI/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/4yXt6ny2DDnDTHV2uaYY/blobs/5CyDsZ3tiZxCTHhUts0Q/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/4yXt6ny2DDnDTHV2uaYY/blobs/EjLQ9Ghc5k1GWUxWTzkZ/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/4yXt6ny2DDnDTHV2uaYY/blobs/i56TRvOVMVaBqRUB4QK4/image.png" alt=""></div>

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

![](https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/BzJHAivh37XQq1PtPWYn/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**.

### Seleção por linha

{% hint style="danger" %}
Essa seção é exibida **exclusivamente no modo Monodimensional**.
{% endhint %}

A opção no assistente de criação/edição do componente **Planilha**, que permite definir **quais campos poderão ser utilizados como filtro ao selecionar uma linha do resultado**, trazendo mais controle e previsibilidade na navegação dos dados.

#### Onde encontrar

No assistente da Planilha, ao utilizar o **modo Monodimensional**, passa a existir a nova seção **Seleção por linha**, localizada logo abaixo de **Vínculos automáticos**.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F4aeuC8RYaMCDxzHZUO2u%2Fimage.png?alt=media&amp;token=ca8f63de-d1bd-43c7-b4ce-0696d0a7b202" alt="" width="563"><figcaption></figcaption></figure></div>

Ao configurar a **Seleção por linha**, a lista de campos disponíveis passa a seguir regras mais claras e consistentes. Somente são exibidos os campos que já estejam configurados nas **Colunas** do componente, garantindo maior coerência entre o que é exibido e o que pode ser utilizado na seleção.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FRJSbByN8hiIa2gouBmWa%2Fimage.png?alt=media&amp;token=a1e4e19b-ce25-4b6d-b3da-5529b1c5bb6a" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FSnMlTqoWGI38aoWryeOY%2Fimage.png?alt=media&amp;token=d699dbce-da57-4a62-a087-9a62a00eedbd" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
A configuração de **Seleção por linha** não terá efeito no dashboard quando os **Vínculos Automáticos** estiverem desativados.&#x20;
{% endhint %}

Além disso, são permitidos apenas campos que não possuam agregação ou que utilizem agregação do tipo **Mínimo** ou **Máximo**. Campos calculados existentes no metadado também podem ser exibidos, desde que não possuam agregação interna ou utilizem agregação **Mínimo** ou **Máximo**.

{% hint style="warning" %}
Campos criados localmente no componente deixam de ser exibidos na lista de Seleção por linha, mesmo que atendam às regras de agregação. Por fim, quando um mesmo campo estiver presente em mais de uma coluna, ele será exibido apenas uma única vez na lista, evitando duplicidades e tornando a configuração mais clara e objetiva.
{% endhint %}

### 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/4yXt6ny2DDnDTHV2uaYY/blobs/M4tGoVUkyJhV13TKFth0/image.png" alt=""></div>

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

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

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/a1qnDwDJNUbTzxYdigPC/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/4yXt6ny2DDnDTHV2uaYY/blobs/EaCyvgmpYkHhLrVA3COh/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/4yXt6ny2DDnDTHV2uaYY/blobs/9vatZ22Rgn7kvMHpb6gS/11" alt=""></div>

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

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/MP8j7EUs7TooXhdixDgl/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/4yXt6ny2DDnDTHV2uaYY/blobs/XKLD3Rx4j7ezc26BFYkE/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/4yXt6ny2DDnDTHV2uaYY/blobs/yrnvyVcR074VI9s76iLP/image.png" alt=""><figcaption></figcaption></figure></div>

**Modo Padrão**:

<figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/t6JbwckNT8Anpl2C27T9/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/4yXt6ny2DDnDTHV2uaYY/blobs/SnulhDz6mXzQx0f7hLhw/image.png" alt=""><figcaption></figcaption></figure></div>

***

## Seleção de Linha na Planilha com Controle de Filtro

#### Seleção de Linha

No componente **Planilha** dos Dashboards, é possível selecionar uma linha inteira antes da aplicação de filtros.

Ao **clicar uma única vez** em qualquer célula, a linha completa é destacada visualmente. Nesse momento, nenhum filtro é aplicado. A seleção permite que o usuário visualize e confira todas as informações daquela linha de forma organizada, facilitando a análise detalhada dos dados.

A seleção é apenas visual e permanece ativa até que uma nova ação seja executada.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FvkTFRlJgoNlzmBJ0PVbt%2FSele%C3%A7%C3%A3o-de-Linha.gif?alt=media&amp;token=48d63199-276a-46f1-8505-76fd95296ec6" alt="" width="563"><figcaption></figcaption></figure></div>

{% file src="/files/Cn2xoq2vMm9EhDHo2MCO" %}

#### Aplicação de Filtro por Valor da Célula

Após a linha estar selecionada, um **segundo clique** na mesma célula aplica o filtro com base no valor selecionado.

Esse comportamento mantém a funcionalidade tradicional de filtragem da planilha, porém adiciona uma etapa prévia de confirmação visual da linha.&#x20;

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F7dxQKcvg0TtD0t3Op3EY%2FAplica%C3%A7%C3%A3o-de-Filtro-por-Valor-da-C%C3%A9lula.gif?alt=media&amp;token=b42ebfde-05c0-480c-8198-02d97a13ea43" alt="" width="563"><figcaption></figcaption></figure></div>

{% file src="/files/LHazOtrTpCV4b9EZgaN5" %}

#### Remoção da Seleção

Um **terceiro clique** remove a seleção da linha e a planilha retorna ao estado padrão de visualização.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FvVinNEFBNTMbGcMJ91SA%2FRemo%C3%A7%C3%A3o-da-Sele%C3%A7%C3%A3o.gif?alt=media&amp;token=bd9a86e0-dcf5-48ef-930b-9abc56bd3603" alt="" width="563"><figcaption></figcaption></figure></div>

{% file src="/files/8oXL22aIxM8y9vl6Ddes" %}