Histórico da Página
Índice
Índice | ||||||
---|---|---|---|---|---|---|
|
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;
- 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)
Informações | ||
---|---|---|
| ||
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 | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
Para 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, 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 ele criará os arquivo necessários para o envio destes dados automaticamente. O código dentro do evento deve seguir o formato abaixo:
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 de 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 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
|
...
Download do importador
Para o processo de importação, não é necessário 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 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.5.13 | fluig 1.5.x (x < 13) | fluig 1.4.13 ou inferior | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
...
disponível aqui.
Nota | ||
---|---|---|
| ||
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 | |||||||
---|---|---|---|---|---|---|---|
| |||||||
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.
Para isso:
|
Execução simples (gera e envia todos os dados em modo visual)
- 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.
Execute o importador (com um duplo clique ) ou através da 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
- Informe o diretório onde o fluig a plataforma está instaladoinstalada, o código do tenant (empresa), o código do projeto no analytics 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 analytics 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);Coloque o importador dentro do diretório raiz da instalação da plataforma
- Execute o importador informando os seguintes parâmetros na linha de comando:
...
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
java -jar analytics-import-1.5.136-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)
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
java -jar analytics-import-1.56-v3.13.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)
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
java -jar analytics-import-1.5.136-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)
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 | ||||
---|---|---|---|---|
| ||||
java -jar analytics-import-1.56-v3.13.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq deletar dataset.solicitacao |
...
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)
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 | ||||
---|---|---|---|---|
| ||||
java -jar analytics-import-<VERSION>.jar <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL> gerar true SCHEMA |
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
java -jar analytics-import-1.6-v3.jar c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/01/2017 10/02/2017 gerar true SCHEMA |
Este recurso faz com que os eventos beforeSendData das solicitações 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() e gerar logs, outros métodos não serão executados.
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.