Manual Driver Ronda Acesso
Manual Driver Ronda Acesso
Digicon S. A. Controle Eletrnico para Mecnica Copyright 2010-Digicon S.A.Todos os direitos reservados
Verso 2.3 - 31/03/2012
Sumrio
Objetivo .................................................................................................................................. 4
Histrico de atualizao do Driver.......................................................................................... 4
Primeiros passos ..................................................................................................................... 9
O que preciso para enviar cadastros de colaboradores aos dispositivos ............................ 9
Entendendo o funcionamento do Driver com CSM e DigiREP ............................................. 10
Quando iniciado o servio no Windows ........................................................................ 10
Abrindo comunicao com a CSM .................................................................................... 11
Enviando certificado digital a CSM ................................................................................... 11
Abrindo comunicao com DigiREP .................................................................................. 12
Recebe solicitao de autenticao do DigiREP ............................................................... 12
Recebe colaborador a ser enviado ao DigiREP ................................................................. 13
Driver envia colaborador ao DigiREP ................................................................................ 13
Como funcionam alguns processos do Driver ...................................................................... 14
Carga inicial ....................................................................................................................... 14
Bloqueio do ponto pelo teclado ....................................................................................... 14
Envio de eventos............................................................................................................... 14
Comando de data & hora ................................................................................................. 15
Validao biomtrica por Colaborador............................................................................. 15
Parametrizao do Ronda Acesso ........................................................................................ 16
Site .................................................................................................................................... 16
Plano de Localizao Fsica ............................................................................................... 17
Driver ................................................................................................................................ 18
Catlogo ............................................................................................................................ 19
Dispositivo ........................................................................................................................ 20
Leitora ............................................................................................................................... 24
Instalando o Driver ............................................................................................................... 25
Obtendo o Driver .............................................................................................................. 25
O que ser instalado ......................................................................................................... 25
Requisitos mnimos de ambiente ..................................................................................... 26
Instalao passo a passo ................................................................................................... 26
Configurando o Driver ...................................................................................................... 30
Explorando o ambiente instalado Menu Iniciar ............................................................ 32
Explorando o ambiente instalado Diretrios ................................................................. 33
Console WEB Driver .............................................................................................................. 36
Acessando a console ......................................................................................................... 36
Sobre o Driver ................................................................................................................... 36
Lista de dispositivos gerenciados ..................................................................................... 37
Objetivo
O objetivo deste manual e auxiliar na instalao, parametrizao, desinstalao do Driver
DigiREP Senior e prover informaes para auxiliar os usurios a manter o sistema em
condies de uso.
O sistema envolvido visa atender a comunicao e troca de dados entre o REP (Registrador
Eletrnico de Ponto) Digicon (DigiREP) e a CSM da Senior Sistemas, em atendimento a portaria
do Ministrio do Trabalho e Emprego (MTE) MP 1.510 de 21/08/2009, que regulamenta a
utilizao de sistemas eletrnicos para apurao de ponto.
O Drive tratado neste manual no tem por objetivo a apurao e tratamento dos dados
do ponto, sendo de responsabilidade dos usurios a contratao para tal finalidade, dos
sistemas: Acesso e Segurana (Mdulo Terminal de Ponto) e Vetorh (Mdulo Ronda Ponto).
1.3.16 07/11/2010
1.3.17 07/11/2010
1.3.18 23/11/2010
Descrio
1. Utilizao do framework 3.7.5;
2. Alterada a insero de carto na pessoa para se adequar a nova
verso do framework.
1. Utilizao do framework 3.7.6;
2. Criado um bloqueio para as pessoas com o PIS zerado. Pessoas que
tiverem o pis zerado no so enviadas para o DigiREP;
3. A matricula da pessoa enviada da mesma forma que recebida da
concentradora, ou seja, enviado caracteres tambm;
4. As mensagens que esto na lista para serem enviadas para o DigiREP
que no forem envidas, so armazenadas para serem enviadas
quando o DigiREP se conectar novamente.
1. Verso 1.3.15 compilada;
2. Verso enviada para o Aleixo.
1. Corrigido o erro de enviar o comando 0x29 sem cartes e sem
biometrias para o DigiREP;
2. M05_23 - se uma pessoa possuir dois cartes SmartCard, por
exemplo, ser enviado somente o ltimo, pois a Senior implementou
(Kleiton - 11/11/2010) o envio de cartes de forma ordenada,
enviando primeiro os cartes desbloqueados e depois os
bloqueados;
3. Na resposta da autenticao vem o incio e o fim do horrio de vero
e o GMT, assim quando o evento enviado pego este GMT e
enviado, caso esteja no horrio de vero diminuindo 1 do GMT; Ex.
Brasil - GMT = -3 , se estiver no horrio de vero ser enviado -2;
4. O REP est realizando a alterao do PIS, ento o erro 0x8B no tem
mais nenhuma funo a no ser exibir o erro de PIS em uso, caso o
PIS em informado j esteja cadastrado para outra pessoa;
5. Aps receber uma conexo foi inserido um sleep de 10 segundos para
receber a prxima;
6. Quando o Driver recebia um insert / updateperson, era verificado
para quais dispositivos a pessoa deveria ser enviada, e para os
dispositivos que ela no deveria ser enviada, era enviado um
comando de excluso da pessoa. Este comando no mais enviado.
1. Verso inicial do drive como servio;
2. Adicionada algumas informaes no arquivo de propriedades;
3. Colocado um bloqueio para inibir a tentativa de conexo atravs do
boto 'open connection' caso o Driver esteja em modo de auto
conexo;
1.3.19 24/11/2010
1.3.20 13/12/2010
1.3.21 13/12/2010
1.3.22 17/12/2010
1.3.23 22/12/2010
1.3.24 22/12/2010
1.3.25 22/12/2010
1.3.26 26/01/2011
1.4.0 26/01/2011
28/01/2011
1.4.1 31/01/2011
1.4.2 03/02/2011
1.4.3 07/02/2011
1.5.0 16/02/2011
1.5.1 18/02/2011
1.6.0 21/02/2011
1.6.1 23/02/2011
1.7.0 23/02/2011
1.8.0 25/02/2011
01/03/2011
1.8.1 02/03/2011
1.8.2 14/03/2011
1.8.3 14/03/2011
1.8.4 24/05/2011
30/05/2011
1.8.5 16/06/2011
1.8.6 17/06/2011
1.8.7 28/06/2011
1.10.1
2.0.0
At
2.3.8
2.3.9
Identificador | Valor
VB | 1
02/08/2011 1. Removido o reenvio de mensagens caso estoure o time out de
resposta do DigiREP. O Driver definir o rep como off-line caso ele
demore 90 segundos para responder. O driver requisita os eventos
para o rep de 10 em 10 segundos e aguarda a resposta do rep por 90
segundos antes de desistir e fechar a conexo.
09/12/2011 1. Corrigido tratamento da propriedade extensvel COMPATIBILITY,
CT8, para cdigos com 8 (oito) dgitos, o valor CT apenas ficar para
cdigos com 12 (doze) dgitos que j estava sendo tratado.
1. Novo instalador para melhorar e tornar o processo de instalao e
atualizao mais seguro e rpido;
2. Retirado o tratamento de horrio de vero e GMT do controle das
propriedades extensveis, a partir desta verso estes controles
ficaro a cargo de configuraes do Ronda em: Plano de Localizao
Fsica e Cadastro de Dispositivos;
3. Alterado a forma do Driver de enviar dados aos dispositivos, antes
desta verso, por exemplo, precisava tomar decises se enviava ou
no um carto baseado em datas de incio e fim (validades), a partir
desta verso apenas aplica as atualizaes recebidas da CSM para
nos dispositivos indicados;
4. Alterado forma de responder a CSM os comandos, antes aps receber
um comando respondia com sucesso a CSM, agora responde sucesso
apenas aps ter conseguindo executar no dispositivo;
5. Alterado o controle de entrega de eventos de ponto para a CSM, a
partir desta verso o Driver antes de enviar armazena em banco de
dados prprio e tratar como eventos pendentes at que a CSM
responda recebido, desta forma caso a CSM fica parada, quando
reiniciar os eventos sero enviados;
6. Construdo controle para habilitar o ponto pelo teclado, esta
liberao ser feita por dispositivo atravs de propriedade
extensvel;
7. Desenvolvido aplicativo WEB Browser para consultar em tempo real
status dos dispositivos e lista de eventos pendentes;
8. A partir desta verso o Driver possui uma instalao Java prpria,
permitindo no termos mais problemas por atualizaes do servidor;
9. Alterado o controle do armazenamento de logs, o cliente poder
decidir os nveis, indo de todos os tipos a nenhum armazenamento,
sendo que os arquivos sero dirios, podendo ser dividido
dependendo do nvel por dispositivo;
10. Desenvolvido funcionalidade para limpeza do dispositivo aps
receber comando de carga inicial da CSM comandado pelo Ronda
Acesso.
28/03/2012 1. Corrigido erro da converso do NSR que limitava enviar nmeros para
Primeiros passos
de extrema importncia fazer uma completa leitura deste documento para o
entendimento dos processos e funcionalidades.
Adquirir e instalar o DigiREP em conformidade com seus pr-requisitos do manual do
usurio.
Possuir computadores com pr-requisitos listados a seguir neste manual.
Fazer planejamento das atividades que precedem a utilizao propriamente dos sistemas
aqui sendo tratados.
A seguir o Driver faz a abertura do arquivo de configuraes driver.conf que fica gravado
na pasta conf.
10
11
ATENO !!! Quando um DigiREP tenta se conectar ao Driver, a verificao feita atravs
do nmero nico do DigiREP (nmero da MRP), ou seja, para um dispositivo conseguir se
conectar, este tem que ser previamente cadastrado no sistema com o seu nmero de srie
nico co Ronda Acesso, Cadastro do Dispositivo. Este nmero tem um tamanho de 17
(dezessete) caracteres, com a seguinte mscara:
EEEEEMMMMMSSSSSSS, onde:
E Empresa produtora do dispositivo, fixo Digicon = 00013;
M Modelo do equipamento conforme registro no MTE:
00082 BAR Barras e Mifare;
00083 BIO-BM Biometria, Barras e Mifare;
00086 PROX-B Proximidade HID;
00087 BIO-PB Biometria e Proximidade HID;
00088 PROX-A Proximidade INDALA;
00089 PROX-C Proximidade ACURA.
Consultar outros modelos que sero homologados.
S Nmero de srie do Dispositivo com 7 (sete) dgitos.
A seguir a CSM responde a lista de dispositivos A e lista de permisses B.
12
13
Carga inicial
A carga inicial um processo manual, que deve ser realizado pelo administrador do
sistema atravs do Senior Ronda Acesso (Consultar manual do Ronda Acesso).
Quando a carga inicial gerada e enviada pelo Ronda Acesso, antes do Driver enviar os
cadastros para o respectivo dispositivo, executada uma limpeza de registros, removendo
todos os cadastros, cartes e biometrias de colaboradores que o DigiREP possui, aps essa
limpeza os cadastros so enviados um a um para o DigiREP.
Se durante a carga inicial a conexo com o dispositivo, ou at mesmo a conexo com o
Sistema Senior for perdida, a lista deve ser enviada novamente. Importante o Driver no
armazena o que j foi ou no enviado ao dispositivo, por isso deve ser executada de forma
planejada.
Permitir
true
Valores
No Permitir
false
Esta uma informao que enviada para o DigiREP no cadastro do colaborador, logo
para ter efeito, aps a propriedade extensvel ser cadastrada, os colaboradores do respectivo
dispositivo devem ser reenviados para o equipamento, afim de terem seus cadastros
atualizados. Este tipo de informao no contemplado no cadastro do colaborador no Ronda
Acesso, por este motivo inserida atravs de propriedade extensvel no cadastro do
dispositivo.
Envio de eventos
Os eventos gerados (registro de ponto, pouco papel, portal fiscal utilizada, etc.) pelos
DigiREPs e recebidos pelo Driver, no so enviados diretamente para a Concentradora Senior.
Quando o Driver recebe os eventos, primeiramente os guarda em um banco de dados
prprio, a fim de garantir que estes dados no sejam perdidos. Somente aps isso o Driver
responde para o DigiREP que recebeu com sucesso os dados enviados pelo mesmo.
Os eventos ento so enviados para a Concentradora Senior um a um, e somente aps a
Concentradora Senior responder que recebeu com sucesso cada evento, que o Driver o
remove do banco de dados do Driver.
Os eventos no enviados podem ser monitorados pela Console WEB.
14
Descrio
enviado somente o crach para o DigiREP.
enviado o crach e as biometrias para o
DigiREP.
enviado somente as biometrias para o
DigiREP.
15
Site
1. Cadastrar um Site em Projeto Fsico/Site
a. A concentradora enviar para o drive o CNPJ e Razo Social atravs do
cdigo da filial conforme figura A. No cadastro de Filial dever tem uma
com o campo Razo Social que NO poder ser superior a 150 caracteres.
16
17
Driver
3. Cadastrar um Drive em Projeto Fsico/Dispositivo/SDK/Apollo/Drivers
18
Catlogo
4. Cadastrar um Catlogo em Projeto Fsico/Dispositivos/Catlogo
19
Dispositivo
5. Cadastrar os Dispositivos em Projeto Fsico/Dispositivos/Cadastro
20
21
22
23
f.
Leitora
6. Cadastrar uma leitora para o Dispositivo em Projeto Fsico/Dispositivos/Cadastro
24
Instalando o Driver
Obtendo o Driver
As verses do Driver aps testes e homologao pela Senior Sistema de Segurana, so
publicadas no endereo a seguir:
Site: FTP://ftpgd.perto.com.br
Usurio: diginet
Senha: digi.2010
Localizar a pasta CD-Diginet/Driver ou Documentos.
Caso o usurio no tenha um aplicativo cliente de FTP poder utilizar a barra de endereo
do Meu Computador para baixar o Driver e este manual.
25
26
27
Selecione a pasta para agrupamento dos aplicativos no Menu Iniciar, o padro Digicon,
clique em Avanar.
28
Aps seleo Instalar ser iniciado a instalao, sendo como primeiro produto o JRE
(Mquina Virtual Java).
29
Configurando o Driver
Aps clicar no boto Concluir, imagem anterior, a tela a seguir de configurao ser
exibida, so parmetros necessrios para conectividade com a CSM e comportamento do
Driver quanto ao armazenamento de Logs, consulta via WebDriver e tratamento do cdigo de
barras.
30
31
(4) Editar arquivo de propriedades, abrir uma aplicao para editar o arquivo
driver.conf que fica na pasta conf, para aplicar as mudanas feitas deve-se Parar
e Iniciar o Servio, tarefa que pode ser executada de dentro do Editor;
(5) Iniciar Servio,esta ao iniciar o servio do Driver aps alguma manuteno, uma
janela do prompt abrir conforme abaixo;
(6) Instalar Servio, instala o Servio aps er sido Removido com item 10;
(7) Parar Servio, esta ao ir parar o Servio do Driver para manuteno, uma janela do
prompt abrir conforme abaixo;
(8) Remover DigiREP Driver, remove toda instalao do Driver, inclusive as pastas, cuidado
ao executar esta ao, faa cpias de segurana antes;
(9) Remover Servio, ao para remover o Driver do Servio, apenas desinstala o Servio.
32
Na pasta bin estaro todos os aplicativos de execuo do Driver; os arquivos .bat todos
so chamados atravs do Menu Iniciar e seus itens; a partir da verso 2 do Driver, teremos
um servidor HTTP embutido para consultas das operaes e atividades em memria, por isso
temos a pasta webapps e work, que so pastas da publicao do Tomcat, conforme a
seguir.
33
Na pasta icons esto dispostos os cones das aplicaes criadas no Menu Iniciar.
34
A partir da verso 2 o instalador criar uma ambiente exclusivo do Java para o Driver,
desta forma atravs do arquivo wrapper.conf ser direcionado esta execuo, evitando
assim problemas com instalaes defaults que podem sofrer atualizaes constantes.
35
Acessando a console
Objetivando oferecer mais informaes e em tempo real, foi desenvolvido um aplicativo
com interface WEB.
Esta console WEB poder ser acessada via browser do endereo: HTTP://localhost:8384.
A seguir sero apresentadas e explicadas as telas desta console.
Sobre o Driver
Nesta guia so apresentadas as informaes do Driver.
36
37
Status
0
1
Descrio
Evento pronto para ser enviado para a Concentradora Senior.
Evento enviado para a Concentradora Senior, aguardando confirmao de
recebimento da concentradora para ser removido do banco de dados do Driver,
considerar que fazem menos de 3 minutos que foi enviado, caso seja passados os 3
minutos este evento ser reenviado.
Evento enviado para a Concentradora Senior, aguardando confirmao de
recebimento da concentradora para ser removido.
38
Funes de Administrador
Para ter acesso as funes apresentadas nos prximos tpicos ser necessrio realizar o
login como Administrador, atravs do cone exibido na imagem parte superior, conforme
assinalado na figura a baixo.
O propsito desta seo o fornecimento de informaes para facilitar a homologao na
Senior e consulta do ambiente interno do Driver que esta sendo executado.
Nesta seo em Ferramentas tambm possvel:
1-Recuperar biometrias coletadas diretamente no dispositivo e que por algum motivo no
foram enviadas e
2-Recuperar os ltimos 256 K (aproximadamente 15.000) de eventos de marcaes de
ponto e de monitoramento, atravs de uma cpia circular que o firmware mantm
internamente em cada dispositivos.
Usurio: admin
Senha: d1g1c0n@
39
40
Eventos de Monitoramento
Eventos gerados pelo dispositivo, coletados pelo Driver e tratados como monitoramento
no Ronda Acesso.
41
Processos Internos
42
Timers Internos
43
Ferramentas
Ferramentas de manuteno, estas devero ser executadas em extrema necessidade.
44
Atualizando o Driver
A atualizao do Driver executada da mesma forma que uma Instalao Normal, o
instalador ir parar o Servio e baixar os novos arquivos.
ATENO !!! Na atualizao no necessrio informar o diretrio de instalao do Driver,
pois o prprio instalador identifica o diretrio onde est instalado e atualiza os arquivos neste
diretrio.
ATENO !!! Apenas na primeira atualizao do Driver 1 para o 2, orientamos as seguintes
tarefas:
1-Escolha um horrio que no haja movimentao de eventos de ponto e monitoramento,
evitando que sejam perdidos alguns eventos, pois estaremos parando o Driver e este pode ser
que esteja em atividade com a CSM;
2-Para o Driver atravs do Painel de Controle do Windows;
3-Faa cpia de segurana da pasta do Driver;
4-Remova o servio atual do Driver utilizando o arquivo .../Bin/Uninstalldriver-repNT.bat;
5-Faa instalao do novo Driver atravs do captulo Instalando o Driver;
6-Caso tenha alguma dvida sobre a lista dos colaboradores presentes em cada dispositivo
poder refaz-la atravs de nova opo do Ronda Acesso de enviar carga inicial, muito cuidado
pois esta nova funcionalidade remover todos os colaboradores e reenviar, dever ser
utilizada para casos suspeitos de muitos demitidos que no foram removidos.
45
Removendo o Driver
ATENO !!! Esta operao desinstala o Servio assim como remove todas as pastas e
arquivos da instalao, tenha certeza que NO precisar dos contedos, se NO tiver esta
certeza, faa cpia de segurana.
Estando certo da operao, acesse o Menu Iniciar em Arquivos de Programas, na pasta
Digicon, DigiREP Driver e escolha a opo 9, conforme figura abaixo:
46
47
Data
Descrio
03/03/2011 Criao deste documento com base no Manual de Instalao e
Operao do Diginet 1.6.
1.8
1.9
2.0
2.1
2.2
2.3
48
Glossrio
49