> 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-5.1-es_es/cliente-desktop/recursos-extras-de-dashboards/variaveis-de-contexto.md).

# Variables de Contexto

A través de las *<mark style="color:blue;">VARIABLES DE CONTEXTO</mark>*, Weknow permite la personalización de uso al nivel más bajo, ayudando en la seguridad del acceso a la información y en la practicidad de uso, eliminando la necesidad de completar filtros en situaciones donde estos siempre son los mismos.

De esta forma, un componente indicador único puede presentar diversos resultados diferentes, dependiendo del *<mark style="color:blue;">usuario</mark>* que esté accediendo a Weknow, o incluso, si se trata de un componente accedido por diversas *áreas de conocimiento distintas*, pero dependiendo del área de conocimiento en la que se encuentre, debe tener parámetros diferenciados en sus filtros. En ambos casos, las variables de contexto hacen que los posibles filtros estén “predefinidos” en estas variables de contexto.

Además, también es posible registrar una variable de contexto *GLOBAL*, utilizada independientemente del usuario conectado o del área de conocimiento accedida.

Para incluir variables de contexto personalizadas al nivel de usuario o de registro de menú, estos respectivos registros tienen un *Botón >> VARIABLES*:

Ingrese el nombre identificador de esta variable, que será la referencia para los filtros y fórmulas en uso en la herramienta, y al lado, informe el valor respectivo que esta variable debe asumir.

Es posible que una variable tenga más de un valor, pero para ello es necesario informar el separador.

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

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

*<mark style="color:blue;">Utilice los botones para ayudar en esta configuración:</mark>*

“***+***” – Inserta una nueva variable de contexto

“***-***” – Elimina una variable de contexto individualmente

“***x***” – Elimina todas las variables de contexto relacionadas con el respectivo registro

Después de configurar usuarios o registros de menús con sus respectivas variables de contexto, vaya al *componente* que será afectado por esta variable y, mediante el campo *FÓRMULA*, indique que busque esta variable como filtro, a través de la función *GetVar*.

### Ejemplo de aplicación práctica con variables de contexto por *<mark style="color:blue;">USUARIO</mark>*:

*Utilice en casos donde un determinado usuario debe ver solo consultas a indicadores referentes a su contexto, como datos relacionados a: su código de matrícula; datos de su sector; datos de la región bajo su responsabilidad de control, entre otros...*

### Ejemplo de aplicación práctica con variables de contexto por *<mark style="color:blue;">REGISTRO DE MENÚ</mark>*:

*Si en un registro de menú hay componentes que son de uso común con otros menús, y cada menú debe ver solo sus datos sin posibilidad de ajustar esto en filtros en pantalla para evitar ver otros sectores, basta con asociar una variable de contexto a cada una de estas áreas de conocimiento.*

*De esta forma, todos estarán viendo el mismo componente, pero solo con información exclusiva a su regla de negocio.*

## Variables de Contexto Globales:

Dentro de Weknow podemos crear una variable de contexto en *Administración* >> *Variables de Contexto* que sea general para todos los usuarios y áreas de conocimiento (Ejemplo: COD EMPRESA), facilitando posibles mantenimientos en los indicadores si esta variable necesita ser modificada para todos los componentes.

### Ejemplo de aplicación práctica con variable de contexto *<mark style="color:blue;">GLOBAL</mark>*:

*En el siguiente ejemplo, tenemos una variable identificada como “varcontexto\_empresa” con valor 1:*

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

Para su *<mark style="color:blue;">uso en un filtro</mark> de búsqueda por empresa*, informamos esta variable *<mark style="color:blue;">como valor inicial</mark>* en el campo *<mark style="color:blue;">FÓRMULA</mark>* a través de la función *GetVar (“varcontexto\_empresa”)*:

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

Si todos los filtros de empresa tienen relación con esta variable de contexto, cuando sea necesario, bastará con modificar el registro general de la variable de contexto, y esta será automáticamente actualizada en todos los indicadores o filtros que la utilicen.

## Variables de contexto internas de Weknow:

**sys:userid**: Variable numérica que contiene el ID del usuario conectado;

**sys:userdisplayname**: Variable textual que contiene el nombre de visualización del usuario conectado;

**sys:dashboardid**: Variable numérica que contiene el ID del dashboard del contexto (si lo hay);

**sys:menuid**: Variable numérica que contiene el ID del menú donde el dashboard está vinculado (si lo hay);

**sys:ipaddress**: Variable textual que contiene la dirección IP de la máquina;

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