> 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.1/client-desktop/recursos-extras-de-dashboards/variaveis-de-contexto.md).

# Variáveis de Contexto

Através das *<mark style="color:blue;">VARIÁVEIS DE CONTEXTO</mark>* o Weknow conta com a possibilidade de personalização de uso ao menor nível, auxiliando na segurança ao acesso de informações, e na praticidade de uso, dispensando preenchimento de filtros em situações que os mesmos sempre sejam os mesmos.

Desta forma, um componente indicador único, pode apresentar diversos resultados diferentes, dependendo do *<mark style="color:blue;">usuário</mark>* que esteja acessando o Weknow, ou ainda, se tratar de um componente acessado por diversas *áreas de conhecimento distintas*, mas dependendo de qual a área de conhecimento que ele se encontre, deva ter parâmetros diferenciados em seus filtros. Em ambos os casos, as variáveis de contexto tornam os possíveis filtros “pré-fixados” nestas variáveis de contexto.

Em complemento, também é possível o cadastro de uma variável de contexto *GLOBAL*, utilizada então independente do usuário logado ou da área de conhecimento acessada.

Para inclusão de variáveis de contexto personalizadas ao nível de usuário, ou de cadastro de menu, estes respectivos cadastros possuem um *Botão>> VARIÁVEIS*:

Informe então o nome identificador dessa variável, que será a referência para os filtros e fórmulas em uso na ferramenta, e ao lado, informe o respectivo valor que essa variável deverá assumir.

É possível que uma váriavel tenha mais de um valor, mas para isso é necessário informar o separador.

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

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

*<mark style="color:blue;">Utilize os botões para auxílio nesta configuração:</mark>*

“***+***” – Insere nova variável de contexto

“***-***” – Remove variável de contexto individualmente

“***x***” – Remove todas as variáveis de contexto relacionadas ao respectivo cadastro

Após configurados usuários ou cadastro de menus com suas respectivas variáveis de contexto, vá ao *componente* que será afetado por esta variável, e, via campo *FÓRMULA* indique que ele busque esta variável como filtro, através da função *GetVar.*

Exemplo de aplicação prática com variáveis de contexto por *<mark style="color:blue;">USUÁRIO</mark>*:

*Utilize em casos onde um determinado usuário deve ver apenas consultas a indicadores referentes ao seu contexto, como dados relacionados a: seu código de matrícula; dados de seu setor; dados da região de sua responsabilidade de controle, entre outros...*

Exemplo de aplicação prática com variáveis de contexto por *<mark style="color:blue;">CADASTRO DE MENU</mark>*:

*Se em um cadastro de menu possui componentes que são de uso em comum com outros menus, e cada menu deve ver apenas seus dados sem possibilidade de ajustar isto em filtros na tela para não ter possibilidade de ver outros setores, basta associar uma variável de contexto a cada uma destas áreas de conhecimento.*

*Desta forma, todos estarão vendo o mesmo componente, porém, apenas com informações exclusivas à sua regra de negócio.*

## Variáveis de Contexto Globais:

Dentro do Weknow podemos criar uma variável de contexto em *Administração*>> *Variáveis de Contexto* que seja geral para todos os usuários e áreas de conhecimento (Exemplo: COD EMPRESA) facilitando possíveis manutenções nos indicadores caso esta variável precise ser alterada para todos os componentes.

Exemplo de aplicação prática com variável de contexto *<mark style="color:blue;">GLOBAL</mark>*:

*No exemplo a seguir, temos uma variável identificada como “varcontexto\_empresa” com valor 1:*

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

Para sua *<mark style="color:blue;">utilização em um filtro</mark> de pesquisa por empresa*, informamos então esta variável *<mark style="color:blue;">como valor inicial</mark>* no campo *<mark style="color:blue;">FÓRMULA</mark>* através da função *GetVar (“varcontexto\_empresa”)*:

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

Se todos os filtros de empresa possuírem relação com esta variável de contexto, quando necessário, bastará alterar o cadastro geral da variável de contexto, e ela será automaticamente atualizada em todos os indicadores ou filtros que a utilizarem.

## Variáveis de contexto internas do Weknow:

**sys:userid**: Variável numérica contendo o ID do usuário logado;

**sys:userdisplayname**: Variável textual contendo o nome de exibição do usuário logado;

**sys:dashboardid**: Variável numérica contendo o ID do dashboard do contexto (se houver);

**sys:menuid**: Variável numérica contendo o ID do menu onde o dashboard está vinculado (se houver);

**sys:ipaddress**: Variável textual contendo o endereço IP da máquina;

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