Histórico da Página

01. DADOS GERAIS

02. 

...

Desenvolver um novo servidor de catracas para a solução TOTVS Logística Recintos Aduaneiros que funcione como um serviço do Windows e com suporte a multi-thread para o gerenciamento dos equipamentos de controle de acesso seguro.  Essa nova solução se faz necessária, pois, a primeira versão do servidor, o gerenciamento de catracas trabalha como um aplicativo que deve ficar aberto na tela do sistema operacional, exigindo que este mantenha-se autenticado para o programa operar. Também possui uma limitação relacionada ao gerenciamento mono thread dos equipamentos, onde todos os recursos de funcionamento são compartilhados com todas as catracas conectadas ao servidor causando constantemente erros de memória e travamentos excessivos. Além disso, novas soluções de drivers de comunicação de equipamentos não são suportados, limitando-se apenas ao Henry7x, DIMEP Micropoint IP e DIMEP Biopoint IP. Soluções como a Henry7x não são mais comercializadas pelo fabricante, dificultando a implantação do servidor de catracas em novos clientes.

03. SOLUÇÃO

Para resolver as questões relacionadas ao módulo de servidor de catracas e controle de acesso do TOTVS Logística Recintos Aduaneiros, foi desenvolvida nova solução como um serviço do Windows e com suporte a multi-thread para os equipamentos de controle de acesso seguro/catracas. Essa nova solução prevê uma arquitetura melhorada, com maior desempenho e sem compartilhamento de recursos entre os equipamentos. Dessa forma, cada equipamento operará individualmente com o serviço do servidor de catracas, como um subprograma, a cada equipamento conectado. Com a nova arquitetura, também será possível integrar novos drivers de equipamentos de forma facilitada, exigindo apenas a implementação/desenvolvimento da interface de comunicação com um novo driver de fabricante, diminuindo assim, custos relacionados a suportabilidade de novos equipamentos de diferentes fabricantes.

Atualmente esta solução está suportando os drivers listados abaixo:

...

OBJETIVO

O EAI Service, é uma aplicação do tipo "Serviço Windows" desenvolvida para realizar a integração de dados do sistema TOTVS LOGÍSTICA RECINTOS ADUANEIROS com outros sistemas (aplicações externas).

Este serviço é responsável pela geração e envio das mensagens para uma determinada aplicação externa.

Após o sistema SARA gerar as pendências para integração, o módulo EAI Service efetua a leitura da tabela de pendências (tab_eai_send) verificando se existe alguma mensagem para ser gerada, se existir, efetua a geração da mensagem gravando na tabela (tab_eai_message) e envia para o endereço da aplicação externa configurado na mensagem (tab_eai_transaction).

Ao receber a resposta da integração da aplicação externa, o serviço guarda a mensagem de retorno atualizando a  tabela (tab_eai_message), informando se a integração foi realizada com sucesso ou se retornou alguma inconsistência.

03. DEMAIS INFORMAÇÕES

Após a instalação do serviço, esse programa deverá ser configurado para comunicação com o banco de dados, escolha dos diretórios de logs e ativação de recursos desejados.

Na instalação do programa, automaticamente será criado um arquivo no diretório de instalação chamado "ServidorCatracaService.ini" para as configurações do serviço.

[FILESECURITY]
Active=0
[DBCONNECTION]
DatabaseID=MSSQL
ServerName=
DatabaseName=sara_db
User=sa
Password=
[SERVICEFILES]
ErrorLog=C:\SARA\Services\ServidorCatracaService\LogsServicoCatracas\ServidorCatracaServiceError.log
ExecutionLog=C:\SARA\Services\ServidorCatracaService\LogsServicoCatracas\ServidorCatracaServiceExecution.log
EquipmentManagerLogDirectory=C:\SARA\Services\ServidorCatracaService\LogsCatracas\
EquipmentsLogDirectory=C:\SARA\Services\ServidorCatracaService\LogsCatracas\
[SERVICE]
ServiceName=TOTVS | Servidor de Catracas - Recintos Aduaneiros
LogEquipmentsInFileOnStart=0
AutoReconnectOfflineEquipmentsOnStart=0
IntervalAutoReconnectOfflineEquipments=60000
AutoRegisterBiometricsInEquipmentsOnStart=0
IntervalRegisterBiometricsInEquipments=120000

Detalhamentos das Configurações

Componentes

O serviço EAIService possui os seguintes componentes:

• Módulos
  • EAIService.exe - Arquivo executável do serviço.
  • EAILog.bpl - Arquivo utilizado pelo "EAIService.exe" para a geração dos 'LOGs' do EAI no banco de dados.

• Arquivo INI
  • EAIService.ini - Arquivo de inicialização configurado para o serviço.
  • Config.ini - Arquivo de inicialização configurado para o serviço. 

Instalação do serviço

A instalação do serviço EAIService poderá ser instalada utilizando a pasta "EXECUTAVEIS" onde contém os outros módulos do sistema, ou também poderá ser instalada em uma outra pasta, exemplo SERVICES.

Para a instalação do serviço na pasta "SERVICES", deverá ser seguido os seguintes passos:

1) A pasta SERVICES deverá ser criada no diretório que contém a pasta "EXECUTAVEIS" no servidor de arquivos do SARA.

Exemplo:

Image Added

2) Na pasta "SERVICES", deverá ser criada a pasta "Config" e a pasta "EAIService"

Image Added

3) Na pasta "Config", criar o arquivo CONFIG.INI com o conteúdo abaixo informando o servidor de banco de dados, a base de dados, um usuário do banco de dados para o serviço do EAI e a sua senha. Na chave FILE, também deverá ser informado os diretórios e arquivos de LOG. Por sugestão, criar a pasta LOG no diretório do EAIService.

4) Na pasta EAIService, copiar os arquivos "EAIService.exe" e "EAILog.bpl" distribuído no pacote do SARA dentro da pasta 'EXECUTAVEIS'.

Image Added

5) Para a instalação do serviço é necessário que os arquivos de redistribuição das aplicações DELPHI estejam inclusas no PATH do Windows para não acusar erros de dependências de arquivos. Caso não esteja, executar o arquivo "Redist_SARA_Register.bat" como administrador conforme exemplo abaixo:

Image Added

Após a execução, será necessário fechar o "prompt de comando" e abrir outro novamente.

6) Na pasta EAIService, abrir um prompt de comando como 'Administrador", e executar o comando para a instalação do serviço.

Exemplo:

Image Added

Após a instalação será exibida a seguinte mensagem:

Image Added

7) Após a instalação do serviço, será criado o arquivo "EAIService.ini" para configuração. Deverá ser editado o arquivo informando os dados de conexão do banco de dados, arquivos de LOG, e outras configurações. O campo FrequencyInSeconds determinará á frequência da verificação da fila de pendências do EAIService.

Image Added

8) Após a configuração do arquivo "EAIService.ini", o serviço poderá ser inicializado.

Image Added

Na pasta configurada para o LOG no arquivo CONFIG.INI, será possível visualizar o arquivo de execução e saber se o serviço foi inicializado com sucesso.

Image Added

se configurado com valor 0, irá realizar uma criptografia para os parâmetros User e Password. Após a criptografia aplicada pela execução do serviço, o seu valor irá automaticamente ser alterado para 1, indicando que a criptografia de segurança foi aplicada ao arquivo.

OBS: Para alterar os dados de autenticação com o banco de dados, retorne esse valor para 0 e modifique novamente os dois campos User e Password. Após o serviço ser iniciado, a criptografia será aplicada novamente.

usuário para autenticação no banco de dados. Recomenda-se sempre utilizar o usuário "sa" por possuir maiores privilégios que o serviço de servidor de catracas pode necessitar com o banco de dados.

OBS: para alterá-lo, reveja o item Active de FILESECURITY.

senha do usuário para autenticação com o banco de dados.

OBS: para alterá-lo, reveja o item Active de FILESECURITY.

permite ativar o envio automático de biometrias cadastradas no módulo controle de acessos do TOTVS Logística Recintos Aduaneiros já na iniciação do programa. Valor 0 desativa o envio automático e valor 1 ativa o envio automático.

OBS: o registro de biometrias nos equipamentos possui um desempenho baixo por conta do módulo de biometria nos próprios equipamentos. Cada biometria enviada leva alguns segundos no equipamento para efetivação do cadastro.

intervalo de checagem de biometrias pendentes de integração com o equipamento de catracas. Tempo configurado em milisegundos.

OBS: por conta do baixo desempenho nos equipamentos nos módulos de biometria para registro, recomenda-se não utilizar intervalos muito curtos de checagem.

A configuração dos equipamentos (catracas) continua no módulo Controle de Acesso, menu Cadastros, submenu Catraca do TOTVS Logística Recintos Aduaneiros. Os drivers para o novo servidor de catracas em serviço será reconhecido pelo cadastro do campo Modelo da tela de Cadastro de Catraca. Exemplo: para a catraca conectar-se a um equipamento do fabricante Henry, com o driver Henry  8x, selecione o modelo HENRY 8X no cadastro, conforme imagem de exemplo abaixo:

Image Removed

O monitoramento do serviço de servidor de catracas poderá ser realizado de duas maneiras. Por arquivos de log e por aplicativo de monitoramento.

04. DEMAIS INFORMAÇÕES

...

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>