Índice
Índice |
---|
outline | true |
---|
exclude | .*ndice |
---|
style | none |
---|
|
Pré-requisitos
- Acesso ao servidor onde o fluig está instalado (leitura);
- fluig Analytics habilitado e configurado. Para mais informações, clique aqui;
Aviso |
---|
|
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: 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")); |
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:
Nota |
---|
|
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)
- 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);
Execute o importador com um duplo clique ou via linha de comando (substituindo <VERSION> pele versão do importador):
Bloco de código |
---|
|
java -jar analytics-import-<VERSION>.jar |
- 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.
- Clique no botão Iniciar importação e aguarde o processo de importação
Execução modo texto (gera e envia todos os dados)
- 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);
- Execute o importador informando os seguintes parâmetros na linha de comando:
Bloco de código |
---|
|
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.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 |
Nota |
---|
|
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:
Bloco de código |
---|
|
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.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar |
Nota |
---|
|
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:
Bloco de código |
---|
|
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.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 enviar |
Nota |
---|
|
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:
Bloco de código |
---|
|
java -jar analytics-import-<VERSION>.jar <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> deletar <DATASET> |
Bloco de código |
---|
|
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:
Bloco de código |
---|
|
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.5-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar true SCHEMA |
Nota |
---|
|
Esta função só está disponível no importador 1.6.2 |
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.
Nota |
---|
|
Esta função só está disponível por linha de comando |