Histórico da Página

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

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-operações thread safe 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-operações thread safe 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 abaixosuporta os seguintes controladores:

• Henry PrimmeSF
• Henry Argos 8x

[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=

[FILESECURITY]
Active=0
[DBCONNECTION]
DatabaseID=MSSQL
ServerName=
DatabaseName=sara_db
User=sa
Password=
[SERVICEFILES]
ErrorLog=C:\SARA\Services\ServidorCatracaService\LogsServicoCatracasLogsCatracas\ServidorCatracaServiceError.log
ExecutionLogEquipmentsLogDirectory=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
AutoUpdateVisitorCardsInEquipmentsOnStart=0
IntervalAutoReconnectOfflineEquipments=60000
AutoRegisterBiometricsInEquipmentsOnStart=0
IntervalRegisterBiometricsInEquipments=120000

LogsCatracas\
[SERVICE]
ServiceName=TOTVS | Servidor de Catracas - Recintos Aduaneiros
LogEquipmentsInFileOnStart=0
AutoReconnectOfflineEquipmentsOnStart=0
AutoUpdateVisitorCardsInEquipmentsOnStart=0
IntervalAutoReconnectOfflineEquipments=60000
AutoRegisterBiometricsInEquipmentsOnStart=0
IntervalRegisterBiometricsInEquipments=120000

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

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

Além da segurança já assegurada automaticamente entre o aplicativo de monitoramento e o serviço de servidor de catracas, o acesso ao aplicativo também irá exigir uma chave de acesso que representa um perfil com privilégios diferenciados para funcionalidades no aplicativo de monitoramento. O sistema trabalhará com dois perfis distintos de acesso. O primeiro, permite apenas a visualização de logs. Já o segundo, irá permitir acesso completo como administrador do sistema, liberando as funcionalidades de gerenciamento do serviço de servidor de catracas.

As chaves de acesso serão obtidas no módulo Controle de Acesso (a partir da versão 12.1.45.3), menu Servidor Catracas Monitor, sub-menu Chaves de Acesso.

Image Removed

perfillogs Se a chave de acesso utilizada for para somente logs, o aplicativo irá bloquear o acesso para a aba Gerenciar. Dessa forma, para esse perfil de acesso, somente será possível visualizar o status dos equipamentos conectados, visualizar e selecionar o equipamento que se deseja consultar o log em tempo real e a própria visualização do log. A imagem abaixo ilustra um aplicativo conectado e configurado com uma chave de acesso de somente logs. Image Added Note que na imagem acima, a aba Gerenciar encontra-se desabilitada (aba sem destaque que não permite realizar o clique sobre ela) e não permitirá nenhuma interação com o serviço de servidor de catracas que exijam os privilégios de administrador. Ao acessar o menu do canto superior direito, a identificação do Modo de acesso assegura que este acesso está liberando somente o acesso a logs.
yes Totvs custom tabs box items default no referencia monitorlog perfiladmin Já se a chave de acesso utilizada for de administrador, além das funcionalidades liberadas para a chave de acesso de perfil de somente logs, irá liberar todas as funcionalidades da aba Gerenciar permitindo mais controles sobre o serviço de servidor de catracas. A imagem abaixo ilustra um aplicativo conectado e configurado com uma chave de acesso de administrador. Image Added Note que na imagem acima, a aba Gerenciar encontra-se habilitada permitindo o acesso e demais funcionalidades que exigem os privilégios de administrador do sistema. Ao acessar o menu do canto superior direito, a identificação do Modo de acesso assegura que esse acesso está liberando todas as funcionalidades de um administrador do serviço de servidor de catracas. Para ser possível o monitoramento dos acessos por arquivos de log, o parâmetro LogEquipmentsInFileOnStart deve estar ligado com o valor 1 no arquivo "ServidorCatracaService.ini". Desse modo, cada equipamento gerará um arquivo com a data do dia atual e com o nome do equipamento, permitindo visualizar as interações de acesso realizadas por aquele equipamento. Para acessar os arquivos de logs gerados, basta acessar o diretório configurado em EquipmentsLogDirectory no arquivo "ServidorCatracaService.ini". A imagem abaixo representa um arquivo de log de um determinado equipamento: Image Removed Os arquivos de log do gerenciador de equipamentos pode ser acessado pelo diretório configurado em EquipmentManagerLogDirectory no arquivo "ServidorCatracaService.ini". A imagem abaixo representa um arquivo de log do gerenciador de equipamentos: Image Removed Já os logs de execução e erros do serviço do Windows de servidor de catracas pode ser acessado pelos arquivos configurados nos parâmetros ExecutionLog e ErrorLog configurados no arquivo "ServidorCatracaService.ini". A imagem abaixo representa os logs de execução e erro do serviço. Image Removed Totvs custom tabs box items default no referencia monitorapp funcionalidades - Selecionando um gerente de catracas Ao carregar a aplicação, a primeira tela que será exibida será para a seleção de um gerente de catracas.  Isso ocorre pois na mesma rede podem existir mais de um A partir da versão 12.1.45.1 do serviço de servidor de catracas do TOTVS Logistica Recintos Aduaneiros, a solução passou a oferecer suporte a monitoramento por aplicativo nas plataformas Windows e Android. O aplicativo funciona com o conceito de Application Tethering, o que permite encontrar e se comunicar com o serviço de servidor de catracas automaticamente, desde que o aplicativo esteja em funcionamento sob a mesma sub-rede da rede local (LAN) que o serviço de servidor de catracas se encontra, sem a necessidade de realizar uma configuração para a conexão. As imagens abaixo demonstram o aplicativo executando em um dispositivo Android. Image Removed Image Removed Totvs custom tabs box tabs Pré-requisitos, Perfis/modos de acesso, Funcionalidades do aplicativo, Downloads ids prerequisitosmonitor,modos,funcionalidades,downloads Totvs custom tabs box items default yes referencia prerequisitosmonitor A comunicação via rede local necessita de algumas liberações de portas para que ocorra com sucesso. Para isso será necessário a liberação, tanto para entrada quanto para saída, das portas UDP de 2020 à 2039 e TCP de 2040 à 2110. Além disso, essa comunicação ocorre de forma segura, e somente esse aplicativo de monitoramento terá a capacidade de parear e se comunicar diretamente com o serviço de servidor de catracas do TOTVS Logística Recintos Aduaneiros. Pré-requisitos Windows Windows 7 ou superior Pré-requisitos Android Android 6 ou superior (de preferência Android 10 ou 11)
Totvs custom tabs box items
default no referencia modos

No primeiro acesso realizado no aplicativo, será solicitado a configuração da chave de acesso. Essa primeira configuração poderá ser realizada de duas formas: leitura de QR-Code ou informando manualmente. As imagens abaixo ilustram a configuração inicial de chave de acesso sendo realizada em um dispositivo Android.

Image Removed Image Removed Image Removed

A opção LER CÓDIGO para a versão Android, habilitará a leitura do QR-Code via câmera do dispositivo. Já a para a versão Windows, a opção LER CÓDIGO abrirá uma tela permitindo a seleção de um arquivo de imagem contendo o QR-Code.

Caso seja necessário realizar a troca da chave de acesso no aplicativo, no menu do canto superior direito, terá a opção Trocar chave de acesso. Com essa opção, será possível realizar a releitura da chave ou informa-la manualmente novamente. A Imagem abaixo ilustra o menu com a opção de troca de chave de acesso.

Image Removed

- Selecionando um gerenciador de catracas

Ao carregar a aplicação, a primeira tela que será exibida será para a seleção de um gerenciador de catracas.  Isso ocorre pois na mesma rede podem existir mais de um serviço de servidor de catracas em funcionamento. Por exemplo, um servidor ativo que roda em ambiente de testes com equipamentos de catracas apenas para testes e outro servidor ativo que roda em ambiente de produção controlando de fato a entrada e saída de pessoas.  A imagem abaixo ilustra a seleção de um gerenciador para ser pareado.

Image Removed

- Identificando se o aplicativo está conectado a um gerenciador

Quando o aplicativo está conectado a um gerenciador, o ícone de sinal estará disponível no canto superior direito da tela, logo antes do menu de mais opções. Caso nenhuma comunicação esteja ativa, este mesmo ícone terá uma barrinha identificando que a conexão não está ativa. Nesse último caso, caso queira refazer a conexão, basta clicar sobre o ícone que o aplicativo iniciará a busca por serviços de servidor de catracas ativos na rede e permitirá fazer o pareamento de conexão. A imagem abaixo ilustra o aplicativo quando não está pareado com um serviço de servidor de catracas.

Image Removed

- Selecionando um equipamento para monitorar log

O aplicativo permite realizar o monitoramento de log para todos os equipamentos gerenciados pelo serviço de servidor de catracas ou para apenas um equipamento em específico. Para selecionar a forma que deseja realizar o monitoramento de log, basta utilizar a ação Selecionar equipamento, botão azul da aba Log. A qualquer momento essa seleção poderá ser alternada, entre um equipamento específico ou para visualizar o log de todos os equipamentos. As imagens abaixo ilustram a seleção de um equipamento específico para visualização de log.

Image Removed Image Removed

- Realizando a troca da chave de acesso

O aplicativo oferece a opção de a qualquer momento realizar a troca de chave de acesso. Essa funcionalidade está disponível para alterar entre uma chave que dá privilégios somente de log ou chave que dá o acesso de administrador ao aplicativo. Também pode ser utilizada em casos que a chave de acesso foi regerada pelo administrador do sistema, o que vai causar o modo de acesso classificado como Sem acesso. A troca de chave de acesso poderá ser realizada no menu do canto superior direito, opção Trocar chave de acesso. A imagem abaixo ilustra o menu de opções com a ação de troca de chave de acesso e o redirecionamento para a tela de configuração para a chave de acesso.

Image Removed Image Removed

- Realizando a troca de gerenciador (serviço de servidor de catracas) para monitoramento

Mesmo já pareado com um serviço de servidor de catracas, a qualquer momento será possível realizar a troca do gerenciador e selecionar outro serviço para monitoramento. Esta ação irá desconectar do serviço atual e repetirá as ações descritas no parágrafo "Selecionando um gerenciador de catracas". Esta ação também poderá ser encontrada no menu do canto superior direito, opção Trocar de servidor gerente.

- Fechar o aplicativo

O aplicativo poderá ser finalizado no menu do canto superior direito, opção Sair. Na plataforma Android o botão voltar do sistema operacional também poderá ser utilizado para fechar a aplicação, e no caso da plataforma Windows, poderá ser utilizado o botão "X" da janela aberta.

- Aba Gerenciar

A aba Gerenciar é de acesso exclusivo para uma chave com privilégios de administrador. Nessa aba será possível realizar várias tarefas relacionadas ao gerenciamento do serviço de servidor de catracas que serão descritos nos itens abaixo:

1) Configurações do serviço

As configurações do serviço permite ativar e desativar ações como: Reconectar equipamentos offline automaticamente; Gerar log de equipamentos em arquivos e; Registrar biometrias nos equipamentos automaticamente. As ações de reconectar equipamentos offline automaticamente e registrar biometrias nos equipamentos automaticamente, se forem ativadas, será exibido um campo para informar o tempo de checagem em milissegundos (ms), sendo o valor mínimo permitido para o primeiro de 30000 ms (30 segundos) e para o segundo de 60000 ms (60 segundos). Para efetivar uma configuração, deverá ser acionado a ação Enviar configurações, caso contrário, a configuração não será aplicada ao serviço de servidor de catracas. A imagem abaixo ilustra as configurações do serviço.

Image Removed

2) Atualizando equipamentos 

Toda vez que uma configuração de catraca for alterada ou adicionada na tela de Catracas do módulo Controle de Acesso, essa configuração não é refletida automaticamente para o serviço de servidor de catracas. Por esse motivo foi disponibilizado a ação de Atualizar equipamentos no aplicativo de monitoramento. Toda vez que for ativado ou desativado um equipamento de catraca, alterado seus dados de conexão, sentido de acesso, tipo de equipamento, etc., esta ação poderá ser executada no aplicativo de monitoramento para que estas configurações se reflitam no serviço de servidor de catracas. Um exemplo prático disso, ao desativar uma catraca na tela de catracas, para que este equipamento seja desconectado do serviço de servidor de catracas, basta executar a ação de Atualizar equipamentos que logo em seguida o servidor irá reconhecer a mudança nas configurações e irá desconectar o equipamento. As imagens abaixo ilustram um equipamento sendo inativado e logo em seguida sendo atualizado no serviço de servidor de catracas pelo aplicativo de monitoramento.

Image Removed  Image Removed

3) Atualizar crachás de visitantes

4) Limpar crachás de visitantes

5) Atualizar biometrias

6) Limpar biometrias

7) Beep de acesso liberado

8) Beep de acesso negado

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

• Adequação do servidor de catracas para tratamento por biometria
• Adequação do servidor para seleção automática de sentido liberado por biometria para Henry 8X
• Seleção de biometrias para os modos online e offline pelo tipo de crachá vinculado
• Implementar rotina cíclica de descarga/carga de biometrias para o modo online
• Ajustes para uso de biometria offline em equipamentos Henry PrimmeSF e Argos

<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>

...