Índice


Pré-requisitos

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ão.

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 deve seguir o formato abaixo:

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

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.


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 está em execução).

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

As novas versões do importador estarão disponíveis nesta documentação em breve.


Execução do Importador

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

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

  2. Execute o importador com um duplo clique ou via linha de comando (substituindo <VERSION> pele versão do importador):

    java -jar analytics-import-<VERSION>.jar
  3. Informe o diretório onde o fluig está instalado, 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


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);
  2. Execute o importador informando os seguintes parâmetros na linha de comando:
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>
java -jar analytics-import-1.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017

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


Execução modo texto (somente gera dados)

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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar
 java -jar analytics-import-1.5-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar

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


Execução modo texto (somente enviar dados)

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

java -jar analytics-import-<VERSION>.jar <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  enviar
java -jar analytics-import-1.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 enviar

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


Execução modo texto (deletar dados)

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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> deletar <DATASET>
java -jar analytics-import-1.5-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq deletar dataset.solicitacao

Segue datasets válidos:

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)


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

java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar true SCHEMA
 java -jar analytics-import-1.5-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar true SCHEMA

Este recurso só está disponível no importador 1.6.2


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 mapeando os campos. Os eventos só irão simular a execução de eventos com hAPI.getCardValue("Campo") e hAPI.getCardData() além de 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.



Este recurso só está disponível por linha de comando