Índice
Objetivo
TOTVS Fast Analytics® é um produto de Business Analytics, que proporciona tomada de decisão orientada por dados. Este produto é responsável por extrair os dados dos diversos módulos suportados pelo Microsiga Protheus® e levá-los até a plataforma GoodData®, nas quais serão processados e as informações sumarizadas são apresentadas em relatórios e/ou dashboards. Este guia apresenta os procedimentos para implantação de App/Área a seleção e configuração do TOTVS Fast Analytics®.
Guia de Implementação
Pré Requisitos
Aplicação do patch do BAInstaller obtido no Portal do Cliente.
- Dispor do projeto padrão TOTVS Fast Analytics®, que deve ser criado e exportado pelo time Comercial/ Customer Success.
Possuir o Java® com o JRE versão 8 ou superior instalado na máquina em que o programa será executado.
Se o Java® estiver desatualizado, será apresentado o erro: A0017_Error_uploading_to_WebDAV:_java.lang.RuntimeException:Could_not_generate_DH_key_pair
Caso ocorra um erro sobre o Java® não ser reconhecido como um comando, consulte: A0002_Mensagem:_Java_não_é_reconhecido_como_um_comando_interno_ou_externo
Liberação da porta 443 e algumas URL's no servidor do cliente.
Para verificar os links necessários e o erro que a falta dessas liberações causa, veja: A0016_Ao_executar_o_Run.bat_é_apresentado_o_erro:Error_uploading_to_WebDAV:Connection_timed_out:connect
Caso o Agent seja executado pelo Schedule do Protheus®, é necessário criar a pasta biextractor dentro do diretório Rootpath utilizado pelo Protheus® e adicionar os arquivos do Agent.
O TOTVS Fast Analytics® por padrão, é instalado por empresa, porém é possível executar a instalação por Empresa\Filial. Para isso, é necessário configurar no appserver.ini o parâmetro BAFILIALEXEC para o valor igual á 1.
Passo-a-Passo
Protheus®
Inicie o TOTVS SmartClient®.
No campo "Programa Inicial", preencha com BAInstaller e os demais campos com suas respectivas informações de ambiente. Em seguida, clique em "Ok".
Selecione a(s) área(s) que deseja instalar e clique em "Confirmar" ou "Cancelar", para interromper a instalação.
Aguarde o processo ser concluído e clique em "Ok".
Para conferir a conclusão da instalação, realize uma consulta na tabela de processos I01.
Serão listadas as consultas instaladas.
Agent
A atualização dos dados no GoodData® pode ser efetuada via arquivo .properties ou Interface.
Configure o arquivo .properties.
O seguinte documento apresenta todas as informações necessárias para o correto preenchimento do arquivo my.properties: Configuração do my.properties.
Execute o Run.bat.
Lembre-se que este arquivo deve estar apontando para o arquivo .properties configurado e o Agent (arquivo jar) desejado. Consulte o seguinte documento para mais informações: Verificar versão do Agent.
Se for retornado algum erro que impediu o fim da execução do processo do Agent, ou se ainda possui dúvidas, acesse: Agent
Ao finalizar a execução, abra o arquivo agent.log (contido na pasta log do Agent) para verificar se ocorreram erros durante o processo de ETL.
Após a execução com sucesso do Agent, acesse os dashboards na plataforma GoodData® para visualizar os valores processados.
Agendamento da execução do Agent
A execução do Agent poderá ser agendada via Schedule do Protheus®.
Para informações sobre como configurar o agendamento, acesse: Execução do Agent via Schedule.
O Agent por Interface permite a configuração e execução do processo do agent de forma mais fácil e intuitiva, minimizando o tempo de implantação e eventuais erros de configuração. Este processo é realizado através do arquivo totvs-agent.exe e suas principais funcionalidades são descritas a seguir:
Ao utilizar o Agent por Interface não é necessário efetuar a configuração do agent no Scheduler do Windows, pois todo o processo é controlado pela ferramenta.
Pré Requisitos
O processo de instalação das queries executado - BAINSTALLER;
Pacote do Agent Interface baixado do Portal do Cliente ( Protheus - TOTVSTEC-FRAMEWORK - BA - AGENT_INTERFACE-X.0.0.ZIP ) e descompactado.
- Executar o arquivo totvs-agent.exe como Administrador para permitir a correta instalação e execução dos serviços.