...
A atualização dos dados no Gooddata® GoodData® pode ser efetuada via arquivo .properties ou Interface.
...
| Deck of Cards |
|---|
|
| Card |
|---|
| 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 GooddataGoodData® 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 |
|---|
| 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
| Expandir |
|---|
| title | Cadastro de Projetos |
|---|
| O Cadastro de Projetos armazena as informações necessárias para a conexão com o projeto do Gooddata®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® 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®GoodData®. Basta utilizar as opções Diretório de arquivos para upload e informar a extensão dos arquivos no campo Tipo de Arquivo.
  | 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 
|
As opções que podem ser executadas pelo usuário são:
| Expandir |
|---|
| Permite ao usuário cadastrar um projeto para execução pelo Agent. |
| Expandir |
|---|
| Apresenta ao usuário as informações do projeto e permite ajustá-las. |
| Expandir |
|---|
| Remove o projeto do cadastro e do processo de atualização no Gooddata®GoodData® |
| Expandir |
|---|
| Remove os arquivos de queries armazenados na estrutura do Agent por Interface. |
|
| Expandir |
|---|
| 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 |
|---|
| 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 |
|---|
| 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
| 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 |
|---|
| Permite ao usuário cadastrar um Agendamento para execução do Agent. |
| Expandir |
|---|
| Apresenta ao usuário as informações do agendamento e permite ajustá-las. |
| Expandir |
|---|
| Remove o agendamento do processo de atualização no Gooddata®GoodData® |
| Expandir |
|---|
| Permite executar de forma imediata o processo de atualização no Gooddata® 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 para a linha Protheus) |
|---|
| A tela Query apresenta ao usuário as querys queries cadastradas e já exportadas , além de dois botões: Nova e Exportar.  Image Removed
Ao clicar no botão Nova é apresentado uma tela onde é possível incluir uma Query para ser executada.  Image Removed
| 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.  Image Removed
É possível a remoção ou alteração ao clicar nos 3 pontinhos no lado direito do descrição da Query.  Image Removed
Tela da Alteração pela aplicação. Image Added
As opções que podem ser executadas pelo usuários são: | Expandir |
|---|
| Permite ao usuário exportar as queries disponíveis na tabela I01 do banco de dados atrelado ao projeto.  Image Added
| Nota |
|---|
Na lista Projetos, serão apresentados somente os projetos do Fast Analytics cadastrados na aplicação. |
| Dica |
|---|
Os arquivos exportados ficam armazenados na estrutura do Agent por Interface. |
|
| Expandir |
|---|
| Permite ao usuário cadastrar novas queries para execução no processo. Estas informações serão armazenadas fisicamente, dentro da estrutura do Agent Interface. - Selecione no campo Projeto para qual projeto a query será disponibilizada.
- Informe no campo Nome do Arquivo a identificação da query com extensão .txt
- No campo Tipo, selecione o tipo de informação a ser gerada, podendo ser uma fato ou dimensão.
- Para queries do tipo Fato, selecione a Recorrência:
- Período: será executado de acordo com o período informado.
- Mensal: a query respeitará o período informado, porém será executada mês a mês..
 Image Added
| Nota |
|---|
A lista Projeto, apresenta apenas os projetos que possuem itens exportados. |
| Dica |
|---|
As informações passadas na tela, durante o cadastro, são importantes para determinar como será o comportamento do Agent. |
|
Para cada item exportado, é possível: - Editar: permite a edição da query para eventuais ajustes.
- Remover: remove o arquivo fisicamente do disco, assim, ele não será mais executado.
Image Added
| Nota |
|---|
Na opção Editar, somente o campo de conteúdo da query pode ser modificado. |
 Image Removed |
| Expandir |
|---|
| 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 |
|---|
| 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® GoodData® conter um token que permita exíbi-las. |
|
|
|
...
