Índice

Objetivo

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

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

Descrição

O fluig TOTVS Fluig Plataforma 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

...

Habilitar o

...

Analytics

...

na plataforma

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

Deck of Cards
history false id enable-analytics-steps
Card default true id 1 label Passo 1 Obter um projeto Analytics. Nele será possível criar o conjunto de um ou mais dashboards no Analytics. Abra Abrir um ticket através do Portal de Clientes em "Central de Chamados → Nova Solicitação → Suporte Técnico" preenchendo os seguintes campos: Organização Selecionar a organização/Empresa Assunto Criação de projeto Analytics Descrição Informações para criação do contexto:  Nome da Empresa; CNPJ; Código do cliente TOTVS; Código do contexto a ser criado (normalmente nome da empresa, pode conter espaço, caracteres sem acentuação e números); Nome e sobrenome do administrador; E-mail do administrador do ambiente Analytics; Release do TOTVS Fluig Plataforma (ex: 1.6.4-180904) Tipo de Solicitação Suporte Técnico Impacto Dúvida sobre o produto País Brasil Agrupador de serviços fluig Produto fluig Módulo Ambiente Agrupador de Rotina Acesso Ambiente fluig → Informar o tipo de Ambiente (Produção , Homologação ou Desenvolvimento)OBS: Se desejas criar dois projetos (Produção e Homologação , por exemplo ) solicite por escrito na descrição do ticket. Versão Informar versão do fluig. a release da plataforma TOTVS Fluig Ao receber o ticket com as informações acima, a equipe de atendimento do fluig TOTVS Fluig criará o projeto solicitado, podendo ser um para produção e outro para homologação ou desenvolvimentose 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 à plataforma TOTVS Fluig de forma simples e ágil. Para que a integração ocorra o e-mail informado na criação do projeto precisa ser do administrador do Fluig. Card id 2 label Passo 2 Nota title Importante! Se você é cliente Cloud, os passos seguintes devem ser executados pela equipe de Cloud. Solicite a configuração por ticketporém não tem acesso à senha do usuário wcmadmin entre em contato com time de suporte Cloud para que a senha seja disponibilizada. No ambiente com o fluig da plataforma que se deseja ligar a integração com o Analytics, será necessário acessar o portal do administrador logando com o usuário 'wcmadmin', nele acesse: Menu Painel de controle; Clique na aba WCM; Depois acesse a opção Empresas;  acionar o menu Painel de controle > agrupador WCM e acionar a opçãoEmpresas. Card id 3 label Passo 3   Selecione a empresa que deseja habilitar o Analytics após, clique eme acione editar. Nota É permitido integrar apenas uma empresa (tenant) por projeto no Analytics.   Card id 4 label Passo 4 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   Nota title Importante! 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. Card id 5 label Passo 5   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. Card id 6 label Vídeo Conector de Widget url https://www.youtube.com/watch?v=3ueQE76MPak&feature=youtu.be

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 analytics.fluig.com, da plataforma para o Analytics, sendo necessária a liberação do firewall para acesso a esse endereço.aos endereços abaixo:

• https://analytics.fluig.com
• https://secure.gooddata.com
  
• https://na1.secure.gooddata.com
• https://na1-di.gooddata.com
• https://secure-di.gooddata.com
  
  

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. 

...

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:

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

...

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

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

...

<!-- Hotjar Tracking Code for http://tdn.totvs.com/display/fb -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:5776551280165,hjsv:56};
        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,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>