Configuraes REPs

Homologados

Sumrio
Parte I

Roteiro para Configurao de

REPs

1.1 Instrues...................................................................................................................................
de Configurao para REPs
3
1.2 Instalando...................................................................................................................................
ApAccessServer
6
1.3 Objeto 2372
...................................................................................................................................
- Equalizao da Base de Dados - REPs
11
1.4 Objeto 2419
...................................................................................................................................
- Manuteno dos Dados nos REPs
12
1.5 Objeto 4461
...................................................................................................................................
- Execuo de Comandos nos Dispositivos
13
1.6 Recomendaes
...................................................................................................................................
Apdata - ApAccessServer x Dispositivos.
15

Roteiro para Configurao de REPs

1.1

Instrues de Configurao para REPs

Este documento tem como objetivo auxiliar a configurao do sistema Global Antares para que o
mesmo faa a comunicao com REPs.
1 Primeiro Passo:
Cadastrar o servidor de acesso no objeto 4431 conforme figura abaixo.

O Servidor de Acesso um servidor dos dispositivos, porm diante do ApServer tem o

comportamento de um Client como o Aptools ou ApUsers, onde so solicitadas consultas para
serem repassadas aos dispositivos.

2 Segundo Passo:
No objeto 4433 cadastrar o canal de comunicao que ser utilizado para efetuar comunicao
com os dispositivos, conforme exemplos abaixo.
Quando os dispositivos possuem comunicao TCP/IP devero ser preenchidos os campos abaixo:
Nmero do Canal: Este campo deve ser preenchido com o mesmo nmero do ID, gerado pelo

sistema;
Id Tipo de Canal de Comunicao: Cadastrar neste campo qual canal ser utilizado, no caso dos
REPs esse valor deve ser 2 (dois) TCP;

3 Terceiro Passo:
No objeto 4434 associar os canais de comunicaes ao servidor de acesso, essa associao
necessria para informar quais dispositivos de acessos o ApAccessServer ir controlar.
Exemplo de associao Servidor x Canais de Comunicaes:

4 Quarto Passo:
No objeto 3909 - Dispositivos de Acessos cadastrar os dispositivos, preenchendo os campos
mencionados abaixo.

Id Tipo de Dispositivo de Acesso: Cadastrar neste campo o tipo de dispositivo, neste caso um
Relgio;
Id Controlador de Dispositivo de Acesso: Cadastrar neste campo o driver de comunicao que
ser utilizado.
Id Localizao de Acesso - Entrada: Cadastrar a localizao a qual pertence o dispositivo;
Id Localizao de Acesso - Sada: Cadastrar a localizao a qual pertence o dispositivo;
Cdigo Interno do Dispositivo: Cadastrar o cdigo do dispositivo;
Id Tipo de Identificao de Acesso: Cadastrar neste campo qual ser o tipo de identificao
utilizado (Crach, Biometrico, etc.);
Id Tipo de Uso do Dispositivo: Para os dispositivos REP cadastrar com 1 Somente Ponto;
Endereo IP: Cadastrar neste campo o endereo IP do dispositivo;
Id Servidor de Acesso x Canal de Comunicao: Neste Campo selecionar o canal de
comunicao;
Nmero Porta TCP: Cadastrar neste campo o nmero da porta TCP utilizada pelo dispositivo.
Para REPs Trix utilizar a porta 2101.

1.2

Instalando ApAccessServer
Para efetuar a instalao do ApAccessServer seguir o procedimento descrito abaixo:
1 Primeiro Passo
Criar um atalho para o ApAccessServer dentro do prprio diretrio.

2 Segundo Passo
Editar o atalho e ao final da linha de comando acrescentar
<Espao><Nome Instncia><Espao></(barra)><Start></(barra)><LogErrors>
Conforme exemplo abaixo:

3 Terceiro Passo
Executar o atalho e configurar o ApAccessServer.
Ao executar o atalho ser exibida a seguinte tela.
Na pasta "ApServer Settings" devem ser informados os dados do ApServer, conforme descrito
abaixo.

Server IP: Informar o endereo TCP/IP do ApServer;

Port: Informar o nmero da porta TCP do ApServer;
Area Name: Informar o nome do Servidor (Instncia).
Na pasta "Access Server Settings" devem ser informados os dados do servidor de acesso.

Access Server ID: Informar o cdigo do servidor de acesso, cadastrado no objeto 4431;
Port: Informar a porta TCP do servidor de acesso, cadastrada no objeto 4431.
Aps confirmar as informaes ser gerado um arquivo ApAccessServer.ini dentro do diretrio do
ApAccessServer.
Neste arquivo constam as seguintes informaes.
[SERVER SETTINGS]
SERVER IP = 127.0.0.1 (Endereo TCP/IP ApServer);
SERVER PORT = 7000 (Nmero Porta TCP ApServer);
AREANAME = AreaName_1 (Nome Servidor ApServer);
USER SERVICE =
PASSWORD SERVICE =

ACCESS SERVER ID = 9 (Cdigo do ApAccessServer);

ACCESS SERVER PORT = 7050 (Nmero da porta TCP do ApAccessServer);
TEMPO MARCACOES = 5 (Tempo, em milisegundos de verificaes de marcaes (exclusivo
Telemtica));
TEMPO SEM COMUNICACAO = 600 (Tempo, em milisegundos de espera de resposta do ApServer);
POOL SIZE = 400 (Limite de Threads executadas pelo ApAccessServer);
CHECAGEM CRACHA = 0 (Opo para fazer validao de dgitos do crach (exclusivo DIMEP));
HABILITA TECLADO = 0 (Opo para fazer validao de dgitos do crach (exclusivo TopData));
GRAVA MARCACAO OFFLINE = 0 (Opo para Gravar as marcaes offline);
PROCESSA REJEITADAS = 1 (Opo para iniciar o processo de processamento automtico no final
do envio das marcaes ao ApServer);
CALC POOL SIZE = 0 (Define a quantidade de calculo alocado na memria do ApServer para
compartilhamento para grupo de calculo.);
TEMPO POLL MARCACOES = 15 (Tempo em segundos de espera para a verificao de marcaes
nos REPs);
[ONLINE SETTINGS]
BANNER = (Mensagem para ser exbida no display do dispositivo);
MENSAGEM NACK = (Mensagem para ser exbida no display do dispositivo quando no houver
resposta do mesmo(exclusivo TRIX));
MENSAGEM OFFLINE = (Mensagem para ser exbida no display do dispositivo quando estiver offline (exclusivo TRIX));
DIGITOS CARTAO = 16 (Quantidade de digitos que ser lido pelo dispositivo);
[OFFLINE SETTINGS]
TEMPO RELE CATRACA 1 = 2000 (Tempo, em milisegundos de acionamento de rel para quando
o equipamento ficar off-line);
TEMPO RELE CATRACA 2 = 2000 (Tempo, em milisegundos de acionamento de rel para quando
o equipamento ficar off-line);
Aps a configurao do arquivo ApAccessServer.ini para instalar o aplicativo como servio o
atalho deve ser editado novamente e depois do nome da instncia deve ser informado
</(barra)><install>, conforme figura abaixo:

4 Terceiro Passo
Para os dispositivos dos fabricantes Dimeo e Rodbel deve ser copiada as DLLs da pasta
...\Server\Access\DLLs\Nome do Fabricante para a pasta ...\Server\Access\Bin.
Aps copiar as DLLs deve se registar a DLL WatchComm.
Obs.: Se a DLL WatchComm for atualizada a mesma deve ser registrada novamente.
Para dispositivos do fabricante Henry deve executar o instalador Kernel7x_v7.2.0.29.exe da
pasta ...\Server\Access\DLLs\Henry aps a instalao copiar o arquivo Kernel7x.dll para a pasta
...\windows\system32

10

10

1.3

Objeto 2372 - Equalizao da Base de Dados - REPs

Na execuo do Processo o sistema verifica os dispositivos do tipo REP, o Agrupamento de
Localizao de Acesso e os Grupos de Localizaes por Contratado e popula a tabela
SincronizaesREPs com as informaes encontradas. A tabela SincronizacoesREPs um
espelhamento da memria interna do REP para controle das informaes enviadas e das
alteraes a serem enviadas ao REP.
Neste processo o sistema verifica as informaes encontradas no contratado e compara com as
informaes da tabela SincronizacoesREPs e realiza uma das aes abaixo:
Se as informaes forem as mesmas no so geradas aes.
Se as informaes forem diferentes atualizado na tabela SincronizacoesREPs alterando o
Status para pendente.
Se as informaes no forem encontradas na SincronizacoesREPs, as mesma so inseridas.
Se as informaes no forem encontradas na Base de Dados, a mesma alterado o tipo de
comando para Excluir e o Status para pendente.
Se o campo Registro Fixo estiver marcado nenhuma ao realizada sobre este registro,
considerando assim a alterao do Usurio.

Caso no momento da execuo do processo seja apresentado uma tela informando que existem
registros pendentes, isso significa que existe contratados que forma equalizados mas que no
foram enviados para o equipamento.
Nestes casos, execute o objeto 4461 - Execuo de Comandos nos Dispositivos utilizando o
comando 96 Envia Informaes dos Contratados.
Obs.: Abaixo temos um tpico sobre o objeto 4461 - Execuo de Comandos nos Dispositivos.
So disponibilizados no processo os campos:
Id Dispositivo de Acesso: Deve ser informado o dispositivo a ser equalizado, se o mesmo for

11

11

omitido sero sincronizados todos os REPs do sistema.

Despreza Registros Pendentes: Verifica se possui registros pendentes na tabela
SincronizacoesREPs, se possuir apresenta mensagem de Erro alertando o Usurio da necessidade
de envio das informaes aos REPs. Se o mesmo for marcado no ir realizar tal verificao, com
isso as informaes so alteradas indiferentemente do status.

1.4

Objeto 2419 - Manuteno dos Dados nos REPs

Este Objeto tem a funcionalidade de manipular as informaes da tabela SincronizacoesREPs de
forma manual. Neste objeto o usurio pode incluir, alterar e excluir registros para envio ao REP.
Ao selecionar o dispositivo no Treeview so exibido os registros, no qual o usurio pode alterar
de forma manual os campos "Tipo de Comando para Envio ao REP", "Numero do PIS", "Cdigo do
Crach-Base" e "Nome". Possui ainda o campo "Considerar Registro Fixo na Sincronizao", se
este for marcado o registro no ser alterado pelo processo de sincronizao.
Ao efetuar uma alterao ou incluso so atualizados os campos abaixo:
Id Status de Sincronizao do REP: Alterado para 1 - Pendente;
Data/Hora de Status da Sincronizao do REP: Alterado para data e hora da modificao;
Id Tipo de Origem do Movimento: Alterado para 2 - Manual.

12

12

1.5

Objeto 4461 - Execuo de Comandos nos Dispositivos

Tem por finalidade permitir o envio de comandos para os REPs. Esto disponiveis aos REPs os
comandos abaixo:
18 - Carga de Data e Hora no CODIN
Envia a Data e Hora do Servidor de Acesso ao REP.
95 - Envia Informaes da Empresa
Envia os dados da empresa ao REPs, utilizado para REPs TRIX e Henry.
So enviados os campos abaixo:
CNPJ:

EMP_NusCNPJPrefixo
LOC_NusCNPJSufixo

CEI:

LOC_NusMatriculaCEI

Endereo:

TEN_D1sTipoEndereco,
LOC_DssEnderecoBase,
LOC_DssEnderecoNumero,
LOC_DssEnderecoComplto,
LOC_DssBairro,
LOC_DssMunicipio,
EST_CdsSiglaEstado

96 - Envia Informaes dos Contratados

Envia as informaes Pendentes da tabela SincronizacoesREPs ao REP, essas informaes so
enviadas uma a uma e aps o envio atualizado o Status da mesma, para controle dos
contratados enviados.
93 - Recolher Biometria
Recolhe as biometrias do dispositivo para o sistema.
Para REPs TRIX e Henry, se o campo "Parmetro do Comando" for informado com o ID do
contratado recolhida somente a biometria do mesmo, se o parmetro no for informado so
recolhidas todas as biometrias dos contratados que se encontram cadastradas na tabela
SincronizaesREPs com o campo Biometria Enviada desmarcado para o dispositivo.
Para REPs Dimep e Rodbel, o campo "Parmetro do Comando" no deve ser informado, pois o
dispositivo envia todas as biometrias novas do dispositivo e so gravadas na base de dados desde
que o contratado esteja cadastrado na tabela SincronizacoesREPs.
98 - Envia Biometria
Envia as biometrias da base de dados ao REP, sero enviadas as biometrias dos contratados da
tabela SincronizaesREPs que no possuem as biometrias enviadas.
Se for preenchido o campo 'Parmetro do Comando' com o ID do Contratado, ser enviada
somente a biometria do contratado informado.
88 - Apagar Biometria

13

13

Apaga as biometrias no dispositivo, se no campo "Parmetro do Comando" for informado com o

ID do contratado apagada somente a biometria do mesmo, se o parmetro no for informado
so apagadas as biometrias dos contratados que possuem o campo Biometria Enviada marcado na
tabela SincronizacoesREPs.
90 - Recolher Marcaes Off-Line
Para REPs Henry o recolhimento feito atravs do arquivo AFD. O sistema gera o arquivo AFD na
workin do usurio que est executando o processo, o arquivo j gerado no workin para facilitar
o processo de importao do arquivo atravs do objeto 2585 - Processo de Importao de
Arquivo AFD.
O arquivo gerado com o nome AFD Id do dispositivo _ data e hora do recolhimento (Ex.
AFD8007_20110729144403950.txt).
99 - Status do Papel no REP
Ao executar este comando ser solicitado as informaes sobre o papel no REP, est informao
estar disponivel no objeto 3909 - Dispositivos no campo 'Id Status do Papel no REP' e no campo
'Data/Hora do Status do Papel' ir informar a data e hora em que foi recebida a ultima
informao de Status do Papel.
Obs.: Verificar com o fabricante do REP se o mesmo possui a opo de Status do Papel.
58 - Carga de Horrio de Vero
Para dispositivos REPs Dimep e Rodbel este comando envia a programao de incio e termino do
horario de vero.
Ser necessrio a criao do arquivo texto conforme abaixo, no diretrio Workin do usurio com
o seguinte conteudo:
Data Inicio e data fim do horrio de vero no formato DDMMAADDMMAA
Exemplo: Se o horario de vero comear em 16/10/2011 e terminar em 26/02/2012 o conteudo
do arquivo deve ser:
161011260212
A virada do horrio de vero ocorre de um sbado para o domingo, as datas inicio e fim devem
ser o dia de domingo.
No campo "Parmetro do Comando" deve ser preenchido com o nome do arquivo criado.
Nota: Em caso dos comandos no estarem surtindo efeito no equipamento, deve-se verificar a
tabela LancamentosComandos.
Nesta tabela ira conter o comando que foi executado.
Verifique o campo LCM_OplFinalizado, caso esteja como 1, foi enviado ao dispositivo, caso
esteja como 0, ocorreu algum erro e no pode ser enviado. Neste caso verifique qual tipo de
erro que ocorreu atravs do campo LCM_CdiErroInternoAcesso.
Segue abaixo os tipos de erros que podem ser registrados neste campo:
0 - Nenhum
1 - Jornada No Encontrada
2 - Grade No Encontrada
3 - Desconhecido

14

14

Caso o comando esteja com o campo LCM_OplFinalizado como 1 e mesmo assim o comando no
surtiu efeito, deve-se verificar o Log do ApAccessServer, pois pode estar ocorrendo algum erro
no envio do comando.

1.6

Recomendaes Apdata - ApAccessServer x Dispositivos.

Segue abaixo a recomendao feita pela Apdata referente a quantidade de dispositivos que
devem ser vinculados a um Servidor de Acesso (ApAccessServer).
Essa recomendao ser dividida em modelos de dispositivos, pois a quantidade pode variar para
cada dispositivo.
1 Para Dispositivos OnLine modelos Dimep, Rodbel e Trix (catraca, relgio, etc.):
Para esses equipamentos a Apdata aconselha que seja vinculado no mximo 15
dispositivos por Servidor de Acesso.
2 Para Dispositivos OnLine modelos Telemtica (catraca, relgio, etc.):
Para esse equipamento no temos limitao, pode ser vinculados quantos dispositivos
forem necessrios.
Vale lembrar que para este tipo de dispositivo, fazemos comunicao direta com banco de dados
e com isso caso seja distribudo em diversos Servidores de Acesso pode ocorrer problema de
lentido devido a duplicar as informaes na tabela AcessosPendentes.
3 Para dispositivos REP (offline) Trix, Dimep e Rodbel:
Para esses equipamentos a Apdata aconselha que seja vinculado no mximo 100
dispositivos por Servidor de Acesso.
4 Para Dispositivo REP (offline) Telemtica:
Para esse equipamento no temos limitao, pode ser vinculados quantos dispositivos
forem necessrios.
Vale lembrar que para este tipo de dispositivo, fazemos comunicao direta com banco de dados
e com isso caso seja distribudo em diversos Servidores de Acesso pode ocorrer problema de
lentido devido a duplicar as informaes na tabela AcessosPendentes.
Em se tratando de REP, qualquer modelo, a Apdata aconselha que seja criado um canal de
comunicao para cada dispositivo, evitando assim que seja criado uma fila de comandos a
serem enviados ao equipamento.
Outra informao importante que no caso da empresa possuir equipamentos REP e
equipamentos OnLine, deve ser criado um Servidor de Acesso para cada um, ou seja, um Servidor
para REP e outro Servidor para equipamentos OnLine.

15

15