> 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.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards.md).

# Creación y Edición de Dashboards

*<mark style="color:blue;">Dashboards</mark>* son las representaciones en conjuntos de elementos, compuestos por objetos (componentes) de: imágenes, textos e indicadores individuales diversos (y estos entonces asociados a mapeamientos de datos - Metadatos).

En este contexto, podemos volver a destacar que *Carpetas* son entonces estructuras en árbol de forma a organizar secuencias de Dashboards y, si necesarios, Sub-dashboards.

Para crear un <mark style="color:blue;">DASHBOARD</mark> es necesario <mark style="color:blue;">seleccionar una</mark> *<mark style="color:blue;">Carpeta</mark>* y clicar sobre el menú *<mark style="color:blue;">MENÚ</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>*:

![](/files/j2OoXlywUDPQPeImDTkR)

Es posible crear Sub-dashboards, creando un nuevo dashboard a partir de un clic sobre otro ya existente, y nuevamente yendo en la opción *<mark style="color:blue;">MENÚ</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>*.

Al clicar en la Opción <mark style="color:blue;">ADICIONAR</mark>, las siguientes posibilidades son disponibilizadas

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

### **Nuevo Dashboard**

Crea un nuevo panel de indicadores desde su fase inicial, sin componentes en pantalla para que sean construidos en su continuidad. Al clicar en “Nuevo Dashboard”, en la ventana que será abierta basta insertar: una descripción para identificación del nuevo Dashboard, su documentación relacionada (si necesario) y la posición que se encontrarán sus pestañas, si así hubiera necesidad. Por fin, clicar en <mark style="color:blue;">SALVAR</mark>.

***Importante:***

Al crear un Dashboard, o editar uno ya existente, en su pantalla de registro en paralelo a registros básicos, también será presentada opción de REPRESENTACIÓN POR IMÁGENES O MINIATURAS.

Con esta opción será posible representar dashboards y carpetas con imágenes o miniaturas para el usuario final/consumidor de informaciones, en su navegación en Weknow vía versión navegador web .

Para representar un dashboard: En el menú de opciones clique en *<mark style="color:blue;">MENÚ</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Editar</mark>*. En la secuencia, seleccione el modo de la imagen (Miniatura o Imagen) y clique en Cargar del Disco.

* Miniatura: Representará el dashboard con miniaturas generadas automáticamente con base en el tipo del dashboard.
* Imagen: Podrá seleccionar una imagen de su computador que representará el dashboard.

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

<mark style="color:blue;">**Modo fijo (imagen)**</mark>:

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

<mark style="color:blue;">**Modo miniatura**</mark>:

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

<mark style="color:blue;">**Ejemplos en la versión web con el modo imagen**</mark>:

![](/files/gYUv4afJn5cyOxCU0Btx)

<mark style="color:blue;">**Ejemplos en la versión web con el modo miniatura**</mark>:

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

{% hint style="danger" %} <mark style="color:red;">**IMPORTANTE:**</mark> Para generar las miniaturas es necesario activar la opción “Actualización de las Miniaturas de Dashboard” en el Administrador de Tareas del Weknow.
{% endhint %}

<mark style="color:blue;">**Para representar una carpeta**</mark>**:**

Así como la edición en el registro básico de un Dashboard, la edición de Carpetas que agregan conjuntos de Dashboards también pueden tener representaciones de imágenes en miniatura, que serán exhibidas vía navegación del Weknow en versión navegador web.

Para esto, en el menú de opciones clique en *<mark style="color:blue;">MENÚ</mark>* >> *<mark style="color:blue;">Editar</mark>* >> *<mark style="color:blue;">Editar</mark>*. En la secuencia, seleccione la imagen y clique en Cargar del Disco:

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

Al clicar en cargador del disco será posible seleccionar cualquier imagen de la máquina.

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

### Dashboard ya existente

En esta acción podemos reaprovechar algún Dashboard ya existente, citando el mismo en una nueva área de conocimiento agrupándolo a más dashboards en otro conjunto de paneles.

***Importante:***

En esta modalidad de utilización de un Dashboard ya existente, al citarlo en otra área de conocimiento, el Dashboard aún es único, o sea: él aún es el mismo Dashboard origen, pero solo citado en otro agrupamiento. Él no se torna un dashboard independiente;

Para un nuevo dashboard solo duplicando elementos de un dashboard ya existente, en el menú de opciones clique en *<mark style="color:blue;">MENÚ</mark>* >> *<mark style="color:blue;">Dashboards</mark>* >> *<mark style="color:blue;">Adicionar</mark>* >> *<mark style="color:blue;">Nuevo Dashboard</mark>*. En la secuencia, con este nuevo dashboard hasta el momento aún completamente en blanco, realice la copia de objetos de otro dashboard vía menú de opciones clicando en *<mark style="color:blue;">DASHBOARD</mark>* >> <mark style="color:blue;">área</mark> *<mark style="color:blue;">Contenido</mark>* >> *<mark style="color:blue;">Copiar</mark>* y seleccione el Dashboard que será referencia para esta copia de objetos componentes.

Opte por “*<mark style="color:blue;">Duplicar los componentes y Copiar filtros del dashboard de Origen</mark>*”, caso deseje que los componentes de origen sean completamente independientes de estos objetos del nuevo dashboard. De esta forma, los objetos de origen se tornan solo referencia para la copia deseada, y no serán alterados caso el objeto en el dashboard destino sea alterado.

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

Un Dashboard puede ser estructurado con uno o más *<mark style="color:blue;">componentes de indicadores individuales</mark>*, también identificados como *<mark style="color:blue;">objetos</mark>*.

Los objetos componentes de indicadores individuales son las representaciones de como las informaciones serán visualizadas en pantalla. *<mark style="color:blue;">En excepción de los objetos imagen y contenedor de filtros</mark>*, todos los otros tipos de objetos poseen aplicabilidad como indicadores de valores, y sus procesos de confección posibilitando asociación a mapeo de datos (<mark style="color:blue;">metadatos</mark>). Con esto, objetos indicadores pueden citar campos que se hagan necesarios, y agregaciones para sumarización de sus valores a partir de sobreposición de filtros aplicados a este metadato relacionado directamente en esta edición del objeto en cuestión.

En el proceso de creación o edición de cada tipo de objeto la etapa final será diferenciada, de forma a ser configurada de acuerdo con su objetivo conceptual y/o estadístico.

#### Tipos de objetos que pueden ser inclusos en la composición de un dashboard:

* [Componente Planilla](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-planilha.md);
* [Componente Gráfico](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-grafico.md);
* [Componente Termômetro](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-termometro.md);
* [Componente de Texto](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-texto.md);
* [Componente Mapa](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-mapa.md);
* [Componente Cartão](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-cartao.md);
* [Componente Imagem](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-imagem.md);
* [Filtros](/wedocs-5.1/wedocs-4.6-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/filtro.md).

Para adicionar un nuevo componente y montar un Dashboard, primero seleccione cuál deberá ser su Dashboard;

A través de la barra de herramientas de *<mark style="color:blue;">Dashboard >> Inserir >> Tipo de componente</mark>* <mark style="color:blue;">individual que desea agregar al Dashboard</mark>:

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

Al clicar en uno de los tipos de componente para su inserción en el Dashboard, en este momento el área del Dashboard tendrá destaque sobre las posiciones donde se podrá alocar este nuevo componente.

Al elegir el área donde será alocado el indicador en pantalla, clique sobre el local deseado, y prosiga las etapas de creación.

A continuación serán descritos los pasos generales de como crear basicamente cualquier tipo de componente:

Seleccionar la forma que desea crear el componente. *Todos los componentes*, poseen las tres opciones conforme imagen a seguir:

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

* <mark style="color:blue;">**Crear nuevo componente**</mark>, desde su fase inicial;
* <mark style="color:blue;">**o**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Duplicando de un componente ya existente**</mark>* (creando un nuevo componente, independiente, pero con configuración inicial idéntica a alguna referencia);
* <mark style="color:blue;">**o,**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Utilizando un componente ya existente**</mark>*. En esta opción deberá ser dado atención al factor de que si alterado el componente en algún Dashboard, todas sus menciones en otros dashboards distribuidos por la herramienta tendrán esta misma alteración, pues en la práctica se trata de un componente único.

Al crear un nuevo componente tipo planilla, la próxima fase es identificar el metadato que será utilizado. Seleccione el metadato y clique en <mark style="color:blue;">**AVANZAR**</mark>;

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

Para alterar las opciones de conexión para componentes que no sean planilla, entre en el siguiente camino: *<mark style="color:blue;">Asistente >> Menú lateral >> Datos</mark>* ;

En su última fase de edición, cada tipo de componente posee sus peculiaridades, de acuerdo con sus objetivos y características.

A partir de la versión 3.0 todos los objetos componentes, que tengan posibilidad de asociación a metadatos, poseen una pantalla de configuración con opciones en pantalla única, cuyas peculiaridades pueden ser trabajadas entre las opciones de menú a la izquierda de la pantalla:\\

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

Dentro del componente aún, es posible *<mark style="color:blue;">crear nuevos filtros que actuarán limitando aún más filas de lo que fue retornado por el metadato</mark>*. Para esto, a la izquierda, clique en *<mark style="color:blue;">**Configuración**</mark>*<mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**y arrastre campos que serán filtros para las áreas**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Filtros por registro**</mark>*<mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**y/o**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**Filtros agrupados**</mark>*, donde respectivamente hay: necesidad de filtros campos sin agregación, oi. Llevando en consideración valores obtenidos después aplicar fórmulas de agregación (obteniendo comportamiento similar a la cláusula Having SQL):

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

Si necesario, adicione los campos y criterios para creación de filtros de los datos que serán traídos por el metadato mencionado en la opción Datos, conforme elegido en la fase inicial de la creación del objeto.

Así como en el registro de *Metadatos*, todos los componentes individuales (excepto del tipo imagen) también poseen funcionalidad para creación de *campos calculados* en tiempo de edición. Estos campos pueden relacionarse en cualquier área de la edición final del componente, utilizando la sintaxis de la base de datos relacionada a la conexión ya definida.

De la misma forma, en la edición de todos los indicadores, es posible accionar opción que reciba valores externos que formen parte de campos calculados tenemos la opción de adición de *campos de entrada*:

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

Por fin, caso necesario desconsiderar las acciones hechas desde última apertura de esta pantalla de edición, clique en **CANCELAR**.

Para finalizar la inserción de ediciones del objeto en cuestión, clique en **CONCLUIR**.

En el área <mark style="color:blue;">**DATOS**</mark>, están dispuestas configuraciones relacionadas al metadato elegido como referencia de consulta de datos de este objeto en cuestión. Algunos destaques de esta área:

### **Forzar datos online:**

Caso el metadato del componente sea sob modo de bas, aparecerá la opción “*<mark style="color:blue;">Forzar datos online</mark>*”. Esta opción posibilita excepciones, definiendo la consulta del componente en específico como “online”, incluso que su respectivo metadato sea sob Almacenamiento en “modo offline” por defecto. Como beneficio, esta opción visa auxiliar desarrolladores de contenido Weknow evitando la duplicidad de mantenimiento de códigos para que no tenga códigos idénticos donde única diferenciación sería el modo de consulta/almacenamiento:

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

### Cache de datos:

Cuando acionada esta opción en paralelo el campo tiempo expiración (minutos) es habilitado, y entonces el objeto graba temporalmente datos brutos en cache de memoria a cada X minutos (indicado en Expiración (minutos). Esta condición hace que el objeto no consulte la base de datos citada en la conexión principal del metadato o objeto de forma exclusivamente online (en requisiciones SIEMPRE directamente en las conexiones citadas) pues consulta este online y carga datos en el tiempo que pensar ser necesario, o en actualizaciones de sus filtros para cargamento de nuevo conjunto de datos en cache. Configuración NO OBLIGATORIA. Utilícela conforme necesidad.\\

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

### **Detallamiento**

Local para indicación si el objeto tendrá opción de detallamiento simple (línea a línea) y cuáles los campos que serán exhibidos al usuario final (consumidor de informaciones) así que este solicite detallamiento en modo de visualización vía navegador;

### **Explorador de Datos**

Local para configuración de activación/inactivación del modo de “Exploración de datos” en el indicador en cuestión a sus usuarios finales, cuando estos utilicen este indicador en modo browser. Diferente de la opción detallamiento, el explorador permite creación de visiones por el usuario final, y cruzamientos de campos creando visiones de forma multidimensional (cubos de datos) y alternando entre modo planilla y gráfico.

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

### **Apariencia**

Local para configuración de formateo de textos/bordes y otras peculiaridades de Contenedor (límites de la caja del indicador), Título y Contenido del indicador.

### **Vínculos Automáticos**

Local para configuración de los campos que serán utilizados en los vínculos o serán cargados al acceder el componente.

### **Documentación**

Local para inclusión de textos que sirvan de documentaciones e informaciones que la institución piense ser importante al conocimiento de quien analiza el indicador en cuestión. Acepta tags HTML para formateo de texto de la documentación, y con aplicación de formateo en modo navegador al usuario final. Es posible visualizar en la versión Weknow web.

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

#### Al clicar en adicionar será abierto 3 opciones:

* Nuevo archivo: Agregar un nuevo archivo/anexo;
* Nueva URL: Agregar un documento vía URL;
* Anexo existente: Archivos que ya fueron utilizados en otro dashboard.

En resultado vía versión Browser, vea el tipo de anexo en “Tipo”:

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

A continuación, vea como agregar documento/anexo a un componente:

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

Para visualizar en la versión web, clique en los tres puntitos:

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

Y haga clic en adjuntos:

![](/files/EFQCBhi05rvzL4oJpgGF)

Con esto, se abrirá el menú con los adjuntos/documentos adjuntados:

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

### Previsualizar y Plan de Ejecución

Estas opciones generales están presentes en todos los componentes (con excepción de la *Imagen*) y son las opciones más simples dentro de todas las mencionadas anteriormente. La primera tiene como objetivo mejorar el rendimiento y la segunda se utiliza para depuración en caso de fallos en la carga de los datos.

#### Vea más detalles de cada una de las opciones:

La *<mark style="color:blue;">Previsualización</mark>* de los componentes es la opción responsable de recargar el indicador cada vez que se realiza algún cambio en su configuración.

Por defecto, los indicadores vienen con la opción *<mark style="color:blue;">Actualizar la previsualización automáticamente</mark>* seleccionada, lo que significa que después de realizar un cambio, el sistema actualizará automáticamente el indicador. De lo contrario, con cada nuevo cambio será necesario hacer clic en *<mark style="color:blue;">Previsualizar</mark>* para que el indicador se actualice.

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

*<mark style="color:blue;">**¡Atención!**</mark>* Para ciertos indicadores se sugiere que la opción automática sea deshabilitada, ya que si el SQL utilizado en el *<mark style="color:blue;">Metadato</mark>* es muy pesado, puede comprometer el rendimiento del sistema al recargar el indicador.

La opción *<mark style="color:blue;">Plan de ejecución</mark>* es básicamente una lista de funciones que se ejecutan, incluyendo la ejecución del código *SQL*, para llegar al resultado del indicador configurado. Se tienen en cuenta los datos y también cualquier función habilitada, como filtros y otros. A continuación, un ejemplo:

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

Como se mencionó anteriormente, el objetivo de esta pantalla es ayudar en la depuración de posibles errores por parte del equipo especializado de corrección de Weknow. Por lo tanto, desde el punto de vista del usuario final, no tiene valor funcional. Su código podría ser solicitado en atenciones del Soporte.
