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

À partir da versão 1.5.13 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, e criará o arquivo necessário, automaticamente, caso encontre na implementação deste evento a declaração de campos ou fatos personalizados, respectivamente, nos formatos 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 de seu valor, o campo não será considerado nesta criação automática do arquivo.

Como utilizar

Para o processo de importação, não é necessário 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:

fluig 1.5.13fluig 1.5.x (inferior à 1.5.13)

fluig 1.4.x ou inferior

 

Após efetuar o download, existem duas formas para realizar a importação de dados históricos. Segue abaixo:

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

  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 (duplo clique) ou através da linha de comando:

    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 analytics para onde os dados serão enviados, e o período (data inicial e final) dos dados a serem importados.
    1. O código do projeto analytics é o mesmo inserido na configuração da empresa, com a chave analytics.gd.project.id.
  4. Clique no botã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.13.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.13.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.13.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.13.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.