Config. do módulo MSA com dispositivos REP. 23/05/2011
Config. do módulo MSA com disp. REP. Sumário Sumário... 2 1 Configurando os novos serviços para os REP... 3 1.1 Configurando o devices.xml... 3 1.2 Instalando o serviço... 4 1.3 Configurando o recebimento de comandos remotos... 4 1.4 Parametrização da integração com o ponto eletrônico.... 5 2 Parâmetro de configuração dos REP... 6 2.1 Parametrização da integração com o ponto eletrônico.... 6 2.2 Parâmetros REP Telematica... 7 2.2.1 Aba Telemática REP... 7 2.2.2 Aba Telemática... 8 3 Envio de comandos remotos para integrações com REP... 9 3.1 Envio de data/hora... 9 3.2 Envio de dados empregador... 9 3.3 Envio da lista de funcionários... 10 4 Plano de ação envio de lista... 11 4.1 Plano de teste Henry ORION 6... 11 4.1.1 Alterando o devices.xml... 11 4.1.2 Garantia de Sucesso no recebimento da lista.... 12 4.1.3 Garantia de Sucesso no envio da lista... 13 2 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. 1 Configurando os novos serviços para os REP O serviço de integração para os dispositivos da portaria 1510 devem rodar separado do serviço de integração dos dispositivos de acesso convencionais. Para isto deve-se criar um novo diretório de integração com o pacote Java server chamando-o de server-ponto na estrutura prghur\sap\java (conforme figura abaixo). Apenas as versões 2.5.1 ou superiores da integração é que estão preparadas para comunicação com os REP. 1.1 Configurando o devices.xml O arquivo devices.xml serve para dizer a integração qual tipo de dispositivo ela irá se comunicar e quais são esses dispositivos. O arquivo devices.xml esta localizado na pasta /conf. Dentro da pasta /conf possuímos diversos modelos de devices.xml, um para cada integração. O cliente deverá identificar o modelo referente ao seu dispositivo de REP e renomea-lo para devices.xml. Modelos de devices.xml referentes a relógio REP: - devices-dimep-printpointii.xml - devices-telematica-rep.xml - devices-henry-orion-6.xml Config. Do módulo MSA com disp. REP 3
Config. do módulo MSA com disp. REP. Após esse procedimento o arquivo deve ser editado, incluindo tags <divece> para tantos forem os relógios REP cadastrados no SA0620. Lembrando que após cadastro no SA0620 o dispositivo deve ser vinculado ao seu relógio ponto PE0620 correspondente. <device> <devicenumber>1</devicenumber> <deviceport>3000</deviceport> </device> <device> <devicenumber>2</devicenumber> <deviceport>3000</deviceport> </device> (...) O numero que vai na tag <devicenumber> é o numero cadastrado no campo identificação do SA0620. 1.2 Instalando o serviço Para instalar o serviço do REP, deve-se editar e executar o arquivo server-ponto/bin/javaservicesinstall.bat. Demais duvidas referentes à criação e parametrização do serviço deve ser consultada em: Server-ponto/doc/Manual_tecnico_de_instalacao_MSA.pdf. 1.3 Configurando o recebimento de comandos remotos Para que sejam enviados comandos externos para a integração, como: lista de funcionários, dados do empregador, atualização de data/hora, etc. Deve-se parametrizar na aba Controle Acesso Servidor do /Server-ponto/_ui-config.bat, qual é o servidor que está rodando o serviço do controle de acesso dos REP e em qual porta a integração vai abrir para recebimento desses comandos. Lembrando que sempre que algum parâmetro é alterado no _ui-config.bat, o serviço do controle de acesso deve ser reiniciado. 4 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. 1.4 Parametrização da integração com o ponto eletrônico. Essa parametrização diz respeito à configuração da aba Serviço Ponto do.../server-ponto/_ui-config.bat e somente deverá ser habilitado em apenas um serviço do controle de acesso. Exemplo: uma determinada empresa está implantado relógios de REP, porem, ela também possui outros dispositivos de acesso, sendo que o serviço do ponto está parametrizado nele. Então, para esse caso, não deverá ser configurado o serviço de ponto no _ui-config.bat do serviço de integração com os REP. As instruções de como configurar essa aba, estão no tópico 2.1.2 do manual técnico do controle de Acesso, localizado em:.../server-ponto/doc/manual_tecnico_de_instalacao_msa.pdf. Config. Do módulo MSA com disp. REP 5
Config. do módulo MSA com disp. REP. 2 Parâmetro de configuração dos REP Existem algumas configurações globais e especificas de cada fabricante para a integração com os equipamentos na forma on-line. Para ter acesso a essas configurações deve-se executar o arquivo server-ponto/_ui-config.bat. 2.1 Parametrização da integração com o ponto eletrônico. As parametrizações efetuadas aqui servem para todas as integrações (Henry, Dimep, Telemática). Após executar o _ui-config.bat, irá abrir uma tela de configuração. Localize a aba Portaria 1510 e execute as parametrizações necessárias, conforme orientações na imagem abaixo. 6 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. Hora Sincronização Funcionários/Digitais: Horário que é efetuado a sincronização de funcionário e digitais. Em outras palavras é enviada para o REP a diferença do que está na sua memória (AFD) com o que está no ERP (HCM). Intervalo (minutos) Sincronização marcações: Intervalo em minutos da próxima coleta de marcações. Intervalos não Atualizar Marcações: Intervalos onde não ocorrerá coleta de marcações de ponto no REP. Caminho Temporário AFD*: Diretório onde será salvo o arquivo AFD gerado pela API Henry. * Atualmente é necessário apenas para os REP do Fabricante Henry. Dispositivo Repositório Digital: Dispositivo pelo qual é utilizado para cadastro de digitais. 2.2 Parâmetros REP Telematica Os parâmetros abaixo servem apenas para clientes que queiram efetuar integração com REP do fabricante Telemática. 2.2.1 Aba Telemática REP Config. Do módulo MSA com disp. REP 7
Config. do módulo MSA com disp. REP. Baixa Automática Marcações: Caso marcado não irá envia o comando para o conexrep para coleta de AFD (marcações). Esse processo será feito pelo próprio conexrep, cuja sua parametrização deve ser vista com o fornecedor. Se esse parâmetro for marcado, as configurações intervalo (minutos) Sincronização marcações e Intervalos não Atualizar Marcações do tópico 3.1 não serão considerados. Sugerimos que esse parâmetro seja marcado e que a coleta do AFD (marcações) seja gerenciada pelo conexrep. 2.2.2 Aba Telemática Na aba Telemática, alem das informações de banco de dados, deve-se inserir o diretório raiz do conexrep. É nesse diretório que a integração irá gravar os arquivos texto que o conexrep irá ler, para executar os demais comandos (inclusão/eliminação). 8 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. 3 Envio de comandos remotos para integrações com REP Para configurar os dispositivos REP, precisarão ser enviados alguns comandos a integração do controle de acesso, para que a mesmaatualize no dispositivo: Envio de data/hora, envio de dados do empregador (CNPJ e endereço) e envio de lista branca. 3.1 Envio de data/hora Para configurar os relógios REP, a primeira coisa que deve ser feita é a atualização de data/hora. Essa atualização ocorre automaticamente no momento que o serviço é reiniciado. O envio de data/hora também poderá ser feito manualmente, para isso, deverá ser executado o bat.../server-ponto/_uicomandos.bat. Irá abrir uma janela conforme a imagem ao lado. Basta selecionar o numero do dispositivo que deseja atualizar a data/hora e o comando especifico, nesse caso Atualização Data/Hora, em seguida clicar em ok. 3.2 Envio de dados empregador O envio de dados do empregador irá atualizar no relógio os dados de CNPJ e endereço físico desse relógio. Essas informações são coletadas do estabelecimento que o local de marcação cadastrado no PE0620 está. Para enviar os dados do empregador ao REP, o procedimento é o mesmo do item 4.1, bastando apenas alterar na janela de execução de processos remotos o comando para Envio dados empregador. Config. Do módulo MSA com disp. REP 9
Config. do módulo MSA com disp. REP. 3.3 Envio da lista de funcionários O envio da lista de funcionários irá atualizar nos relógios os funcionários ativos no FP1500 e no SA1500 e que batem ponto (PE1700). Esse procedimento manual, precisa ser feito apenas no momento da implantação do novo REP, já que, após isso, diariamente em um horário pré-definido o sistema irá efetuar a sincronização da lista de funcionários, incluindo e excluindo. Veja o tópico 3.1 para maiores detalhes. Para enviar a lista o procedimento é o mesmo descrito no item 4.1, bastando apenas alterar na janela de execução de processos remotos o comando para Envio dados Lista. Aconselha-se o acompanhamento do log server-ponto/log/server_log.txt para verificar se o envio de lista ocorreu corretamente. É sabido que o tempo de conclusão do envio de lista para REP dos fabricantes Telemática e Dimep para cerca de 800 funcionários leva em média 10 minutos, já para o REP do fabricante Henry, esse tempo é de 3 horas. 10 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. 4 Plano de ação envio de lista Abaixo segue planos de ações para o acompanhamento do processo de envio de lista, e assim, saber se o mesmo executou com sucesso. 4.1 Plano de teste Henry ORION 6 O plano sugerido de teste para Henry leva como base versões acima de sua API 16 (server-ponto/lib/henrygenrenciado16.jar). Essa API irá criar um XML para cada dispositivo contendo no mesmo um espelho dos PIS x crachás que se encontram dentro do REP. Com isso, sempre que um funcionário é incluído/alterado/excluído no REP ele também será incluído/alterado/excluído desse XML (cache). De tal forma que esse XML será um espelho da memória do REP no que tange os PIS x crachás que estão ativos lá dentro. 4.1.1 Alterando o devices.xml Para o teste sugerimos iniciar com apenas 4 dispositivos, os demais serão colocados gradualmente. Dessa forma, o conf/devices.xml deverá ser alterado para que no mesmo, contenha apenas os 4 REP. Config. Do módulo MSA com disp. REP 11
Config. do módulo MSA com disp. REP. 4.1.2 Garantia de Sucesso no recebimento da lista. Após enviar o comando de envio de lista (tópico 3.3), irá aparecer no log a tag TlistenerSenser: 056, onde 056 será o código do REP cadastrado no devices.xml. Em seguida e na mesma linha dessa tag irá imprimir RequestEmployee, significando que a lista está sendo requisitada do REP. Esse processo de recebimento da lista poderá demorar em média de 10 a 50 minutos. Quando a lista for recebida, a integração irá imprimir comando executado com sucesso, para saber de qual dispositivo basta verificar a tag devicenumber. A classe que aparece no começo da linha orion6.command.commandsourcerequestemployees significa que o retorno recebido foi de um comando de recebimento de lista. Caso o retorno do comando retorne falha, existe algum problema no REP que deve ser verificado com pelo fabricante. Após o recebimento do comando com sucesso irá imprimir o total de funcionários que está dentro do dispositivo e o total de funcionários do ERP. Essa diferença será incluída/excluída do REP já em seguida. Antes disso a API da Henry irá criar na pasta server-ponto uma pasta chamada cache, onde ali dentro ira criar os XML referente a cada REP que teve o seu recebimento de lista OK. Assim na próxima vez que for enviado o comando de envio de lista para o dispositivo, a API da Henry não irá mais buscar a lista de funcionários ativos do relógio e sim diretamente desse XML, fazendo com que esse processo de recebimento de lista leve apenas alguns segundos. 12 Config. Do módulo MSA com disp. REP
Conf. Do módulo MSA com disp. REP. 4.1.3 Garantia de Sucesso no envio da lista. Para se certificar que a lista foi enviada completa para o REP, após toda a inclusão/exclusão irá aparecer a mensagem henry.orion6.henrylistenersender -> TlistenerSender:055 - Fim do comando envio de funcionários. Se no processo de inserção e exclusão acontecer alguma falha a mesma deve ser reportada para Henry, pois o relógio poderá ter algum problema. Para se certificar que todo o processo de envio de lista ocorreu com sucesso, envie novamente a lista para o REP (3.3), ele deve retornar agora que o total de funcionários do dispositivo é o mesmo presente no ERP. Sendo assim, o total de usuários a serem adicionados/removidos será 0. Config. Do módulo MSA com disp. REP 13