Histórico da Página

1. Configure o arquivo .properties.

   Dica
   O seguinte documento apresenta todas as informações necessárias para o correto preenchimento do arquivo my.properties: Configuração do my.properties.

2. Execute o Run.bat.

   

   Dica
   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.

   Aviso
   Se for retornado algum erro que impediu o fim da execução do processo do Agent, ou se ainda possui dúvidas, acesse: Agent

3. 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.

4. 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:

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.

Expandir
title Cadastro de Projetos
O Cadastro de Projetos armazena as informações necessárias para a conexão com o projeto do Gooddata®, conexão com o banco de dados e agendamento do processo. Selecione o produto Fast Analytics no item Linha de Produto. Informe o usuário e senha para conexão ao projeto do Gooddata® e clique em Carregar Projetos. Se os parâmetros de conexão estiverem corretos, na aba Projeto vai carregar o primeiro projeto da lista. Ao selecionar o Processo URL a aba de Graph será carregado com a Main. A seguir, serão apresentadas as informações do Arquivo.zip e a URL para upload do arquivo .zip. Caso seja necessário, estas informações podem ser ajustadas. Selecione o Banco de Dados que será utilizado no projeto. Este pode ser efetuado tanto na opção Banco de Dados do menu lateral, quanto no botão de mais ( + ) na tela de Cadastro. É possível informar configurações adicionais para a execução do JAVA à partir da opção Configuração JAVA no menu lateral, quanto no botão de mais ( + ) na tela de Cadastro.. É possível adicionar arquivos externos ao arquivo .zip enviado ao Gooddata®. Basta utilizar as opções Diretório de arquivos para upload e informar a extensão dos arquivos no campo Tipo de Arquivo. Image Removed Image Removed Configure os Parâmetro SQL que serão utilizados nas consultas. Nota Ao informar um parâmetro fixo é necessário desabilitar a opção Expressão para que o processo seja executado corretamente. Configure os Parâmetros ETL Informe a frequência que o processo deve ser executado na sessão Agent e clique em Salvar. Image Added Image Added Image Added Nota Para que o processo seja realizado conforme o agendamento realizado, é necessário que o serviço do Agent por Interface esteja iniciado. Para mais informações consulte a sessão Agent Agendamento. As opções que podem ser executadas pelo usuário são: Expandir title Novo Projeto Permite ao usuário cadastrar um projeto para execução pelo Agent. Expandir title Editar Apresenta ao usuário as informações do projeto e permite ajustá-las. Expandir title Excluir Remove o projeto do cadastro e do processo de atualização no Gooddata® Expandir title Exportar Queries A opção de exportação gera dentro da estrutura do Agent por Interface as queries instaladas no Protheus® e permite ao usuário customizá-las, quando necessário. Selecione o projeto e clique em Exportar Queries. Ao final do processo será apresentado o caminho onde os arquivos foram armazenados. Expandir title Excluir Queries Remove os arquivos de queries armazenados na estrutura do Agent por Interface.

Permite executar de forma imediata o processo de atualização no Gooddata.

A tela Cadastrar Banco de Dados permite informar as configurações de acesso à base de dados que serão utilizadas pelo Agent.

1. Informe um identificador para a base de dados em Nome da Configuração.

2. Selecione o tipo de banco de dados na opção Banco de Dados e informe o usuário e senha para conexão.

3. Ajuste o item URL para o caminho correto do banco de dados.

4. Se o banco de dados utilizado for Oracle, é possível informar o schema que será utilizado pelo processo através do item Schema do banco de dados.

5. Clique em Testar Conexão para verificar se os dados informados estão corretos.
6. Clique em Salvar.

A tela Parâmetros JAVA para execução do Agent permite informar configurações adicionais que serão utilizadas pelo Agent.

1. Clique em Nova.

2. Adicione um identificador para a configuração e clique em Adicionar.

3. Informe todos os parâmetros que farão parte da configuração e clique em Configurar.

A tela Agent Agendamento engloba os itens para monitoramento do o processo, como o serviço do Agent e o log do processo, Parâmetros SQL, Parâmetros ETL e execução do Agent.

Sessão Serviço do Agent

• Iniciar: Instala e inicia o serviço do Agent

• Parar: Interrompe o serviço do Agent

• ...: Apresenta as seguintes opções

  • Remover: Remove o serviço do Agent do sistema.

Sessão Log do Agent

• Exibir / Ocultar log: Apresenta na tela as últimas ocorrência do log do Agent

• Abrir Arquivo Log: Efetua a abertura do log completo do Agent.

Image Removed

Parametros

Uso do agent

Image Added

Agendamento

Selecione o Banco de Dados que será utilizado no projeto. Este pode ser efetuado tanto na opção Banco de Dados do menu lateral, quanto no botão de mais ( + ) na tela de Cadastro.

As opções que podem ser executadas pelo usuários são:

A tela Log apresenta ao usuário as informações do processo.

Abrir Arquivo Log: Efetua a abertura do log completo do Agent.