Manual

PontualAgent

Confira o passo a passo para a instalação e a desinstalação da aplicação PontualAgent e possíveis erros do sistema com suas resoluções.

1. Download

O download do aplicativo está disponível no site do sistema Pontual (https://pontual.betha.cloud/).
Ao acessar o site, há um menu localizado no canto superior direito da página.
Na opção Utilitários (seu ícone é uma engrenagem) encontra-se o download para para o aplicativo conforme a imagem a seguir:

2. Recursos necessários

Para o funcionamento correto da aplicação é necessário estar instalado o JDK (Java Development Kit).
Para saber se você possui este pacote instalado em seu computador basta acessar o Painel de Controle > Programas e Recursos e verificar a lista de softwares instalados.
Recomendamos o uso da versão 8 (8u202) em diante. Link para download do JDK: https://www.oracle.com/br/java/technologies/javase/javase8-archivedownloads.html.

3. Instalação

Após a conclusão do download, o início da instalação deve ser feito clicando com o botão direito do mouse no arquivo pontual-agent-2020.4.5.exe (a versão pode ser outra dependendo da data de download), escolhendo a opção Executar como administrador e seguir o passo a passo abaixo:

Clique no botão Próximo.

Caso apareça esta mensagem informando que aparentemente o sistema não possui um JDK instalado, se instalado, desconsidere e clique em Sim:

Nesta tela, está selecionado o local onde será instalada a aplicação, clique em Próximo:

Posteriormente, é informada a criação do diretório, clique em Ok:

Após isso, selecione o modelo do leitor que você instalará em sua máquina e clique em Próximo.
Iniciará o processo de instalação do driver do leitor selecionado, siga as instruções de instalação do driver até a sua conclusão.

Após a conclusão da instalação do driver, aparecerá a próxima tela, informando a conclusão dos processos de instalação. Clique em Próximo.

No passo 5, estão as opções de criação de atalhos da Área de Trabalho do seu computador. Recomendamos deixar as configurações como estão. Clique em Próximo.

Por fim, a conclusão da instalação do PontualAgent, clique em Pronto.

4. Não sobrescreva a instalação

Caso a aplicação esteja instalada no seu computador e surgiu a necessidade de uma nova instalação, não deve-se sobrescrever a instalação.

O procedimento correto para o funcionamento em totalidade do programa é proceder com a sua desinstalação anterior à nova instalação. Para isso, existe um atalho na área de trabalho chamado Uninstaller PontualAgent. O procedimento pode ser realizado por este atalho ou pelo arquivo executável uninstaller situado em C:\Arquivos de programas\PontualAgent\Uninstaller.

Na desinstalação selecione a caixinha de seleção Forçar a desinstalação, clique em Desinstalar e prossiga com a instalação. Depois de concluída, volte para o diretório Arquivos de programas e exclua a pasta PontualAgent.

5. Configurando o PontualAgent

Para configurar a aplicação, primeiramente clique no atalho Iniciar servico do PontualAgent localizado na área de trabalho, a aplicação iniciará, em seguida clique no atalho Configurar PontualAgent, também na área de trabalho, que fará com que abra a janela abaixo.
Na aba General localize o botão Start, clique nele e aguarde. A habilitação do botão Stop para clique é um sinal de que o PontualAgent está iniciado, como podemos ver nas imagens a seguir.

6. Testando a aplicação

Para aferir o funcionamento das funções da aplicação deverá ser efetuado dois testes, primeiro abrindo um relógio no sistema https://pontual-ponto.betha.cloud/ e simulando uma marcação de ponto (colocando o dedo no leitor do dispositivo) e o segundo teste, cadastrando uma digital no sistema https://pontual.betha.cloud/

• 1º teste: marcando ponto

Clique no atalho Pontual na área de trabalho para abrir o sistema https://pontualponto.betha.cloud/ o acessando com seu login e senha. O sistema deve permitir a escolha de uma entidade e um relógio sem apresentar erros ou avisos de erros.

Ao iniciar o relógio, o ponto pode ser marcado colocando o dedo no leitor do dispositivo. Caso a digital esteja cadastrada ele deverá registrar o ponto normalmente, caso contrário informará que não identificou a digital e cancelará a marcação.

Na tela da esquerda escolha da entidade, à direita os relógios disponíveis.

A próxima tela, é como relógio aberto. Nesta tela pode ser colocado o dedo no leitor do dispositivo.

• 2º teste: cadastrando uma digital

Acesse o sistema https://pontual.betha.cloud/ e no ambiente Administrador siga os passos abaixo:

Ao clicar em registrar, colocar o dedo no dispositivo para a leitura da digital. O sistema pedirá para escanear a digital quantas vezes estiverem configuradas. A cor do dedo cadastrado ficará verde e o processo deve ser concluído sem apresentar erros.

7. Possíveis erros e suas soluções

Mesmo certificando-se da correta execução do passo a passo acima descrito para a instalação e configuração do PontualAgent, pode ocorrer o surgimento de algum dos erros listados a seguir (já com suas respectivas resoluções):

• Erro 1: O PontualAgent não inicia ao clicar em “Start” nas configurações conforme o Item 5 deste manual

  • Resolução: Substituir os arquivos pontual-agent-bootstrap e pontual-agent da pasta lib, localizada em C:\Arquivos de programas\PontualAgent\lib pelos arquivos hospedados no seguinte link: https://s3.sa-east1.amazonaws.com/pontual.betha.cloud/downloads/cloud/production/pontual-agent.zip. Existe a possibilidade dos arquivos em sua pasta lib estarem com uma versão ao final de seu nome, como por exemplo pontual-agent-2020.4.5 ou pontual-agent-bootstrap-2020.3.0, desconsidere e cole os arquivos baixados mantendo o nome sem versões.

• Erro 2: Ao acessar a página de cadastro de biometria ou acessar o sistema de Ponto, ao surgimento das mensagens: “Sem comunicação com o PontualAgent”, “Comunicação com o PontualAgent fechada” ou alguma outra mensagem de falha ou erro

  • Resolução 1: verificar se o serviço está iniciado (conforme Item 5 deste manual) no atalho Configurar PontualAgent localizado na área de trabalho;
  • Resolução 2: substituir os arquivos pontual-agent-bootstrap e pontual-agent da pasta lib, localizada em C:\Arquivos de programas\PontualAgent\lib pelos arquivos hospedados no seguinte link: https://s3.sa-east1.amazonaws.com/pontual.betha.cloud/downloads/cloud/production/pontual-agent.zip. Existe a possibilidade dos arquivos em sua pasta lib estarem com uma versão ao final de seu nome, como por exemplo pontual-agent-2020.4.5 ou pontual-agent-bootstrap-2020.3.0, desconsidere e cole os arquivos baixados mantendo o nome sem versões.

• Erro 3: Ao acessar o sistema de ponto, não permite o acesso a entidade (clica-se na entidade mas ela não abre os relógios disponíveis). Possivelmente foi sobrescrita a instalação

  • Resolução: desinstalação e reinstalação da aplicação (ver Item 4 deste manual).

• Erro 4: Ao reinstalar a aplicação apresentar uma mensagem informando que o serviço está em uso ou rodando, mesmo após a correta desinstalação da aplicação

  • Resolução 1: reiniciar o Windows e realizar uma nova instalação (verificar se não foi criada a pasta PontualAgent em “C:\Arquivos de programas\”, no caso da existência da pasta, deletar a mesma).
  • Resolução 2: em caso de persistência do erro, deletar o serviço via CMD. Para isso abra o menu iniciar, digite CMD. Aparecerá o Prompt de Comando. Clique sobre ele com o botão direito do mouse e clique em Executar como administrador. Rodar o comando sc delete PontualAgent. Após a execução deste comando, dar início a uma nova instalação (verificar se não foi criada a pasta PontualAgent em “C:\Arquivos de programas\”, no caso da existência da pasta, deletar a mesma).