Histórico da Página

...

Deck of Cards

id	agent

Card

label	.properties

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.

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

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.

Card

label	Interface

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:

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

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.

Inicialmente aperte o botão Cadastrar Projeto e selecione o produto no item Linha de Produto. Atualmente existem 3 tipos ( Protheus, Datasul, RM)
Selecione o agent Fast Analytics no item Tipo Agent.
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 será carregado 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 cadastro pode ser efetuado pelo botão ( + ), ou na opção Banco de Dados do menu lateral.
É possível informar configurações adicionais para a execução do JAVA. Este item pode ser cadastrado à partir do botão ( + ), ou na opção Configuração JAVA no menu lateral.
É 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.

Caso seja configurado o projeto para a linha RM será incluídos dois novos campos: Diretório de Queries e Pasta de Scripts.

Image Removed

Já no caso da Linha Datasul apenas o campo: Diretório de Queries.

Nota

Para o cadastro de projetos das linhas RM e Datasul, é necessário informar alguns dados adicionais:

Diretório de Queries: Caminho onde se encontram os arquivos a serem executados pelo Agent.
Pasta de Scripts: Nome da pasta onde os scripts estão armazenados. Esta informação é específica para a linha RM.

Tela do projeto para a linha RM

Tela do projeto para a linha Datasul

Informações

title	Datasul / RM

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	Banco de Dados

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

Informe um identificador para a base de dados em Nome da Configuração.
Selecione o tipo de banco de dados na opção Banco de Dados e informe o usuário e senha para conexão.
Ajuste o item URL para o caminho correto do banco de dados.
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.
Clique em Testar Conexão para verificar se os dados informados estão corretos.
Clique em Salvar.

Expandir

title	JAVA

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

Clique em Nova.
Adicione um identificador para a configuração e clique em Adicionar.
Informe todos os parâmetros que farão parte da configuração e clique em Configurar.

Nota
Os parâmetros de execução do JAVA devem ser cadastrados um por linha. Para incluir um novo parâmetro no cadastro, clique em Adicionar.

Dica

Exemplo de configuração

Alterar o caminho do diretório temporário: -Djava.io.tmpdir=F:\temp\fast
Valor mínimo de memória utilizada pelo JAVA: -Xms256m
Valor máxima de memória utilizada pelo JAVA:-Xmx2048m

Expandir

title	Agendamento

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

Serviço do Agent

Iniciar Serviço: Instala e inicia o serviço do Agent
Parar Serviço: Interrompe o serviço do Agent
...: Apresenta as seguintes opções
- Remover Serviço: Remove o serviço do Agent do sistema.

Nota
Ao utilizar o Agent por Interface não é necessário realizar a configuração do agent no Scheduler do Windows, pois todo o processo é controlado pela ferramenta.

Agendamento

Selecione o botão + Novo para cadastrar Agendamento.

Em Nome do Agendamento adicione um identificador.
Selecione qual projeto na opção Projetos.
Configure os Parâmetros 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.

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

Expandir

title	Novo Agendamento

Permite ao usuário cadastrar um Agendamento para execução do Agent.

Expandir

title	Editar

Apresenta ao usuário as informações do agendamento e permite ajustá-las.

Expandir

title	Excluir

Remove o agendamento do processo de atualização no Gooddata®

Expandir

title	Executar Agent

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

O acompanhamento do processo pode ser efetuado através do menu lateral Log.

Aviso
Para utilizar esta opção, é necessário que o serviço do agent esteja iniciado. Para iniciá-lo, acesse o menu lateral Agendamento e clique em Iniciar Serviço.

Expandir

title	Query - ( Atualmente exclusivo Protheus)

A tela Query apresenta ao usuário as querys cadastradas e já exportadas, além de dois botões: Nova e Exportar.

Ao clicar no botão Nova é apresentado uma tela onde é possível incluir uma Query para ser executada.

Informações

title	Descrição dos Campos

Nome do arquivo: É informado o nome do arquivo com a extensão .txt

Tipo: Deverá selecionar o tipo de informação que será gerada ( Dimensão ou Fato ). Dimensão é o atributo e a Fato é a informação em si.

Recorrência: Existem duas opções Mensal e Período, onde se for escolhido Mensal, a Query será executada por período fechado, no caso uma execução por mês fechado, caso seja escolhido Período ela será executado apenas uma vez respeitando os parâmetros passados a ela.

Caso seja clicado no Botão Exportar é exportado as Querys presentes no banco.

É possível a remoção ou alteração ao clicar nos 3 pontinhos no lado direito do descrição da Query.

Tela da Alteração

Expandir

title	Monitor

A tela Monitor apresenta ao usuário as informações do processos que foram executados.

Ao clicar no botão Detalhar: Efetua a abertura detalhada da execução do Agent.

Expandir

title	Configurações

No menu Configurações é apresentada a tela de configurações do serviço do Agent.

Nessa tela é exibida a porta do servidor da aplicação.

Aviso
Caso a porta do servidor seja alterada é necessário reinstalar o serviço do Agent e reiniciar a aplicação.

Também é possível alterar a frequência em minutos com que o serviço é executado, além de habilitar a exibição das consultas a serem efetuadas na extração dos dados para o projeto.

Dica
As consultas só serão exibidas caso a opção de exibição esteja habilitada e se o projeto do Gooddata® conter um token que permita exíbi-las.

...

Árvore de páginas

Versões comparadas

Versão antiga 74

Nova versão 75

Chave