Índice

outline	true
exclude	.*ndice
style	none

Pré-requisitos

Estar em uma atualização do TOTVS Fluig Plataforma 1.6.3 - EP 15, 1.6.4-180606 ou superior;

Acesso ao servidor onde o fluig está instalado a plataforma TOTVS Fluig está instalada (leitura);

fluig Analytics habilitado e configurado. Para mais informações, clique aqui;

Java 8 instalado;

Configurar os arquivos TXT para envio de campos de formulários (vide Importação de dados de formulário).

...

Informações

title	Plataforma em Cloud

Clientes cloud precisam entrar em contato com o time de Cloud informando a empresa (Produção ou homologação) código do projeto Analytics (Recebido no convite de ativação), tenant da empresa e período desejado para que seja realizado a importação dos dados.

Aviso

title	Atenção!

Se os arquivos TXT e/ou FAC para envio de campos de formulários e fatos não forem criados, os campos previamente enviados para o Analytics serão eliminados durante o processo de importação de dados históricos.

A partir da versão 3 (1.5-v3) do importador, caso não exista o arquivo TXT ou FAC para um determinado processo/versão, o importador irá verificar a existência de evento beforeSendData para este processo/versãoPara a correta importação dos dados das solicitações de processos customizados que possuem mais de uma versão, o importador fará a verificação da existência do evento beforeSendData().

Caso o importador encontre na implementação desse evento, respectivamente, a declaração de campos ou fatos personalizados, ele criará o arquivo necessário automaticamente. A declaração os arquivo necessários para o envio destes dados automaticamente. O código dentro do evento deve seguir o formato abaixo:

Bloco de código

language	js
theme	Confluence
title	Exemplo de declaração de campos e fatos personalizados no evento beforeSendData

customFields[0] = hAPI.getCardValue("fieldname");
customFacts[0] = java.lang.Double.parseDouble(hAPI.getCardValue("fieldname"));

Sendo que "customFields[0]" é responsável pelo envio de dados tipo texto, e "customFacts[0]" pelo envio de dados do tipo numérico.

Caso existam campos que utilizem funções específicas (split, por exemplo) para a definição do seu valor, o campo não será considerado nesta criação automática do arquivo.

Consulta do dia e hora do seu último envio de dados da plataforma ao Analytics

Para a consulta do envio de dados, siga os passos abaixo:

Deck of Cards

history	false
id	1

Card

id	1
label	Passo 1

Acesse o endereço analytics.fluig.com

Image Added

Card

id	1
label	Passo 2

Clique sobre Manage > Solicitação

Image Added

Card

id	1
label	Passo 3

Para verificar se houve alguma interrupção no envio de dados do TOTVS Fluig Plataforma para o Analytics, procure por um intervalo de tempo onde os dados não foram sincronizados. No exemplo abaixo a última atualização foi no dia 25/05/2018 retornando no dia 07/06/2018. -Data em que este exemplo foi incluído na documentação.

Image Added

Download do importador

Para o processo de importação, não é preciso parar o serviço do fluig (este procedimento pode ser realizado enquanto o fluig TOTVS Fluig Plataforma está em execução).

Primeiramente, será necessário efetuar o o download do do artefato correspondente à versão do fluig atualização da plataforma para o qual o importador será executado, disponíveis na tabela abaixo:

...

fluig 1.4.13 ou inferior

...

View file

name	analytics-import-1.6.3.jar
height	150

...

View file

name	analytics-import-1.6.2.jar
height	150

...

View file

name	analytics-import-1.6.jar
height	150

...

View file

name	analytics-import-1.5-v3.jar
height	150

...

View file

name	analytics-import-1_4.jar
height	150

disponível aqui.

Nota

title	Atenção!

Informamos que este importador de dados é compatível com as versões: 1.7.1 e inferiores.

Para as versões 1.8.0 e superiores o importador compatível pode ser baixado aqui.

Execução do Importador

Após efetuar o download, a importação de dados históricos pode ser realizada de duas formas. Segue abaixo:

Informações

title	Fique atento!

Caso o erro abaixo seja exibido na execução do importador, significa que o arquivo de validação do modo de startup do Wildfly não foi gerado e será necessário cria-lo manualmente.

Painel
java.io.FileNotFoundException: <fluig-installation>/appserver/bin/ wildfly-config (No such file or directory)

Para isso:

Acesse a pasta <fluig-installation>/appserver/bin/
Crie o arquivo wildfly-config, e informe se o modo de inicialização do Fluig é "domain" ou "standalone" incluindo apenas um dos dois modos de inicialização.
Após isso, execute novamente o importador.

Aviso

title	Observação

Não é oferecido suporte à campos pai x filho nos eventos beforeSendData, quando realizada a extração manual.

Informações
O Arquivo analytics-import-1.6.3.jar pode ser usado somente a partir da versão 1.6.1 do fluig.

...

Execução simples (gera e envia todos os dados em modo visual)

Copie o arquivo para uma pasta qualquer (nesta pasta, a partir da versão 1.5.13, serão criados os arquivos .TXT e .FAC citados no início deste artigo);Coloque o importador dentro do diretório raiz da instalação da plataforma.
Execute o importador com um duplo clique ou via linha de comando (substituindo <VERSION> pele versão do importador):
Bloco de código
language none
theme Emacs
java -jar analytics-import-<VERSION>.jar
Informe o diretório onde o fluig a plataforma está instaladoinstalada, o código do tenant (empresa), o código do projeto no fluig Analytics para onde os dados serão enviados, e o período (data inicial e final) dos dados a serem importados. O código do projeto no Analytics é o mesmo inserido na configuração da empresa, com a chave analytics.gd.project.id.
Clique no botão Iniciar importação e aguarde o processo de importação

...

Image Added

Execução modo texto (gera e envia todos os dados)

Copie o arquivo para uma pasta qualquer (nesta pasta, à partir da versão 1.5.13, serão criados os arquivos .TXT e .FAC citados no início deste artigo);Coloque o importador dentro do diretório raiz da instalação da plataforma
Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código

language	none
theme	Emacs
title	Exemplo

java -jar analytics-import-1.56-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017

...

Execução modo texto (somente gera dados)

1.Coloque o importador dentro do diretório raiz da instalação da plataforma.

2.Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código

language	none
theme	Emacs
title	Exemplo

 java -jar analytics-import-1.56-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar

...

Execução modo texto (somente enviar dados)

1.Coloque o importador dentro do diretório raiz da instalação da plataforma.

2.Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código

language	none
theme	Emacs
title	Exemplo

java -jar analytics-import-1.56-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 enviar

...

Execução modo texto (deletar dados)

1.Coloque o importador dentro do diretório raiz da instalação da plataforma.

2.Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código

language	none
title	Exemplo

java -jar analytics-import-1.56-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq deletar dataset.solicitacao

...

Execução modo texto (executando eventos e conferindo log)

1.Coloque o importador dentro do diretório raiz da instalação da plataforma.

2.Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código

language	none
theme	Emacs
title	Exemplo

 java -jar analytics-import-1.56-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar true SCHEMA

Nota

title	ATENÇÃO

Esta função só está disponível no importador 1.6.2

Esta função faz Este recurso faz com que os eventos beforeSendData das solicitações executem ao invés de serem lidos caso o importador não encontre arquivos .TXT e .FAC sejam executados mapeando os campos dos formulários. Os eventos só irão simular a execução de eventos com hAPI.getCardValue("Campo") e hAPI.getCardData() além de e gerar logs, outros métodos não serão executados e causarão erro, necessitando a geração dos arquivos .TXT e .FAC.

O parâmetro SCHEMA só é necessário em bases ORACLE, caso contrário há a possibilidade de causar erro nos importadores.

Após a execução neste modo, um log contendo quais eventos foram executados com sucesso e com erro serão exibidos, bem como o select para pesquisar cada registro que o importador utilizou para enviar dados de formulários, sendo bem mais fácil verificar o acontecimento de erros e inconsistências.

...

title	ATENÇÃO

...

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 43

Nova versão Atual

Chave

Pré-requisitos

Consulta do dia e hora do seu último envio de dados da plataforma ao Analytics

Download do importador

Execução do Importador

Execução simples (gera e envia todos os dados em modo visual)

Execução modo texto (gera e envia todos os dados)

Execução modo texto (somente gera dados)

Execução modo texto (somente enviar dados)

Execução modo texto (deletar dados)

Execução modo texto (executando eventos e conferindo log)

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 43

Nova versão Atual

Chave

Pré-requisitos

Consulta do dia e hora do seu último envio de dados da plataforma ao Analytics

Download do importador

Execução do Importador

Execução simples (gera e envia todos os dados em modo visual)

Execução modo texto (gera e envia todos os dados)

Execução modo texto (somente gera dados)

Execução modo texto (somente enviar dados)

Execução modo texto (deletar dados)

Execução modo texto (executando eventos e conferindo log)