Serviço Exportador de Batidas GladiusREP -> TOTVS Chronus Manual de Instalação 1
Introdução A geração de marcações no Chronus faz parte do sistema GladiusREP e foi homologada pelo setor de customização da TOTVS. Ela permite com que todas as marcações recolhidas através de equipamentos de REP (Relógio Eletrônico de Ponto), sejam lançadas na folha sem que haja uma intervenção manual. Este lançamento é realizado por uma API (conjunto de funções) oferecidas pelo sistema TOTVS o Gladius realiza uma solicitação informando a Data/Hora e PIS do funcionário, então a API do Chronus registra a marcação no sistema. Isso é feito de maneira automática, através de um Serviço instalado no Windows. Ele fica constantemente buscando todas as pendências e solicitando o lançamento na Folha. Pré-Requisitos É necessário que o computador que ira rodar o serviço tenha: -.NET Framework 4.0. - TOTVS Chronus 11.50 ou superior - Dois usuários criados no Chronus: Um para lançamento das batidas de período atual e outro para lançamento de período futuro. Configurações Para que o Serviço consiga lançar as marcações no Chronus ele irá precisar saber de onde as marcações são recolhidas (onde está o banco GladiusREP podendo ser, inclusive, mais de um banco de dados) e onde as marcações serão lançadas (Chronus). Além disso, é necessário que no Chronus, sejam criados dois usuários específicos para uso do serviço. Um usuário será usado para lançar as batidas do Período que estiver aberto no Chronus e o outro será para o período futuro. Sendo assim, torna-se necessário que estes dois usuários sejam criados. E que o segundo usuário seja configurado para trabalhar com o Próximo Período. Para isso, basta estar logado no Chronus com o usuário criado para o próximo período, ir no menu Opções > Parametros do Usuário e marcar a Flag que define próximo período. 2
Exemplo de Estrutura Configurando a ligação com o Chronus O serviço precisa saber onde os dados serão lançados, e também através de que usuário isso será feito (as funções da TOTVS sempre exigem que haja um usuário). Para isso, configuramos um arquivo chamado Gladius_Para_Rm.Ini dentro da pasta c:\gladiusacesso. O arquivo pode ser criado em um editor de textos e deve contar a seguinte estrutura (exemplo): Usuario = GladiusLanca1 Senha = Lanca1 UsuarioProximoPeriodo = GladiusLanca2 SenhaProximoPeriodo = Lanca2 Alias = CorporeRM Intervalo = 1 MaximoTentativas = 10 Descrição dos campos: 3 Usuario e Senha Se refere a um usuário comum do Chronus.
UsuarioProximoPeriodo e SenhaProximoPeriodo Se refere ao usuário (e sua senha) em que o Chronus esta configurado para trabalhar com o próximo período. O serviço usa isso para gravar marcações do período ainda não aberto. Alias É o apelido usado para conexão com o Banco de Dados definido dentro do Chronus. Ele pode ser consultado no arquivo: \totvs\corporerm\rm.net\alias.dat no campo <Alias> Intervalo e MaximoTentativas Se refere ao intervalo de tempo em que o serviço para ou fica rodando, além disso, se Refere a quantas tentativas o sistema faz quando há problema na marcação de alguma Batida, é bom deixar o valor 1 no primeiro e 10 no segundo. Configurando a ligação com os arquivos GladiusREP Para que o serviço possa saber de onde vem os dados a serem lançados é necessário que sejam configurados arquivos que o informem. Os dados sempre vem de bases de dados utilizadas pelo GladiusREP. O serviço pode trabalhar com mais de uma base de dados origem ao mesmo tempo. O nome do arquivo de configuração de uma base origem é CONEXAO_REPx.INI, onde o x representa o número da conexão. A melhor forma de criar um arquivo de configuração é simplesmente copiar o arquivos GladiusREP.Ini que fica no micro onde o Serviço Gladius REP esta rodando (ServicoMP) e depois renomear a cópia para conexão desejada. Exemplo: Eu posso copiar o GladiusREP.ini que fica na pasta c:\gladiusacesso (do servidor onde roda o ServicoMP) para CONEXAO_REP1.ini. Assim o gerador de batidas saberá que aquele arquivo configura a origem dos dados. 4
Instalando o Serviço 1) Para instalar o serviço, execute o programa SETUP que fica na basta de instalação do serviço gerador de batidas. Quando perguntado sobre a pasta onde deseja instalar, coloque c:\gladiusacesso\geradordebatidas\ 2) Depois da instalação, copie os arquivos começados com RM.Cst. para pasta \totvs\corporerm\rm.net 3) Entre na pasta \totvs\corporerm\rm.net e renomeie o arquivo _Broker.dat para _Broker.old 4) Copie todas as Dlls da pasta onde rm.net esta instalado para pasta onde o gerador foi instalado. 5) Reinicie o Serviço RM.Host.Service. 6) Agora basta iniciar o serviço Servidor Gladius Marcacao Batidas Automaticas. Arquivos de Log Quando o serviço esta trabalhando, ele irá gerar logs na pasta \gladiusacesso\log. O principal arquivo a ser examinado chama-se Batidas_Chronus.Log. Quando acontecem erros, pode ser que este arquivo sinalize que falta a correta configuração do banco de dados ou então que o Usuário do sistema não esta configurado para trabalhar com o período atual do Chronus. Em geral, esse log ira conter o número de batidas que o sistema esta lançando naquele momento. 5