quarta-feira, 23 de novembro de 2022

CRM-GT - Painel de Gráficos

Painel de gráficos é um recurso importante do produto CRM-GT, onde podemos criar dashboards analíticos interessantes, dos seguintes tipos:
  • Área Polar
  • Barra Empilhada
  • Barra Horizontal
  • Barra Vertical
  • Círculo
  • Círculo (metade)
  • Contador
  • Filtro
  • Funil
  • Gauge
  • Linha
  • Mapa
  • Pizza
  • Tabela
Neste artigo vamos ver como estes gráficos são construídos na plataforma.
A área de [Configuração do Painel] é onde criamos os registros que representam os gráficos. Cada registro representa um gráfico.

Cadastramos um novo gráfico da seguinte maneira:
  • Para o campo [Grupo] informamos um valor que vai representar um Label para uma [aba] que será criada para o gráfico. Então, se colocarmos, por exemplo "Vendas", teremos
  • O campo [nome] será o [título] do gráfico
  • Escolha o tipo de gráfico no lookup de tipos (12 possíveis)
  • Informe uma largura (em px)
  • Informe uma altura (em px)
  • O campo [ordem] (read only aqui) mostra em qual posição ficará o gráfico em relação a outros do [mesmo grupo]. Você pode reordenar os gráficos clicando no botão [Reordenações]
  • No campo [Query Exec] é onde informamos a Fonte de Dados para o gráfico. Clique no link [Abrir Query Exec] para Criar/Editar sua query. Para a maioria dos gráficos você precisa informar os valores para o eixo X e Y do gráfico. No exemplo baixo, para um gráfico de barras, mostraremos um total (SUM de totalamount) agrupados pelo [nome do Pipeline]
  • Note que na query existem algumas macros iniciadas com a palavra [@ChartFilter_]. Este é um recurso para que possamos filtrar os dados por qualquer campo que desejarmos, obtidos a partir da tela, na área de [Filtro]. Para adicionar filtros no gráfico, criamos um [novo] registro de gráfico, escolhemos o tipo [Filtro] e informamos no campo [Grupo] o "mesmo valor" cadastrado para os outros registros de gráficos na qual desejamos aplicar os filtros. Pegando o mesmo exemplo já citado, para o gráfico de barras, que vai estar na ABA (ou Grupo) chamado "Vendas" vamos adicionar os seguintes filtros
    • Data de / Até
    • Contas

Note a relação então de registros para o [mesmo grupo].
No exemplo abaixo teremos [1] filtro que será usado para os gráficos pertencentes ao GRUPO "Vendas"

E para finalizar a configuração dos filtros, as [macros] devem estar presentes em [todas] as Query Execs para os registros exemplificados acima.
No momento da criação/alteração da Query Exec existe uma documentação completa no uso de todas as [macros], na aba [Dicas de Uso]

Então, lá vamos encontrar todas as formas possíveis de uso das macros [@ChartFilter_]

Gráfico - Tipo Tabela

Será visulizado um GRID com as colunas que você especificar no SELECT criado na Query Exec associada.
Você pode configurar a tabela para aceitar um [duplo clique] na linha para abrir o detalhe do registro correspondente na lista.
Então para que isto aconteça basta abrir a Query Exec associada e adicionar o ID (com o label hidden_id) da tabela em questão e o [Nome da Tabela] também (com o label hidden_table).
Exemplo, vamos mostrar num Grid os registros da tabela de Oportunidade. Portanto, ficará da seguinte forma
Gráfico - Tipo Contador

No gráfico do tipo Contador, será mostrado um balão, e centralizado nele o valor que você [agregou] na Query Exec associada.
Na Query Exec você deverá especificar 3 campos
  • Agragador com o alias [count]
  • Um descritivo qualquer chamado [label]
  • Um valor RGB com o alias [rgbcolor]
Gráfico - Tipo Mapa

Para o gráfico do tipo mapa, informe na Query Exec associada os campos
  • Um descritivo qualquer com o alias [title]
  • O mesmo descritivo acima com o alias [infoTitle]
  • Um descritivo detalhado com o alias [infoDetail]
  • Uma latitude com o alias [latitude]
  • Uma longitude com o alias [longitude]
Recurso de Drill-Down

Este importante recurso permite ver mais detalhes de uma parte específica do seu gráfico. Exemplo, em um gráfico de barras, se você clicar em uma barra específica, o sistema abre um popup com os registros referentes aquela barra.
Este recurso já está habilitado por padrão nos gráficos de
  • Área Polar
  • Barra Empilhada
  • Barra Horizontal
  • Barra Vertical
  • Funil
  • Linha
  • Pizza

Por padrão, o popup somente mostra o campo [name] na lista de registros. Mas você pode configurar a Query Exec para ter os campos adicionais que desejar.
Para isto adicione, entre aspas, os campos desejados (separe os campos usando o caracter pipe [|] ), e nomeie este valor com o alias [drilldownfields]

Neste exemplo eu adicionei o campo [name] da opportunity e o [name] da tabela Status. Lembre-se de adicionar um LEFT JOIN se as tabelas relacionadas (Status no caso) não estiverem na Query.

Clicando na barra [Em Desenvolvimento]

E o detalhe