Histórico da Página

01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucao	TOTVS Logística Recintos Aduaneiros

Solucoes_totvs_cross

SolucaoCross

Solucoes_totvs_parceiros

SolucaoParceiros

Solucoes_totvs_parceirosexptotvs

SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs

Segmento	Distribuição
Region	Construção Projetos
Linha	Linha Logix

Segmento:

Segmentos_totvs

Segmento	Logística

Módulo:

Serviço de Servidor de Catracas - Recintos Aduaneiros

Função:

Serviço de Servidor de Catracas - Recintos Aduaneiros

Ticket:

-

Requisito/Story/Issue (informe o requisito relacionado) :

DLOGPORTOS-12077

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

...

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:

Henry 8x

Requisitos

Totvs custom tabs box

tabs	Pré-requisitos, Recursos Suportados, Instalação/Desinstalação, Configuração do Serviço, Configuração de Parâmetros de Sistema, Configuração de Equipamentos/Catracas, Monitoramento
ids	prerequisitos,recursos,instalacao,configuracao,configparametros,catracas,monitoramento

Totvs custom tabs box items

default	yes
referencia	prerequisitos

Ambiente

Windows Server 2012 R2 ou superior.
Driver do banco de dados SQL Server "SQL Server Native Client 11.0".
Pasta (Redist) de redistribuição do TOTVS Logística Recintos Aduaneiros registrada na máquina. Essa pasta com os arquivos de redistribuição acompanha os pacotes do TOTVS Logística Recintos Aduaneiros juntamente com um arquivo "Redist_SARA_Register.bat" para para registra-la.
Driver dos equipamentos de controle de acesso seguro (catracas) do fabricante utilizado, caso possua.
1. para Para o Henry 8x não é necessário instalação de driver, pois a comunicação é feita diretamente via socket com os equipamentos.
Módulo de Controle de Acesso do TOTVS Logística Recintos Aduaneiros na versão 12.1.45 ou superior.

Totvs custom tabs box items

default	no
referencia	recursos

Computacional

Serviço do Windows
Multi-thread. Cada equipamento utilizará uma ou mais threads de processamento e não compartilhará recursos computacionais entre outros equipamentos.

Controle

Controle de acesso online
1. crachás Crachás mestre.
2. validações Validações de permissão de acesso (permissões de funcionários/visitantes e acesso temporário, acessos duplicados, lista branca BDCC).
3. controle Controle de bloqueio de pessoas.
4. controle Controle de crachás inativos.
5. controle Controle de perfis de acesso.
6. controle Controle de horários permitidos de acesso.
7. controle Controle por pontos de acesso internos.
8. controle Controle de biometrias e crachás de visitantes (para recolhimento de crachás para equipamentos com urna).
9. controle Controle para diferentes tipos de equipamentos (catracas, torniquetes e totem).

Gerenciamento

Criptografia para configurações de acesso ao banco de dados.
Integração de lista de crachás de visitantes.
Integração de listas de biometrias.
Recurso de controle de logs por equipamento em arquivo, permitindo ativar e desativar o monitoramento em arquivo. Logs do serviço de servidor de catraca (execução e erros), log do gerenciador de equipamentos e log por equipamento, todos em arquivos distintos.
Recurso de reconexão automática para equipamentos offline por perda de conexão.
Recurso de integração automática nos equipamentos para biometrias registradas no módulo de controle Controle de acesso Acesso do TOTVS Logística Recintos Aduaneiros.
Sincronização automática de lista de crachás de visitantes, relógio e configurações de equipamentos na inicialização do serviço.

Totvs custom tabs box items

default	no
referencia	instalacao

Para realizar a instalação do novo serviço de servidor de catracas, primeiro deve-se criar uma pasta para instalação do serviço.

Recomendamos criar em "C C:\SARA\Services\ServidorCatracaService", mas caso desejar, pode ser criado criada outra estrutura a escolha.

Para essa documentação, será considerado a estrutura sugerida.

Totvs custom tabs box

tabs	Guia de Instalação, Guia de Desinstalação
ids	guiainstalacao,guiadesinstalacao

Totvs custom tabs box items

default	yes
referencia	guiainstalacao

Remova as opções de somente leitura do diretório de instalação. Exemplo: "C:\SARA\Services\ServidorCatracaService".
Mova o arquivo "ServidorCatracaService.exe" para para o diretório de instalação pretendido.
Abra o programa "CMD" CMD (Prompt de comando) do Windows com privilégios de administradorAdministrador.
No CMD, navegue até o diretório de instalação e execute o comando: ServidorCatracaService.exe /install
1. Image Modified
Com a instalação bem sucedida, o novo serviço aparecerá em "services.msc".
1. Image Modified

Totvs custom tabs box items

default	no
referencia	guiadesinstalacao

Abra o programa CMD do Windows com privilégios de administradorAdministrador.
Navegue até o diretório de instalação do serviço de servidor de catraca. Exemplo:
Execute o comando: ServidorCatracaService.exe /uninstall
1. Image Modified
como Como alternativa, o comando "sc delete sServidorCatracaService" também pode ser utilizado para desinstalação do programa.

Informações

title	IMPORTANTE

Para detalhes de configuração que devem ser feitas antes de iniciar o serviço, consulte as abas de configuração deste documento.

Totvs custom tabs box items

default	no
referencia	configuracao

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 para as configurações do serviço.

Bloco de código

language	text
title	Exemplo de arquivo ServidorCatracaService.ini criado
collapse	true

[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

FILESECURITY	Parâmetro	Descrição
FILESECURITY	Active

se

Se configurado com valor 0

, irá realizar

(zero) 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 (um), indicando que a criptografia de segurança foi aplicada ao arquivo.

OBS:

Informações

title	Importante

Para alterar os dados de autenticação com o banco de dados, retorne esse valor para 0 (zero) e modifique novamente os dois campos User e Password.

Após o serviço ser iniciado, a criptografia será aplicada novamente.

DBCONNECTION

DatabaseID

identificação

Identificação do driver de banco de dados utilizado. Valor padrão

"

MSSQL

"

.
Não deverá ser alterado.

ServerName

nome

Nome do servidor/instância do banco de dados SQL Server.

DatabaseName

nome

Nome da base de dados a ser conectada. Exemplo: sara_db

User

usuário

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.

Informações

title	Importante

Para

OBS: para

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

Password

senha

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

OBS: para

Informações

title	Importante

Para alterá-lo, reveja o item Active de FILESECURITY.

SERVICEFILES

ErrorLog

arquivo

Arquivo onde será salvo os logs de erro do serviço de servidor de catracas (apenas log do serviço).

ExecutionLog

arquivo

Arquivo onde será salvo os logs de execução do serviço de servidor de catracas (apenas log do serviço).

EquipmentManagerLogDirectory

diretório

Diretório onde será salvo os logs do gerenciador de equipamentos de catracas. Este log limita-se ao mecanismo de gerenciamento como servidores adicionados/removidos, integração de listas de crachás de visitantes, integração de listas de biometrias, início

e

, parada do gerenciador,

etc

entre outros.

EquipmentsLogDirectory

diretório

Diretório onde será salvo os logs individuais de cada equipamento (catraca) conectado ao gerenciador. Este log

irá mostrar as

mostrará as requisições online realizadas, validações,

etc

entre outros.
SERVICE	ServiceName

nome

Nome do serviço de servidor de catracas que será apresentado no

"

services.msc

" do

do Windows.

LogEquipmentsInFileOnStart

permite

Permite ativar o monitoramento de acessos aos equipamentos por arquivos de log já na iniciação do programa. Valor 0 (zero) não gera logs dos equipamentos em arquivo e valor 1 (um) gera o log dos equipamentos em arquivos.

AutoReconnectOfflineEquipmentsOnStart

permite

Permite ativar a reconexão automática de equipamentos que ficarem offline por perda de conexão mantendo a configuração ativada ou desativada já na iniciação do programa. Valor 0 (zero)desativa a reconexão automática e valor 1 (um) ativa a reconexão automática.

IntervalAutoReconnectOfflineEquipments

intervalo

Intervalo de checagem de equipamentos offline para reconexão automática.
Tempo configurado em milisegundos.

AutoRegisterBiometricsInEquipmentsOnStart

permite

Permite ativar o envio automático de biometrias cadastradas no módulo

controle

Controle de

acessos

Acessos do TOTVS Logística Recintos Aduaneiros, já na iniciação do programa. Valor 0 (zero) desativa o envio automático e valor 1 (um) ativa o envio automático.

Informações

title	Importante

O

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.

IntervalRegisterBiometricsInEquipments

intervalo

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

Informações

title	Importante

Por

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.

Totvs custom tabs box items

default	no
referencia	catracas	configparametros

O novo servidor de catraca pode variar seu comportamento conforme configuração de parâmetros do TOTVS Logística Recintos Aduaneiros, realizados no módulo Sistema, tela de Parâmetros. Abaixo estão listados os parâmetros que são reconhecidos pelo serviço do servidor de catracas e seus efeitos.

Parâmetro	Descrição	Valores permitidos	Efeito
INTEGRA_BDCC	Indica se a unidade utiliza a integração com o BDCC para os crachás de controle de acesso.	S - Ativa integração N - Desativa integração	Ativando o parâmetro, o serviço de servidor de catraca verificará se o crachá está liberado na lista branca do BDCC para liberação de acesso.
INFORMAR_PERFIL_CRACHA	Indica se a unidade faz controle por perfil de acesso por pontos de acesso.	S - Ativado N - Desativado	Ativando o parâmetro, o serviço de servidor de catraca trabalhará em modo de controle por Pontos de Acesso e realizará as checagens de permissão de acesso, conforme o perfil de acesso informado para a pessoa, e quais pontos de acesso aquele perfil de acesso permite a passagem.
INFORMAR_PERIODO_LIBERACAO_PESSOA	Indica se a unidade faz controle de horários permitidos de acesso.	S - Ativado N - Desativado	Ativando o parâmetro, o serviço de servidor de catraca realizará o controle de período de liberação do acesso do crachá, para acessos temporários, e efetuará o controle de horários permitidos de acesso para os funcionários, em caso de crachá permanente.
DESVINCULAR_CRACHA_VISITANTE_NA_SAIDA	Indica se a unidade desvincula a pessoa do crachá de visitante ao realizar a saída da unidade.	S - Ativado N - Desativado	Ativando o parâmetro, o serviço de servidor de catraca desvinculará o relacionamento do crachá de visitante da pessoa que realizou o acesso, no momento da saída desse crachá/pessoa da unidade. Caso desativado, manterá o vínculo da pessoa ao crachá e esse desvinculo deverá ocorrer manualmente, pelo módulo Controle de Acesso.
MOSTRA_LOG_CATRACA_PONTO_ENTRADA_FSW	Indica se será apresentado no Log dos equipamentos de catracas as passagens por pontos de entradas da FSW.	S - Ativado N - Desativado	Ativando o parâmetro, o serviço de servidor de catraca exibirá no log dos equipamentos de catracas, quando iniciou e terminou a passagem por um ponto de entrada da FSW. Isso poderá ser ativado para verificação de possíveis erros ocorridos no servidor de catracas, para facilitar se o ponto do erro ocorreu em um específico ou implementação padrão.

Informações

title	IMPORTANTE

Ao realizar a troca de um parâmetro, para que ele tenha efeito no serviço de servidor de catraca, o mesmo deve ser reiniciado.
Além dos parâmetros listados, podem haver outros parâmetros relacionados a implementações de específicos. Esses devem ser consultados com a equipe de FSW.

Totvs custom tabs box items

default	no
referencia	catracas

A configuração dos equipamentos (catracasA 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 Modified

Após as configurações realizadas, o serviço já pode ser iniciado em

"services

services.msc

" pelo

, pelo botão

"

Iniciar

"

.

Informações

title	IMPORTANTE

Modelos ainda não suportados pelo novo servidor de catracas em serviço serão ignorados pelo gerenciador.
Clientes que possuem equipamentos/catracas com drivers suportados somente pelo servidor de primeira versão, não poderão aproveitar a nova solução.

Totvs custom tabs box items

default	no
referencia	monitoramento

O monitoramento do serviço de servidor de catracas poderá ser realizado de duas maneiras. :

Por arquivos de log

e por

;
Por aplicativo de monitoramento.

Totvs custom tabs box

tabs	Por Arquivos de Log, Por Aplicativo de Monitoramento
ids	monitorlog,monitorapp

Totvs custom tabs box items

default	yes
referencia	monitorlog

Para ser possível o monitoramento dos acessos por arquivos de log, o parâmetro LogEquipmentsInFileOnStart deve estar ligado com o valor 1 (um) 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 Modified

Os arquivos de log do gerenciador de equipamentos pode ser acessado pelo diretório configurado em EquipmentManagerLogDirectory no arquivo "ServidorCatracaServicearquivo ServidorCatracaService.ini".

A imagem abaixo representa um arquivo de log do gerenciador de equipamentos:

Image Modified

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 Modified

Totvs custom tabs box items

default	no
referencia	monitorapp

Este recurso ainda está em construção.

04. DEMAIS INFORMAÇÕES

Não se aplica.

05. ASSUNTOS RELACIONADOS

Não se aplica.

Card documentos

Informacao	Esta implementação é valida somente para a versão do módulo compilado no DELPHI 10 - TOKYO.
Titulo	IMPORTANTE!

...

Templatedocumentos

HTML

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

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Requisitos

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS