Paso a paso: | Introducción El TOTVS Smart Analytics es un proyecto estándar que ofrece una solución de inteligencia de negocios que abarca una gama de posibilidades de visualizaciones que apoyan la toma de decisión de los usuarios finales. Al adquirir el producto, el cliente puede sentir la necesidad de realizar personalizaciones, como por ejemplo, crear nuevos informes o incluir nuevos campos. Este artículo trata sobre las posibles personalizaciones que pueden implementarse en el proyecto TOTVS Smart Analytics. Existen 2 casos diferentes de personalización, en uno de estos, el usuario desea personalizar el proyecto estándar, para incluir nuevos campos y/o nuevas tablas, para crear nuevos informes con estos nuevos datos. En otra situación, el usuario pretende crear informes o dashboards, utilizando lo que ya existe en el proyecto estándar. Este último caso, no requiere de modificaciones en el proyecto estándar, es decir, si este fuera el caso, simplemente será necesario crear los informes/dashboards directamente en el front-end. Personalización de Informes y Dashboards En el Smart Analytics pueden personalizarse métricas, informes y dashboards, independientemente si el usuario personalizó nuevos campos o datasets, anteriormente. En el front-end, podemos tener los siguientes casos de personalización: - Creación de nuevas métricas: Los pasos para crear una métrica están disponibles en esta publicación ¿Cómo utilizo la opción Grabar igual a un informe estándar del TOTVS Smart Analytics? Además, es posible crear nuevas métricas calculadas, es decir, a partir de cálculos entre otras métricas existentes, a partir de la opción Create Metric.
- Creación de nuevos informes: Si desea modificar un informe existente, primero grabe una copia de acuerdo al modelo que se encuentra en Cómo crear métricas en el TOTVS Smart Analytics. También es posible crear un informe de cero, a partir de la opción Create Report.
- Creación de nuevos dashboards: Para modificar un dashboard existente, primero grabe una copia de este, como se muestra en esta FAQ: ¿Cómo copio una solapa de dashboard estándar del TOTVS Smart Analytics a otro dashboard creado por el usuario?. O, puede crearse un dashboard de cero, a partir de la opción Add Dashboard: ¿Cómo creo un Dashboard? .
Personalización de proyecto - Modelado y ETL Si el usuario siente la necesidad de incluir nuevos campos o tablas para agregar más información en su proyecto, será necesario realizar personalizaciones. La personalización, generalmente, interfiere en 3 puntos principales del proyecto: modelado, ETL y el archivo de configuración my.properties del Agent. Todos estos aspectos se abordarán en este artículo. El usuario que realice una personalización debe hacerlo en un proyecto local, nunca modificar el proyecto estándar. Se recomienda crear una copia del proyecto estándar en un proyecto local, donde se implementarán las personalizaciones. A partir del momento que el cliente modifique un graph o metadato perteneciente al proyecto estándar, el proyecto personalizado será de total responsabilidad del usuario, en lo que se refiere a los mantenimientos y actualizaciones del proyecto. |
A continuación, presentaremos los 3 escenarios posibles de personalización en el Smart Analytics que se analizarán uno a uno. Si el cliente necesita de campos extras en un Dataset, ya sea hecho o dimensión, es posible configurar los campos libres en el proyecto estándar del Smart Analytics. Están disponibles 10 campos libres para cada Dataset, en las tablas hechos, son 5 campos libres que representan métricas, 3 campos libres que representan fecha y 2, que representan atributos. Para las dimensiones, los 10 campos libres son del tipo atributo. Estos campos libres tienen como objetivo poner a disposición la inclusión de campos extras en la extracción de datos, permitiendo que el cliente incluya nuevos campos, tanto indicador como atributo, que no se consideran en el proyecto estándar. De esta manera, se generan nuevos indicadores que agregan nueva información y podrá ayudar en la toma de decisión de los clientes que utilizan el TOTVS Smart Analytics. Al utilizar los campos libres, el usuario no necesitará implementar ninguna personalización en el proyecto estándar. Los campos libres, ofrecen facilidad a sus usuarios, solucionando los problemas que necesitan de personalizaciones, permitiendo que se realice de forma practica y ágil el mantenimiento y actualización del TOTVS Smart Analytics. |
Este escenario se abordará cuando los 10 campos libres no sean suficientes, y el cliente necesite de uno o más campos en un Dataset existente en el proyecto estándar, tanto hecho como dimensión. ModeladoCree un nuevo campo en el Dataset deseado, seleccionando si el tipo es hecho o atributo. 
ETLAgregue los nuevos campos en el metadato, referente al graph del Dataset modificado en el modelado. Agent - my.propertiesIncluya el campo en la búsqueda existente, referente al Dataset modificado.
|
El escenario 3 se subdividió en 3 situaciones (A, B, C), para facilitar las explicaciones. Todos estos escenarios presentan una situación donde aquellos que se personalizará concuerda con un asunto totalmente diferente del que ya existe en el proyecto estándar y, por lo tanto, será necesario crear un nuevo Dataset (o más), que puede ser hecho o dimensión.
El primer escenario que se estudiará es la situación A que explica cómo crear Datasets del tipo Hecho, y su vínculo con una o más dimensiones existentes en el proyecto estándar. ModeladoAgregue un nuevo Dataset incluyendo, obligatoriamente, campos del tipo hecho en este, y si fuera necesario, del tipo atributo. A continuación, incluya un vínculo entre las dimensiones deseadas, y esta nueva hecho. ETLCree un nuevo graph para cargar la hecho creada. Si se se creó más de una hecho, cree un graph por hecho. No será necesario modificar el graph de la dimensión vinculada.
Agent - my.propertiesIncluya la búsqueda del Dataset creado.
|
Esta Situación B responde al deseo del cliente en crear Datasets del tipo dimensión, y lo vincula con una o más hechos existentes en el proyecto estándar. ModeladoAgregue un nuevo Dataset, incluyendo únicamente campos del tipo atributo (porque así, el Dataset se definirá como una dimensión). A continuación, agregue un vínculo entre esta nueva dimensión y la hecho deseada. ETLCree un nuevo graph para cargar la dimensión creada. Si se crea más de una dimensión, cree un graph por dimensión. El graph de la hecho que se vinculó a esta dimensión, debe actualizarse para incluir el nuevo campo en el metadato. Además de agregar la referencia en el mapeo del nuevo campo.
Agent - my.propertiesIncluya la búsqueda del Dataset creado. Además, será necesario agregar el nuevo campo, en la búsqueda existente, referente a la dimensión vinculada.
Al seleccionar los campos que se crearán/modificarán en la búsqueda, el orden debe ser el mismo de los campos del metadato creado/modificado en el paso anterior. |
|
Finalmente, la última Situación C considera la necesidad del cliente en crear Datasets, tanto hechos y/o dimensiones, sin vincularlos con los Datasets del proyecto estándar. De esta manera, se establecen vínculos únicamente entre Hechos y Dimensiones creados por el cliente, sin interferir con los Datasets del proyecto estándar. ModeladoAgregue nuevos Datasets, tanto hechos como dimensiones, y a continuación, agregue un vínculo entre las dimensiones y los hechos creados.
Al finalizar cualquiera de estos pasos, debe grabarse y publicarse el nuevo modelado para la nube del GoodData, antes de continuar con los próximos pasos. Para ello, haga clic en Publish Model to Server, ubicado en el Menú Details a la derecha.
En este momento, se muestra la siguiente pantalla informando las modificaciones que se realizarán en el modelado que se encuentra en la nube.
Además, también es posible visualizar y copiar el script MAQL que agregará los campos y/o tablas personalizados. Para visualizar, expanda la flecha de Advanced y haga clic en View MAQL:
|
ETLSolo cree un nuevo graph por Dataset creado.
Agent - my.propertiesIncluya las búsquedas de todos los Datasets creados.
Ao selecionar os campos que serão criados/alterados na busca, a ordem deverá ser a mesma dos campos no metadado criado/alterado no passo anterior. |
|
|
|
|
Finalmente, la última Situación C considera la necesidad del cliente en crear Datasets, tanto hechos y/o dimensiones, sin vincularlos con los Datasets del proyecto estándar. De esta manera, se establecen vínculos únicamente entre Hechos y Dimensiones creados por el cliente, sin interferir con los Datasets del proyecto estándar. ModeladoAgregue nuevos Datasets, tanto hechos como dimensiones, y a continuación, agregue un vínculo entre las dimensiones y los hechos creados.
Al finalizar cualquiera de estos pasos, debe grabarse y publicarse el nuevo modelado para la nube del GoodData, antes de continuar con los próximos pasos. Para ello, haga clic en Publish Model to Server, ubicado en el Menú Details a la derecha.
En este momento, se muestra la siguiente pantalla informando las modificaciones que se realizarán en el modelado que se encuentra en la nube.
Además, también es posible visualizar y copiar el script MAQL que agregará los campos y/o tablas personalizados. Para visualizar, expanda la flecha de Advanced y haga clic en View MAQL:
|
ETLSolo cree un nuevo graph por Dataset creado.
Agent - my.propertiesIncluya las búsquedas de todos los Datasets creados.
Al seleccionar los campos que se crearán/modificarán en la búsqueda, el orden debe ser igual al de los campos del metadato creado/modificado en el paso anterior. |
|
|