Í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 a plataforma TOTVS Fluig está instalado instalada (leitura);

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

Java 7 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 o arquivo TXT para envio de campos de formulários não for criado, os campos previamente enviados para o Analyticis serão eliminados durante o processo de importação de dados históricos.

...

Para 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á 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 é necessário preciso parar o serviço do Fluig fluig (este procedimento pode ser realizado enquanto o TOTVS Fluig Plataforma está em execução). Existem duas formas para realizar

Primeiramente, será necessário efetuar o download do artefato correspondente à atualização da plataforma para o qual o importador será executado, 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.

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

Copie o arquivo analytics-import-1.5.jar (ou para versões inferiores a 1.4.12: analytics-import-1.4.jar) para o servidor do Fluig;Coloque o importador dentro do diretório raiz da instalação da plataforma.
Execute o importador (com um duplo clique ) ou através da 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 está instaladoa plataforma está instalada, o código do tenant (empresa), o código do tenant e projeto no 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 analytics-import-1.5.jar (ou para versões inferiores a 1.4.12: analytics-import-1.4.jar) para o servidor do Fluig;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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>

Bloco de código

language	none
theme	Emacs
title	Exemplo

java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017

Nota

title	ATENÇÃO

O formato da data informada deverá ser DD/MM/AAAA

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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar

Bloco de código

language	none
theme	Emacs
title	Exemplo

 java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017 gerar

Nota

title	ATENÇÃO

O formato da data informada deverá ser DD/MM/AAAA

...

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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  enviar

Bloco de código

language	none
theme	Emacs
title	Exemplo

java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017 enviar

Nota

title	ATENÇÃO

O formato da data informada deverá ser DD/MM/AAAA

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

theme	Emacs

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> deletar <DATASET>

Bloco de código

language	none
title	Exemplo

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

...

Ao término da execução do processo de importação, será gerado um log no diretório onde o arquivo analytics-import.jar foi executado.

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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar true SCHEMA

Bloco de código

language	none
theme	Emacs
title	Exemplo

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

Este recurso faz com que os eventos beforeSendData das solicitações 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() e gerar logs, outros métodos não serão executados.

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.

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 25

Nova versão Atual

Chave

Índice

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 25

Nova versão Atual

Chave

Índice

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)