> 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/weknow-client/criacao-e-edicao-de-dashboards/propriedades-do-dashboard.md).

# Propriedades do dashboard

Após criar um dashboard, é possível alterar suas propriedades para definir informações de identificação, organização e comportamento.

Embora apenas o campo **Descrição** seja obrigatório durante a criação, o Weknow Client disponibiliza recursos adicionais para documentar o dashboard, configurar filtros, definir variáveis e utilizar outros recursos que auxiliam na organização e manutenção do projeto.

Neste artigo serão apresentadas as propriedades disponíveis no cadastro do dashboard.

***

### Acessando as propriedades

As propriedades de um dashboard podem ser alteradas a qualquer momento.

Para editar um dashboard:

1. Na árvore de projetos, selecione o dashboard desejado.
2. Clique em **Editar**.

A mesma tela utilizada durante a criação do dashboard será aberta, permitindo alterar suas propriedades sempre que necessário.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FEwyK26UunEAULgNvkCv2%2Fimage.png?alt=media&amp;token=6446fdaa-d01e-49b0-a982-fe89b7a85f12" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Alterar as propriedades do dashboard não afeta os componentes já existentes. As configurações podem ser modificadas sempre que necessário.
{% endhint %}

***

#### Informações gerais

Nesta seção são definidas as informações básicas do dashboard.

**Descrição:** Define o nome utilizado para identificar o dashboard na árvore de projetos.

**Documentação:** Permite registrar informações sobre o objetivo, funcionamento ou outras observações relacionadas ao dashboard.

A documentação facilita a manutenção do projeto e auxilia outros desenvolvedores na compreensão do painel.

**Palavras-chave:** Permite associar palavras-chave ao dashboard para facilitar sua localização por meio do recurso de pesquisa do Weknow.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FfEltnVjAprhXvLDJutpU%2Fimage.png?alt=media&amp;token=61b18d5f-886d-4930-8f71-77d746bca303" alt="" width="490"><figcaption><p>Palavras-chave (tags) cadastradas em um dashboard</p></figcaption></figure>

As palavras-chave podem ser utilizadas para descrever o conteúdo, a finalidade ou o contexto do dashboard, tornando sua localização mais rápida quando os usuários realizarem pesquisas.

Para adicionar uma palavra-chave, digite o termo no campo **Palavras-chave** e pressione **Enter** para confirmar o cadastro. Para adicionar outras palavras-chave, repita o procedimento.

{% hint style="info" %}
**Importante:**

* É necessário pressionar **Enter** após digitar cada palavra-chave para que ela seja registrada.
* É possível adicionar várias palavras-chave ao mesmo dashboard.\
  Para saber como utilizar o recurso de pesquisa e localizar dashboards por meio das palavras-chave cadastradas, consulte o artigo [Broken mention](broken://pages/xt3ddGzTKYb3CIJf1dgw).
  {% endhint %}

***

### Recursos do dashboard

Além das informações gerais, o dashboard disponibiliza recursos que podem ser utilizados durante seu desenvolvimento.

| Recurso                            | Descrição                                                                                         |
| ---------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Desativar vínculos automáticos** | Controla o funcionamento dos vínculos automáticos entre componentes do dashboard.                 |
| **Metadados**                      | Permite configurar metadados que poderão ser utilizados pelos componentes presentes no dashboard. |
| **Filtros**                        | Permite criar filtros compartilhados entre os componentes do dashboard.                           |
| **Anexos**                         | Permite associar arquivos ao dashboard para consulta ou documentação complementar.                |
| **Variáveis**                      | Permite criar variáveis reutilizáveis em diferentes componentes do dashboard.                     |

{% hint style="info" %}
Os recursos **Metadados**, **Filtros**, **Variáveis** e **Anexos** serão apresentados em artigos específicos desta documentação.
{% endhint %}

***

### Aparência

O cadastro do dashboard também disponibiliza propriedades relacionadas à sua apresentação visual.

| Propriedade          | Descrição                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| **Posição das abas** | Define onde as abas do dashboard serão exibidas durante sua visualização.                        |
| **Plano de fundo**   | Permite definir uma cor ou uma imagem para o plano de fundo do dashboard.                        |
| **Imagem da pasta**  | Permite configurar uma imagem representativa (miniatura) para o dashboard na árvore de projetos. |
| **Disposição**       | Define propriedades relacionadas ao layout, resolução e forma de exibição do dashboard.          |

{% hint style="info" %}
As configurações de aparência serão detalhadas no artigo[Broken mention](broken://pages/zzlOOYjUYUiHYdcBkuut), onde serão apresentados todos os recursos de personalização visual disponíveis para os dashboards.
{% endhint %}

***

### Salvando as alterações

Após realizar as configurações desejadas, clique em **Salvar** para gravar as alterações realizadas no dashboard.

As configurações poderão ser alteradas novamente a qualquer momento.

***

### Boas práticas

Durante a configuração de dashboards, recomenda-se:

* manter a documentação atualizada;
* utilizar palavras-chave que facilitem futuras pesquisas;
* configurar filtros e variáveis apenas quando forem realmente necessários;
* definir uma aparência consistente entre dashboards relacionados.

{% hint style="success" icon="lightbulb-on" %}
Configure as propriedades do dashboard antes de iniciar a criação dos componentes. Uma configuração inicial bem definida facilita o desenvolvimento e reduz a necessidade de ajustes posteriores.
{% endhint %}

***

### Próximo passo

Agora que você conhece as propriedades disponíveis no dashboard, o próximo passo é aprender a personalizar sua aparência.

Continue para o artigo [Personalização visual do dashboard](/wedocs-5.2/weknow-client/criacao-e-edicao-de-dashboards/personalizacao-visual-do-dashboard.md).
