Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
outlinetrue
exclude.*ndice
stylenone

 

Dica
iconfalse
titleImportação de dados de formulário

Para importar dados de formulário, clique aqui

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 a plataforma TOTVS Fluig está instalado instalada (leitura);
  • Fluig Analytics habilitado e configurado. Para mais informações, clique aqui;

 

Aviso

ATENÇÃO! Se o arquivo TXT para envio de campos customizados não for criado, os campos customizados existentes antes da importação serão ELIMINADOS!

...


Informações
titlePlataforma em Cloud

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
titleAtenção!

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, a declaração de campos ou fatos personalizados, ele criará os arquivo necessários para o envio destes dados automaticamente. O código dentro do evento deve seguir o formato abaixo:

Bloco de código
languagejs
themeConfluence
titleExemplo 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"));

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 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
historyfalse
id1
Card
id1
labelPasso 1


  • Acesse o endereço analytics.fluig.com


Image Added


Card
id1
labelPasso 2


  • Clique sobre Manage > Solicitação


Image Added


Card
id1
labelPasso 3


  • Para verificar se houve alguma interrupção no envio de dados do TOTVS Fluig Plataforma para o Analytics, procure por um intervalo de tempo onde os dados não foram sincronizados. No exemplo abaixo a última atualização foi no dia 25/05/2018 retornando no dia 07/06/2018. -Data em que este exemplo foi incluído na documentação.


Image Added



Download do importador

Para o processo de importação, não é necessário preciso parar o serviço do Fluig fluig (este procedimento pode ser realizado enquanto o TOTVS Fluig Plataforma está em execução). Existem duas formas para realizar

Primeiramente, será necessário efetuar o download do artefato correspondente à atualização da plataforma para o qual o importador será executado, disponível aqui.

Nota
titleAtenção!

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
titleFique atento!

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.

Painel

java.io.FileNotFoundException: <fluig-installation>/appserver/bin/  wildfly-config (No such file or directory)

Para isso:

  • Acesse a pasta <fluig-installation>/appserver/bin/
  • Crie o arquivo wildfly-config, e informe se o modo de inicialização do Fluig é "domain" ou "standalone" incluindo apenas um dos dois modos de inicialização.
  • Após isso, execute novamente o importador.
Aviso
titleObservação

Não é oferecido suporte à campos pai x filho nos eventos beforeSendData, quando realizada a extração manual. 

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

  1. Copie o arquivo analytics-import-1.5.jar (ou para versões inferiores a 1.4.12: analytics-import-1.4.jar) para o servidor do Fluig;Coloque o importador dentro do diretório raiz da instalação da plataforma.
  2. 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
    languagenone
    themeEmacs
    java -jar analytics-import-<VERSION>.jar
  3. Informe o diretório onde o Fluig está instaladoa plataforma está instalada, o código do tenant (empresa), o código do tenant e projeto no 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

...

Image Added


Execução modo texto (gera e envia todos os dados)

  1. Copie o arquivo analytics-import-1.5.jar (ou para versões inferiores a 1.4.12: analytics-import-1.4.jar) para o servidor do Fluig;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
languagenone
themeEmacs
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>
Bloco de código
languagenone
themeEmacs
titleExemplo
java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017
Nota
titleATENÇÃO

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
languagenone
themeEmacs
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar
Bloco de código
languagenone
themeEmacs
titleExemplo
 java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017 gerar
Nota
titleATENÇÃO

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
languagenone
themeEmacs
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  enviar
Bloco de código
languagenone
themeEmacs
titleExemplo
java -jar analytics-import-1.6-v3.jar  c:\fluig 1 abc123def456ghi789jkl012mno345pq 10/1001/19802017 0110/0102/20142017 enviar
Nota
titleATENÇÃO

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
themeEmacs
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> deletar <DATASET>
Bloco de código
languagenone
titleExemplo
java -jar analytics-import-1.6-v3.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
languagenone
themeEmacs
java -jar analytics-import-<VERSION>.jar  <INSTALACAO_FLUIG> <ID_TENANT> <ID_PROJETO> <DATA_INICIAL> <DATA_FINAL>  gerar true SCHEMA
Bloco de código
languagenone
themeEmacs
titleExemplo
 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.