Tempo aproximado para leitura: 10 min
Dúvida
Como configurar o Gauge Chart na plataforma GoodData?
Ambiente
GoodData – Fast Analytics – Todas as versões utilizadas em sistema operacional Windows.
Solução
1 – Resumo
Este documento tem como objetivo instruir o leitor a configurar o relatório de “Gauge”, desenvolvido em parceria da TOTVS com o GoodData, e descrever suas funcionalidades atuais.
A documentação descrita abaixo abrange:
∙ Requisitos de sistema.
∙ O que é o Gauge chart.
∙ Implantação do Gauge chart.
∙ Parâmetros de customização do Gauge chart.
∙ Exemplos de configuração
2 – Requisitos de sistema
Instalação da extensão do Google “GoodData Extension Tool”, disponível em:
https://chrome.google.com/webstore/detail/gooddata-extension-tool/ifcamcjkflbbalnmnbnlkiehbieknjog
3 – O que é o Gauge Chart
“Gauge Chart”, também conhecido como “Relatório de Velocímetro”, é uma nova forma de visualizar os dados presentes em um ambiente do GoodData através de um relatório. Com o Gauge, o cliente pode comparar o valor de até duas métricas de forma visual, melhorando assim a experiência do usuário com a ferramenta GoodData. A Figura 01 abaixo exemplifica o Gauge chart:
Figura 01 – Exemplo do Gauge Chart.
4 – Implantação do Gauge Chart
O “Gauge Chart” é um relatório desenvolvido externamente à plataforma GoodData, portanto, ele não está disponível na seção “Reports” > “Create Report” padrão do GoodData. Ao invés disso, a sua configuração é feita através do componente “Web Content”, disponível ao entrar no modo de edição do dashboard, conforme mostrado abaixo nas figuras 02 e 03:
Figura 02 – Acessando o modo de edição do dashboard.
Figura 03 – Adicionando um componente “Web Content” no dashboard.
Este componente “Web Content” permite que uma informação disponível na internet (um video, uma imagem, ou até mesmo um chatbot) seja inserido dentro do dashboard do GoodData, para melhorar o design, a análise, ou ambos. Para o caso do Gauge Chart, o que será inserido neste componente é a URL aonde o Gauge Chart está hospedado, assim como as suas configurações (cor, tamanho, métrica a ser visualizada, etc). Segue abaixo um exemplo de URL a ser inserido:
https://gooddata-com-sba-totvs-gauge-chart.s3.amazonaws.com/index.html?host=%HOST_NAME%&project=%CURRENT_PROJECT_HASH%&firstPointer=abR6cxc6b9wq&secondPointer=abR6cxc6b9wq&startValue=0&averageStartValue=5&averageFinalValue=10&finalValue=15&showDivisions= 1&numberOfSlices=50
5 – Parâmetros e configuração
Valores “quebrados” devem ser escritos com ponto (Ex: “Um e meio” = 1.5).
Informações relativas á cor devem ser escritas em valor hexadecimal, de acordo com a escala RGB (Ex: FF0000 = Vermelho).
Os parâmetros em negrito são obrigatórios.
∙ Title – Preencher com o nome do relatório. Este nome será desenhado logo embaixo do valor do relatório.
∙ firstPointer – Preencher com o código de identificação da primeira métrica.
∙ secondPointer – Preencher com o código de identificação da segunda métrica.
∙ startValue – Preencher com o valor inicial da escala do relatório.
∙ averageStartValue – Preencher com o valor inicial da escala média do relatório.
∙ averageFinalValue – Preencher com o valor final da escala média do relatório.
∙ finalValue – Preencher com o valor final da escala do relatório.
∙ showDivisions– Preencher com “0” ou “1”. “0” indica que o valor dos intervalos do relatório não devem ser mostrados.
∙ numberOfSlices – Define o número de divisões que o relatório possui. Este parâmetro é puramente estético. ∙ firstPointerColor – Define a cor do ponteiro da primeira métrica.
∙ secondPointerColor – Define a cor do ponteiro da segunda métrica.
∙ startColor – Define a cor da primeira divisão do relatório.
∙ averageColor – Define a cor da segunda divisão do relatório.
∙ finalColor – Define a cor da terceira divisão do relatório.
∙ dateFilter– Para projetos em que é utilizado o “Filtro de data desconectada” (Timeline), informar neste campo o identificador da data. Caso contrário, ignorar este campo.
∙ relativeDateFilter– Para métricas que utilizam a cláusula FOR PREVIOUS, inserir a mesma granularidade utilizada na métrica. Valores disponíveis para utilização: date, week_us, month, quarter, year.
6 – Exemplos de configuração
Segue abaixo alguns exemplos de configuração do Gauge Chart:
|
Parâmetro |
Valor |
Resultado |
|
Title |
%24%20Revenue%2 0 this%2Flast%20year |
|
|
firstPointer |
abE3fHzddavK |
|
|
secondPointer |
acuqCFZsgfXZ |
|
|
startValue |
0 |
|
|
averageStartValue |
68 |
|
|
averageFinalValu e |
80 |
|
|
finalValue |
100 |
|
|
showDivisions |
1 |
|
|
numberOfSlices |
12 |
|
Parâmetro |
Valor |
Resultado |
|
firstPointer |
acuqCFZsgfXZ |
|
|
secondPointer |
abE3fHzddavK |
|
|
startValue |
0 |
|
|
averageStartValue |
30 |
|
|
averageFinalValue |
50 |
|
|
finalValue |
100 |
|
|
showDivisions |
0 |
|
|
numberOfSlices |
50 |
|
|
startColor |
0000FF |
|
|
averageColor |
AABB22 |
|
|
firstPointerColor |
00FF00 |
7 – Obter o código de identificação da métrica
Para encontrar o “código de identificação da métrica”, é necessário acessar a página da métrica (aonde é definido o MAQL da mesma), e acessar a opçao “Obj”, na extensão do GoodData. Na “página cinza” que for aberta, o código de identificação estará no final da página, no bloco “identifier”. Este procedimento é exemplificado nas Figuras 04 e 05, conforme abaixo:
Figura 04 – Acessando a página de configuração da métrica.
Figura 05 – Código de identificação da métrica.
0 Comentários