> 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.0-es_es/cliente-desktop/recursos-extras-de-dashboards/formatacao.md).
# Formateo
## Componentes - Opciones Generales adicionales
Weknow posee diversas opciones que se repiten en sus componentes durante la creación y la edición. Este comportamiento genérico de la herramienta permite una mejor asimilación por parte del usuario final y crea una identidad para el sistema, tornando la experiencia de uso más agradable.
A continuación, se listan (en tópicos) las opciones, herramientas y funciones compartidas entre la mayoría o todos los componentes:
## Edición de componentes
Si desea *alterar un componente de un dashboard*, basta con hacer clic en el botón “*...*” también presente al posicionar el mouse en la barra superior del componente, en el canto superior izquierdo, y hacer clic en *Editar*:
## Formato de Valores
Todos los campos en Weknow son automáticamente atribuidos a un formato de acuerdo con su tipo de datos en la base de datos. Sin embargo, esta configuración puede ser alterada a través de la opción *Formato*.
Ella aparece en todos los componentes y sirve para configurar los resultados de los campos seleccionados de acuerdo con sus preferencias. Cada formato de valores posee sus características que pueden ser alteradas, y en la secuencia tenemos una lista de ejemplos de los formatos y sus características disponibles para alteración:
### Texto
* Prefijos, Sufijos y valor en caso de resultados Nulos;
* Tamaño Máximo para el campo, pudiendo cortar o no palabras;
* Remover espacios en Blanco;
* Caixa (*Caps Lock*) para todo el texto, para la primera letra o aún para la primera letra de cada palabra.
### Número
* Prefijos, Sufijos y valor en caso de resultados Nulos;
* Separadores de millar y decimales;
* Nº de casas decimales y forzar para colocar aún no existiendo;
* Tamaño Máximo para el campo;
* Multiplicadores, para esconder los ceros en caso de valores muy altos o muy bajos;
* Señales de modularidad en casos de negativo y/o positivo.
* *Data, Hora, Data/hora, Mês/año e Intervalo de Tiempo*
* Prefijos, Sufijos y valor en caso de resultados Nulos;
* Máscara, para definir separadores para días y meses, por ejemplo.
*\*Máscara: **d** = día, **n** = mes, **y** = año, **h** = hora, **m** = minutos, **s** = segundos.*
### Lista
* Prefijos, Sufijos y valor en caso de resultados Nulos;
* Opciones, son definidos los valores y cómo deben ser exhibidos.
* *Lógico (Boolean)*
* Prefijos, Sufijos y valor en caso de resultados Nulos;
* Exhibiciones para valores verdadero (1) y falso (0).
Además de la lista arriba, weKnow también posibilita la utilización de formatos patrones de fábrica, haciendo clic en “***...***”. Esos formatos actúan como un facilitador y pueden ser alterados después de la selección sin alterar el patrón de la fábrica.
Los formatos pueden ser alterados y aplicados cuantas veces fueran necesarias para cada campo seleccionado en un componente en el área *Datos*.
Si desea retirar el formato de una forma simple y ágil, haga clic en el botón **REMOVER FORMATO**, ya para aplicar el formato, basta con hacer clic en **OK**.
## Filtros, Ordenaciones y Series
Para todos los componentes es necesario seleccionar al menos un campo del metadato para servir como base (denominado *Datos* o *Valores*). En el lenguaje SQL esa operación es equivalente a un *Select*, sin embargo dentro del metadato, que por sí solo ya es una consulta.
Así como en el caso de los Datos, otros campos son habilitados en los componentes para hacer acciones equivalentes al SQL. Esas opciones son los *Filtros*, *Filtros Agrupados*, *Ordenación* e *Series* que respectivamente funcionan como las cláusulas *Where*, *Having*, *Order* *by* y *Group* *by*. O sea, cuando un indicador es creado en weKnow, es como si el sistema estuviera traduciendo los campos y configuraciones en una nueva consulta SQL “por debajo de las cortinas”.
Vea a continuación los objetivos de cada una de esas opciones, en cuáles componentes pueden ser aplicados y ejemplos:
### Filtros
Esa opción se encuentra en todos los componentes y se resume en la utilización de uno o más valores de un campo para seleccionar apenas parte del resultado retornado en una consulta o indicador.
Es una opción muy ventajosa y cada vez más utilizada debido al hecho de que permite la creación de *Metadatos* sin la utilización de filtros. O sea, al utilizar una cláusula *Where* en el *Indicador* y no directamente en el *Metadato*, es posible dejar el metadato más genérico y así permitir su reutilización en diversos indicadores donde apenas el *Where* los diferencia.
Por ejemplo, un metadato cuyo objetivo es traer la lista de Médicos cuyo nombre comienza con la letra “P”. Con esa descripción, se puede realizar la consulta ya aplicando el filtro en el *Metadato* o entonces aplicarlo en el *Indicador*, conforme a continuación:
Note que los metadatos A y B son exactamente iguales hasta la cláusula *Where*, sin embargo B es más genérico pues está retornando todos los Nombres e Ids de todos los Médicos, sin excepciones. En la secuencia, ejemplos de planillas utilizando los metadatos A y B respectivamente:
En este ejemplo, B está trayendo más valores, como comentado anteriormente eso se da pues aún no fue aplicado el filtro en este indicador. Para aplicarlo basta arrastrar el campo deseado para el área *Filtro* y automáticamente Weknow abrirá la tela de edición del filtro:
A partir de este punto se puede hacer uso de todas las configuraciones de la opción *Filtro*, que son las mismas para todos los componentes.
Primero es necesario seleccionar el *Operador*, que es la forma en que el sistema irá a comparar el valor del campo a un valor informado por el usuario. Hay diversas opciones de comparación, sin embargo para el ejemplo arriba usaremos la opción “Comienza con”.
Después de eso, es necesario seleccionar el *Modo*, que define la forma en que el valor de comparación será informado. Es posible informar el valor de cuatro formas:
* *Nulo*, cuando el valor de comparación debe ser en blanco;
* *Fijo*, cuando el valor es una constante;
* *Fórmula*, para buscar un valor de acuerdo con una regla del Asistente de fórmula Weknow;
* *SQL* cuando el valor a ser utilizado es dinámico y viniendo de una otra consulta.
Para este ejemplo utilizaremos el modo *Fijo*, y colocaremos el valor “P”. Obteniendo así los mismos resultados de la planilla creada con el metadato con la cláusula Where.
Este ejemplo muestra una configuración de filtro dentro de un indicador, sin embargo Weknow aún cuenta con un componente específico para filtros de componentes denominado *Contenedor* *de filtros*. Para más detalles vaya hasta este tópico en este mismo documento.
### Filtros Agrupados
Así como en los filtros, los filtros agrupados tienen el objetivo de seleccionar parte de los resultados de una pesquisa. Su diferencia del *Filtro* está en el hecho de ser aplicado a las *Funciones de Agregación*, no a los valores directamente.
En el lenguaje SQL, su equivalente es la cláusula *Having* y en el sistema está disponible para todos los componentes así como los *Filtros*. Recordando que, eso ocurre pues todos ellos poseen funciones de agregación, permitiendo esa utilización del filtro agrupado. A continuación está un ejemplo en el componente *Tarjeta*:
En el ejemplo arriba tenemos un conjunto de tarjetas de valores y metas por convenios. Para llegar a ese ejemplo, están siendo utilizados los campos “*Valor* *Total*” y “*meta*” como *Valores* y el campo “*company\_name*” como *Series*.
Note, que ese campo en la imagen arriba está siendo sumado con una función de agregación, luego los resultados en tela son las *Sumas* de todas las cuentas de aquel Convenio en ese período.
Piense en un escenario donde queremos traer apenas los convenios que el “*Valor* *Total*” es mayor que R$ 1.000.000. En ese caso basta arrastrar el campo, “*Valor* *Total*” para el área *Filtros* (*agrupados*), seleccionar la función de agregación *Sumar*, seleccionar ambos el Operador y el Modo (conforme demostrado en el tópico de Filtros) y adicionar el valor deseado:
Hecho eso, el sistema filtrará no los valores directamente (línea a línea) sino apenas la *Suma* o el Total para cada uno de los convenios trayendo apenas los convenios con más de R$ 1.000.000, conforme imagen a continuación.
Los *Filtros* *agrupados* son una herramienta igualmente poderosa para la mejor utilización de los metadatos y cuando combinados con múltiples *Filtros* pueden crear diversas visiones diferentes sin la necesidad de un nuevo código SQL.
Para obtener más práctica en esa opción sugerimos testear más ejemplos del filtro con otros tipos de *Funciones de agregación* y antes de desarrollar un nuevo metadato estudiar la posibilidad de reutilización del metadato en conjunto con nuevos filtros.
### Ordenación
Otra opción que es muy utilizada y está presente en tres de los componentes (*Planilla*, *Gráfico* y *Tarjeta*). La ordenación es el equivalente a la cláusula *Order by* en el SQL y tiene como objetivo crear una regla para orden de demostración de los datos.
De las opciones generales es la más simple por no necesitar de ninguna configuración extra y depender apenas del campo que fuera seleccionado para servir de regla de ordenación.
Para demostrar esa opción en la práctica seguiremos el mismo ejemplo de la opción anterior (*Filtros* *Agrupados*) e iremos a organizar el componente Tarjeta de acuerdo con dos necesidades diferentes.
Primero vamos a adicionar una ordenación en la *Tarjeta* utilizando un campo del tipo *Texto*, de esa forma al hacer clic para seleccionar el sentido ordenación será utilizado el modelo *Alfabético* “de A a Z” o “de Z a A”.
#### **Antes**
#### Después
Note que el sistema ya estaba ordenando alfabéticamente de acuerdo con el campo en *Serie*. O sea, si el componente posee más que los campos en *Valores*, como *Rótulos* o *Series*, el sistema automáticamente ordenará por esas opciones. Caso contrario él no aplicará una ordenación.
Después de adicionar el campo “*company\_uf*” en la *Ordenación*, él dejó de ordenar por el nombre de los convenios (campo “*company\_name*”) y ordenó alfabéticamente por los Estados de los Convenios. En este ejemplo es posible alterar el sentido de la ordenación haciendo clic en el ícono de *Flecha* al lado del ícono de funciones agregadas.
Y en seguida vamos a adicionar una segunda ordenación que funcionará en conjunto con la ordenación alfabética anterior. El escenario propuesto es que algunos convenios son del mismo Estado lo que permite organizar nuevamente el listado de las tarjetas, sin embargo ahora utilizando de la opción *Función de agregación*.
### Final
Como resultado obtuvimos las tarjetas ordenadas alfabéticamente por Estado e inmediatamente después por la *Suma* del “*Valor Total*” de cada convenio.
Vale la pena resaltar que este ejemplo trae solo dos formas de hacer la ordenación, sin embargo, esta opción se puede combinar con varias otras configuraciones para traer incluso un TOP 10 de Convenios más valiosos, por ejemplo (si se usa un limitador), dependiendo solo de la necesidad del indicador.
### Series
La opción series es el equivalente a la cláusula *Group by* en SQL, responsable de unir varios valores a través de un campo con un valor común entre registros.
Está muy asociada a tablas que poseen una clave externa de tablas como “Categoría” o “Tipo”, ya que estos campos se repiten muchas veces en estos escenarios y pueden servir como buenos campos para agrupar. Sin embargo, su uso no se restringe a este escenario, permitiendo que, en la práctica, cualquier campo pueda ser utilizado como un campo de *Series*.
En el sistema, esta opción se encuentra en los componentes del tipo *Gráfico*, *Tarjeta* y *Planilla* (a través de las líneas/columnas que actúan como *Series*). A continuación, un ejemplo de la serie que se utiliza para transformar un gráfico más genérico en un gráfico separado por sexos sin alterar los Metadatos:
Observe que el sistema incluye automáticamente una segunda columna en el gráfico para cada uno de los *Rótulos* sin tener la necesidad de agregar un campo más en *Valores*.
***¡Atención!*** La configuración realizada en este ejemplo no interfiere con los colores del gráfico, para cambiarlos se utilizó *Personalizaciones*.
Aún es posible incluir más de un campo en el área de series, trayendo más agrupaciones de acuerdo con la necesidad. El sistema separará de acuerdo con la cantidad de valores para cada una de las series. La serie con menos valores se convierte en el primer nivel de agrupación, la segunda con menos valores se convierte en el segundo nivel y así sucesivamente.
## Variables de entrada
En el día a día de trabajo del Analista, es posible encontrarse con situaciones que exigen la entrada de algún dato para que sea posible generar determinada información. Sin que se cambien las configuraciones del componente y que dispense la necesidad de un perfil con permisos de Edición.
Este dato que se informará, podrá asumir N responsabilidades de acuerdo con lo que se definió en la configuración del componente, por ejemplo:
* Meta;
* Parámetro;
* Clasificación;
En la práctica, es una forma del usuario visualizador interactuar con los gráficos disponibles por weKnow, y agregar más valor a la información generada.
Ejemplo:
Para agregar una Variable de entrada, primero abrimos la edición del componente, y en la pantalla que se abrió, en el listado de campos, hago clic en **Agregar campo de entrada**, donde se definirán:
* Nombre
* Título
* Categoría
* Tipo de dato (si es texto, decimal, fecha, etc.)
* Valor (valor predeterminado)
En este ejemplo definiremos una **Meta** por **Período** para las ventas facturadas en cada estado, es decir, una línea que cortará el gráfico de barras, identificando cuáles de los estados alcanzaron el promedio en determinado período.
Para esto, agrego el campo Variable de entrada al Eje Y, y lo defino como una línea (también se pueden definir otros tipos de gráfico). Y luego hago clic en Concluir, para finalizar la configuración de la variable.
Ahora con la Variable de entrada ya definida, vamos a configurar un filtro para que podamos interactuar con la misma. Para eso, en el contenedor de filtros, hacemos clic en el ícono de Filtro, después en los tres puntitos para abrir el Dropdown y luego, hacemos clic en **Agregar Filtro Simple**.
En la ventana que se abrió en la creación de un nuevo filtro en este contenedor, configure el filtro simple normalmente, así como la creación de filtros para la interacción con otros tipos de vínculos. Vale la pena resaltar que el formato del campo filtro debe ser el mismo que el de la variable de entrada.
Para finalizar la creación del campo en este contenedor de filtro, haga clic en Siguiente y luego en concluir.
Ahora la **Variable de entrada** ya está configurada y lista para recibir valores. En este ejemplo que configuramos, definiremos una meta, y validaremos cuáles estados están por debajo/encima de lo que se definió.
La línea gris que corta el Gráfico, representa la **Meta** configurada en la **Variable de entrada**.
Se pueden configurar varios filtros y variables, para generar resultados más complejos.