Gestão do Ponto X - Coletor de arquivos

O Gestão do Ponto X - Coletor de arquivos é uma ferramenta de monitoramento e processamento automático de arquivos de marcação de ponto integrado ao Senior X. A ferramenta foi desenvolvida para automatizar a coleta de arquivos de marcação de ponto que até então era feita de forma manual via Gestão do Ponto X.

Por meio dessa ferramenta é possível definir o monitoramento dos arquivos gerados de marcação de ponto disponibilizados em um diretório de rede. A leitura desses arquivos é realizada automaticamente após agendamento definido pelo usuário.

Pré-requisitos

Para que a instalação do Gestão do Ponto X - Coletor de arquivos seja bem sucedida, é preciso garantir as seguintes configurações:

Porta de comunicação: O Gestão do Ponto X - Coletor de arquivos utiliza uma porta de comunicação que precisa ser liberada para que a aplicação seja iniciada. Por padrão, essa porta é a 8080, mas, durante a instalação do sistema, será possível alterá-la se necessário.

OpenJDK 17 ou superior: Para realizar a instalação do Gestão do Ponto X - Coletor de arquivos, é necessário ter instalado no computador desejado o Java na versão 17 ou superior. Para realizar o download, acesse o Java SE 17 Archive Downloads.

Usuário/Serviço: Fica a critério das definições de infraestrutura e segurança da rede do computador em que o Gestão do Ponto X - Coletor de arquivos será instalado. Durante a etapa de instalação será necessário informar um usuário de rede para autenticar no serviço que será responsável por iniciar o sistema, ou utilizar a conta local. Ao utilizar o serviço em conta local, pode haver limitações de acesso a diretório de rede para a leitura dos arquivos de marcações e permissão de atualização automática.

Permissões: Para o correto funcionamento do sistema, é necessário que o usuário tenha permissão para acessar e realizar downloads por meio do URL: https://hcm.senior.com.br/coletor-arquivos-ponto.

Instalando o Gestão do Ponto X - Coletor de arquivos

Para instalar o Coletor de arquivos de marcação de ponto, realize os procedimentos abaixo:

1. Realize o download do ClockingEventFileCollector-Setup.exe ou ClockingEventFileCollector-Setup.zip. Caso opte pela pasta compactada, descompacte o arquivo executável para prosseguir;

2. Execute o ClockingEventFileCollector-Setup.exe para iniciar o Assistente do instalador do Gestão do Ponto X - Coletor de arquivos;

3. Selecione o local de destino em que será instalado o sistema e clique em Avançar;

4. Selecione o diretório Java JDK 17 ou superior e clique em Avançar;

5. Informe a porta que será utilizada pela aplicação. Por padrão, essa porta é a 8080, mas, nesse momento da instalação, é possível alterá-la se necessário. Em seguida, clique em Avançar;

6. Selecione os componentes que deverão ser instalados e clique em Avançar;

7. Selecione a pasta para a criação dos atalhos e clique em Avançar;

8. Revise as informações de instalação e clique em Instalar. Aguarde a finalização do processo de instalação e clique em Concluir.

Integrando o Gestão do Ponto X - Coletor de arquivos ao Senior X

Para que seja possível integrar as marcações ao Senior X, primeiro é necessário configurar a aplicação. Siga os procedimentos a seguir:

1. Acesse Senior X > Tecnologia > Administração > Gerenciamento de aplicações > Nova aplicação. Cadastre uma aplicação e gere a chave de acesso. Salve a chave de acesso e o secret para configuração posterior na interface do Coletor de arquivos;

2. Acesse: menu Tecnologia > Administração > Autorização > Gestão dos Papéis > Novo papel > Cadastrar um papel exclusivo para o coletor de arquivos.

Na aba Permissões, clique em Atividade e busque pelo nome Coletor de arquivo. Selecione a atividade Gestão do Ponto X – Coletor de arquivos e configure os recursos clicando no box de seleção.

Configure-os da seguinte forma:

Collector: Visualizar
Download/Upload: Permitir
Leitura de marcações: Permitir

3. Ainda com o papel selecionado, acesse a aba Aplicações e selecione a aplicação Gestão do Ponto X – Coletor de arquivos cadastrada no passo 1 da integração e salve as alterações;

4. Com as chaves geradas (chave de acesso e secret), acesse a interface do Coletor de arquivos em http://localhost:8080 > Configurações. Na tela Configurações da API, informe a chave de acesso, secret e tenant nos campos específicos. Também é possível alterar o intervalo de execução do processamento de coleta dos arquivos de marcação de ponto que, por padrão, é de 5 minutos.

Após salvar as configurações, será possível testar a conexão. O Gestão do Ponto X - Coletor de arquivos só irá integrar com o Senior X se a conexão for realizada com sucesso.

Cadastrando os coletores

Para cadastrar os coletores, acesse a interface do Coletor de arquivos em http://localhost:8080 > Coletores > Adicionar. Selecione o coletor cadastrado no Gestão do Ponto X e informe o diretório em que os arquivos de ponto serão depositados para leitura.

Os patterns aceitos são:

\\ pasta\*.txt - Todos arquivos .txt
\\ pasta\layout.* - Arquivos começando com “layout”
\\ pasta\arquivo.* - Arquivo com qualquer extensão (ex.: arquivo.txt, arquivo.csv)
\\ pasta\.* - Qualquer arquivo (muito genérico, mas seguro contra loops)
c:\pasta\arquivo.* - Caminho local com curinga

Sincronização dos coletores

Quando o coletor é alterado no Senior X, a informação precisa ser sincronizada no Coletor de arquivos. Há uma atualização automática diariamente entre 01:00 às 05:00 horas da manhã. Porém, há uma opção de forçar a sincronia instantânea no botão Sincronizar com o Senior X.

Forçar execução

Ao clicar no botão Forçar execução, a execução da leitura será iniciada no mesmo momento, ainda que a configuração esteja definida para realizar o processo a cada 60 minutos.

Leitura de arquivos de marcações de ponto

O Gestão do Ponto X - Coletor de arquivos fará a leitura dos arquivos de forma automática conforme agendamento realizado no menu Configurações. Dessa forma, será possível acompanhar a leitura dos arquivos no menu Arquivos. Por meio dessa tela será possível visualizar a lista com os arquivos processados e seus status de processamento.

Possíveis status dos arquivos coletados para leitura:

Pendente: arquivo aguardando processamento
Processando: o processamento foi iniciado
Sucesso: processado com êxito
Erro: falha no processamento. O sistema fará até 10 tentativas de processamento dos arquivos que tiverem falha na leitura
Duplicado: arquivo com conteúdo idêntico a outro já processado com sucesso

Os arquivos processados serão movidos para uma pasta chamada processados, independente do seu status. À medida que os arquivos forem processados, eles serão renomeados de acordo com seu status após o processamento, que são:

• Arquivos processados com sucesso: renomeado de arquivo.afd para arquivo.afd.processed;
  
• Arquivos com falha no processamento: renomeado de arquivo.afd para arquivo.afd.error;
  
• Arquivos duplicados: renomeado de arquivo.afd para arquivo.afd.duplicate.
  

Downloads

JDK: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html

Instalador

São disponibilizadas duas opções, o arquivo executável ou a pasta compactada (para quem tem restrições de download de um arquivo executável).

Executável: https://hcm.senior.com.br/coletor-arquivos-ponto/ClockingEventFileCollector-Setup.exe
Pasta compactada: https://hcm.senior.com.br/coletor-arquivos-ponto/ClockingEventFileCollector-Setup.zip

Permissões

Atividade: Gestão do Ponto X – Coletor de arquivos (task://senior.com.br/hcm_clocking_event_time_evaluation/database/fileCollector)

Configure os recursos da seguinte forma:

Collector: Visualizar
Download/Upload: Permitir
Leitura de marcações: Permitir