Índice


Objetivo

O objetivo deste guia é demonstrar como é realizada a implantação do fluig Analytics, apresentando os passos para habilitar o ambiente e configurar os eventos. 

Quer conhecer ainda mais sobre o fluig Analytics? Assista o treinamento sobre um projeto GoodData disponível no fluig Academy.


Descrição

O fluig possui o Analytics, que permite a criação de Dashboards e Relatórios para acompanhamento de indicadores de informações que acontecem dentro da plataforma. O serviço está disponível apenas na nuvem, o que garante que todo o grande processamento de novas informações e análise dos dados aconteça com grande escalabilidade.


Pré-requisitos

Como o serviço de Analytics está na nuvem, o servidor deverá estar habilitado para comunicação na porta 443 para analytics.fluig.com, caso não esteja habilitado não será possível enviar os dados.


Habilitar o fluig Analytics no fluig

Para habilitar o Analytics no seu ambiente, os seguintes passos devem ser seguidos:


Obter um projeto Analytics. Nele será possível criar o conjunto de um ou mais dashboards no fluig Analytics.

Abra um ticket através do Portal de Clientes em "Central de Chamados → Nova Solicitação → Suporte Técnico" preenchendo os seguintes campos:

OrganizaçãoSelecionar a organização/Empresa
AssuntoCriação de projeto Analytics
Descrição

Informações para criação do contexto: 

  1. Nome da Empresa;
  2. CNPJ;
  3. Código do cliente TOTVS;
  4. Código do contexto a ser criado (normalmente nome da empresa, pode conter espaço, caracteres sem acentuação e números);
  5. Nome e sobrenome do administrador;
  6. E-mail do administrador do ambiente Analytics;
  7. Versão do fluig (ex: 1.6.4-180904)
Tipo de SolicitaçãoSuporte Técnico
ImpactoDúvida sobre o produto
PaísBrasil
Agrupador de serviçosfluig
Produtofluig
MóduloAmbiente
Agrupador de RotinaAcesso
Ambiente

fluig Informar o tipo de Ambiente (Produção ou Homologação)

VersãoInformar versão do fluig.
  • Ao receber o ticket com as informações acima, a equipe de atendimento do fluig criará o projeto solicitado, podendo ser um para produção e outro para homologação se este também for solicitado.
  • O administrador receberá por e-mail um convite para participar do projeto no Analytics e como resposta no ticket, receberá o código do(s) projeto(s) criado(s).
  • Ao receber o e-mail com a resposta do ticket, você poderá seguir para o passo 2 onde poderá configurar a integração do Analytics ao fluig de forma simples e ágil.

Se você é cliente Cloud, os passos seguintes devem ser executados pela equipe de Cloud. Solicite a configuração por ticket.

No ambiente do fluig que se deseja ligar a integração com o Analytics, será necessário acessar com o usuário 'wcmadmin', siga as instruções abaixo:

  1. Menu Painel de controle;
  2. Verificar no agrupador WCM;
  3. Depois acesse a opção Empresas;




Selecione a empresa que deseja habilitar o Analytics após, clique em editar.

É permitido integrar apenas uma empresa (tenant) por projeto no fluig Analytics.


Clique em Cadastrar dados adicionais e na tela adicione as seguintes chaves e valores:

Chave

Valor

analytics.gd.project.id

<seu código de projeto retornado pelo suporte>

analytics.gd.user

<e-mail que recebeu o convite do suporte>

analytics.gd.pass

<senha cadastrada após o convite>

analytics.gd.active

true


Se utilizar um valor do tipo senha recomendamos clicar no botão Esconder Senha (hide password) levando em consideração a Segurança da Informação.


Utilizando este recurso, mesmo logado com usuário administrador e acessando os Dados Adicionais ou executando uma requisição REST a senha apresentada permanecerá em segredo.


Com o convite recebido por e-mail, faça seu cadastro no fluig Analytics. Com esse usuário e senha será possível acompanhar os dados enviados ao Analytics.



Não divulgue seu código de projeto, esse é a chave para acesso ao seu projeto.


Envio dos Dados

Os dados são enviados em intervalos regulares de 30 minutos, sendo que são enviados apenas dados alterados durante o período. A comunicação sempre é feita do servidor do fluig para o Analyticssendo necessária a liberação do firewall para acesso aos endereços abaixo:

Para enviar dados específicos de processos Workflow, o evento beforeSendData deve ser utilizado para configuração dos dados que são enviados para o Analytics. 

O primeiro parâmetro, customField, é um array de String já instanciado contendo 30 posições (de 0 a 29) . O segundo parâmetro, customFact, também é um array com mais de 10 posições onde os dados devem ser do tipo double e o seu conteúdo será tratado como um "fato".

A grande diferença entre um campo customField e customFact é que um campo fato (customFact), por se tratar de um número, pode realizar operações como soma, média, máximo e mínimo portanto, poderá ser calculado. segue alguns exemplos de tipos de campos e em qual valor deveria ficar:

CampoCampo a ser enviadoJustificativa
Região do pedido de compracustomFieldComo só se deseja contar em que regiões foram solicitados os pedidos, não é necessário ser um campo fato.
Nome do solicitantecustomFieldApenas será usado como agrupador.
Valor total do pedidocustomFactPara tirar informações como valor de pedido médio de uma região.
Número de itens no pedidocustomFactSomar quantos itens foram solicitados por um solicitante.


Abaixo um exemplo de implementação do evento preenchendo dois campos:

Note a conversão do campo customFact para Double. Além disso, deve-se ressaltar que campos do tipo "fato" não suportam a utilização de máscaras.

function beforeSendData(customFields, customFacts) {
    customFields[0] ="1";
    customFields[1] =hAPI.getCardValue("campo_do_formulario");

    customFacts[0]=10.53;
    customFacts[1]=java.lang.Double.parseDouble(hAPI.getCardValue("campo_valor"));
}


Para obter mais informações acesse Criação de Relatórios no fluig Analytics. Nesta página são apresentadas definições e um passo a passo para criação de relatórios.



<!-- Hotjar Tracking Code for tdn.totvs.com -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:577655,hjsv:5};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'//static.hotjar.com/c/hotjar-','.js?sv=');
</script>