Índice

Pré-requisitos

• Acesso ao servidor onde o fluig está instalado (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).

• Configurar os arquivos FAC para envio dos fatos (vide Importação de dados de formulário).

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

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:

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

   Bloco de código
   language none theme Emacs
   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

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

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

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:

• dataset.solicitacao
• dataset.documento
• dataset.pagehit
• dataset.events
• dataset.author
• dataset.place

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

Esta função 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.