Introdução

O projeto TOTVS Smart Analytics é um projeto padrão que oferece uma solução de inteligência de negócios que abrange uma gama de possibilidades e visões que apoiam a tomada de decisão dos usuários finais. Mas ao adquirir o produto, o cliente pode sentir a necessidade de realizar customizações, como por exemplo, criar novos relatórios ou incluir novos campos.

Este artigo trata sobre as possíveis customizações que podem ser implementadas no projeto TOTVS Smart Analytics. Existem 2 casos diferentes de customização. Em uma delas, o usuário deseja customizar o projeto padrão, de forma a incluir novos campos e/ou novas tabelas, para então criar novas métricas e novos relatórios, e dashboards, com estes itens criados no projeto. Em outra situação, o usuário pretende criar relatórios ou dashboards novos, baseados no projeto padrão. Este último caso, não requer alterações no projeto padrão, ou seja, se este for o caso, não é necessário customizar o projeto, mas sim, apenas criar os relatórios/dashboards diretamente no front-end.

Customização de Relatórios e Dashboards

No Smart Analytics pode-se customizar métricas, relatórios e dashboards, independente se o usuário customizou novos campos ou Datasets, anteriormente. No front-end, podemos ter os seguintes casos de customização: 

• Criação de novas métricas: Para criar uma métrica a partir de uma Fato criada na modelagem, seguindo os passos anteriores, disponível nesta publicação Como utilizo a opção Salvar Como para um relatório padrão do TOTVS Smart Analytics? Além disso, é possível criar novas métricas calculadas, ou seja, a partir de cálculos entre outras métricas já existentes, a partir da opção Create Metric.

• Criação de novos relatórios: Se deseja alterar um relatório existente, primeiramente salve uma cópia conforme disponível neste link Como criar métricas no TOTVS Smart Analytics. Também, é possível criar um relatório do zero, a partir da opção Create Report.

• Criação de novos dashboards: Para alterar um dashboard existente, primeiro salve uma cópia deste, como mostrado nesta FAQ: Como copio uma aba de dashboard padrão do TOTVS Smart Analytics para outro dashboard criado pelo usuário?. Ou, pode-se criar um dashboard do zero, a partir da opção Add Dashboard: Como crio um Dashboard? .

Customização do Projeto - Modelagem e ETL

Nesta situação serão Serão analisados 3 cenários possíveis de customização no Smart Analytics, são eles: Cenário 1) . Estudaremos, a seguir, cada um destes cenários.

Cenário 1                   

...

...

...

...

...

...

...

...

...

O cliente necessita de campos extras em um Dataset, seja este fato ou dimensão, no projeto padrão do Smart Analytics é possível configurar oscampos livres. Estão disponíveis 10 campos livres para cada Dataset, sendo que nas tabelas fatos, são 5 campos livres que representam métricas, 3 campos livres que representam data e 2, que representam atributos. Para as dimensões, os 10 campos livres são do tipo atributo. Estes campos livres tem como objetivo disponibilizar a inclusão de campos extras na extração de dados, possibilitando ao cliente incluir novos campos, seja ele um indicador ou um atributo, que não são atendidos pelo projeto padrão. Assim, geram-se novos indicadores que agregam novas informações e que poderão auxiliar na tomada de decisão dos clientes que utilizam o produto TOTVS Smart Analytics.

Ao utilizar os campos livres, o usuário não precisará implementar nenhuma customização no projeto TOTVS Smart Analytics. Observe, então, a facilidade que os campos livres oferecem aos usuários. Portanto, sempre que possível solucionar os problemas que necessitam de customizações utilizando os campos livres ao invés, ganha-se mais praticidade e agilidade na manutenção e atualização do produto padrão TOTVS Smart Analytics.

...

• a) O cliente deseja criar Datasets do tipo fato, e o relaciona com uma ou mais dimensões existentes no projeto padrão.
• b) O cliente deseja criar Datasets do tipo dimensão, e o relaciona com uma ou mais fatos já existentes no projeto padrão.
• c) O cliente deseja criar alguns Datasets no projeto, sendo fatos e/ou dimensões. 
  

...

•  E dessa forma, os relacionamentos criados são apenas entre Fato(s) e Dimensão(ões) criados pelo cliente, sem interferir com os Datasets do projeto padrão.

A seguir, temos os passos necessários para realizar uma customização no projeto do Smart Analytics, abordando tanto modelagem e ETL, quanto relatórios e dashboards. Se o objetivo for customizar modelagem e/ou ETL, recomenda-se fortemente, que antes de seguir os próximos passos, o cliente crie uma cópia local do projeto, para que as alterações sejam realizadas no projeto próprio, pois poderão ocorrer atualizações, no projeto padrão, que substituiriam as customizações realizadas.

...

Nos arquivos .grf (na pasta graph) será necessário: cenario 2 e 3 precisam ser em novo projeto. NÃO utilizar o projeto padrão.

Cenário 1) Nada será alterado.

...

Cenário 3.c) Criar um novo graph por dataset criado.

ATENÇÃO: Recomenda-se que antes de alterar um graph existente, salve uma cópia do projeto em seu projeto local, e realize as mudanças em seu projeto local. A  A partir do momento que o cliente criar um novo graph, altere um metadado ou altere um graph, este graph passa a ser de total responsabilidade do cliente, no que se refere à manutenção e às atualizações do projeto.

Agent 

No arquivo my.properties será necessário:

...

Cenário 3.b) Incluir a busca do Dataset criado. Além disso, será necessário incluir o novo campo, na busca já existente, referente à fato dimensão relacionada.

Cenário 3.c) Incluir as buscas de todos os Datasets criados.

...

ATENÇÃO: Ao selecionar os campos na busca que será criada ou alterada, a ordem destes, devem ser a mesma ordem dos campos no metadado criado ou alterado no passo anterior.

Smart Analytics

No Smart Analytics pode-se customizar métricas, relatórios e dashboards, independente se o usuário customizou novos campos ou Datasets, anteriormente. No front-end, podemos ter os seguintes casos de customização:

• Criação de novas métricas: Para criar uma métrica a partir de uma Fato criada na modelagem, seguindo os passos anteriores, disponível nesta publicação Como utilizo a opção Salvar Como para um relatório padrão do TOTVS Smart Analytics? Além disso, é possível criar novas métricas calculadas, ou seja, a partir de cálculos entre outras métricas já existentes, a partir da opção Create Metric.

• Criação de novos relatórios: Se deseja alterar um relatório existente, primeiramente salve uma cópia conforme disponível neste link Como criar métricas no TOTVS Smart Analytics. Também, é possível criar um relatório do zero, a partir da opção Create Report.

...

.