Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Índice
outlinetrue
exclude.*ndice
stylenone

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 7 8 instalado;

...


Informações
titlePlataforma 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
titleAtençã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
languagejs
themeConfluence
titleExemplo 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
historyfalse
id1
Card
id1
labelPasso 1


  • Acesse o endereço analytics.fluig.com


Image Added


Card
id1
labelPasso 2


  • Clique sobre Manage > Solicitação


Image Added


Card
id1
labelPasso 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 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
nameanalytics-import-1.6.3.jar
height150

...

View file
nameanalytics-import-1.6.2.jar
height150

...

View file
nameanalytics-import-1.6.jar
height150

...

View file
nameanalytics-import-1.5-v3.jar
height150

...

View file
nameanalytics-import-1_4.jar
height150

disponível aqui.

Nota
titleAtençã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
titleFique 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
titleObservaçã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)

  1. 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.
  2. Execute o importador com um duplo clique ou via linha de comando (substituindo <VERSION> pele versão do importador):

    Bloco de código
    languagenone
    themeEmacs
    java -jar analytics-import-<VERSION>.jar
  3. 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.
  4. 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)

  1. 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 
  2. Execute o importador informando os seguintes parâmetros na linha de comando:

...

Bloco de código
languagenone
themeEmacs
titleExemplo
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
languagenone
themeEmacs
titleExemplo
 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
languagenone
themeEmacs
titleExemplo
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
languagenone
titleExemplo
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
languagenone
themeEmacs
titleExemplo
 java -jar analytics-import-1.56-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar true SCHEMA
Nota
titleATENÇÃ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.

...

titleATENÇÃO

...