Índice

maxLevel	4
outline	true
exclude	.*ndice
style	none

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 TOTVS Fluig Plataforma possui o possui a funcionalidade avançada de Analytics, que habilita permite a criação de Dashboards e Views Relatórios para acompanhamento de indicadores de informações que acontecem dentro da plataforma Fluig. 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

Informações

title	Nota

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

Habilitar o Analytics na plataforma

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

1º Passo:

:

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 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

...

Versão

...

Fluig

...

Módulo/Produto

...

Fluig

...

Processo ou Rotina

...

Analytics

...

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 ou Homologação)
Versão	Informar a release da plataforma TOTVS Fluig

Ao receber o ticket com as informações acima, a equipe de atendimento TOTVS 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 à 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, poré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 da plataforma

2º Passo

...

que se deseja ligar a integração com o Analytics, será necessário acessar

...

com o usuário

...

'wcmadmin', 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 e 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

Image Modified

...

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.

Image Added

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.

Image Added

Card

id	5
label	Passo 5

Com o convite recebido por e-mail, faça seu cadastro no

...

Analytics. Com esse usuário e senha será possível acompanhar os dados enviados ao Analytics.

Image Added

Card

id	6
label	Vídeo

Conector de Widget

url	https://www.youtube.com/watch?v=3ueQE76MPak&feature=youtu.be

Aviso

title	Aviso

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 uma em uma hora30 minutos, sendo que são enviados apenas dados alterados durante o período. A comunicação sempre é feita do servidor da plataforma para o Analytics, sendo 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:

Campo	Campo a ser enviado	Justificativa
Região do pedido de compra	customField	Como só se deseja contar em que regiões foram solicitados os pedidos, não é necessário ser um campo fato.
Nome do solicitante	customField	Apenas será usado como agrupador.
Valor total do pedido	customFact	Para tirar informações como valor de pedido médio de uma região.
Número de itens no pedido	customFact	Somar quantos itens foram solicitados por um solicitante.

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

Nota

title	Atenção

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.

Bloco de código

language	javascript
title	Exemplo de Evento do Workflows

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"));
}

Dica

title	Atenção

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

Âncora

	_GoBack
	_GoBack

HTML

<!-- 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:1280165,hjsv:6};
        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>

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão 65

Chave

Índice

Objetivo

Descrição

Pré-requisitos

Habilitar o Analytics na plataforma

1º Passo:

2º Passo

Envio dos Dados

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 7

Nova versão 65

Chave

Índice

Objetivo

Descrição

Pré-requisitos

Habilitar o Analytics na plataforma

1º Passo:

2º Passo

Envio dos Dados