Manual parte 02 - Parametrizações, auxílios e dúvidas - Hkvision

[Guilherme Tadler]

2.6 - Instalação do serviço do Hikvision REP-P:

Para a instalação do serviço do Hikvision REP-P vou pedir para você utilizar um outro manual que explica muito bem como realizar todo o processo:

S:\Download\Repositorio_Integracoes\Hikvision REP-P\Documentação Hikvision REP-P.pdf

2.7 - Auxílios, dúvidas e parametrizações necessárias para complementar a instalação do Hikvision REP-P:

API-KEY:

Agora, já dentro do Ponto Soft, você deve informar a API-KEY que foi solicitada e, é descrita no início desse manual Manual parte 01 - Instalação Tomcat 8 & 9 - Hikvision | Passo 1 | Requisitos iniciais, ela deve ser informada na tela PSW0135, na aba Genéricos, no campo Api Key REP-P e salvar.

PSW7300 - Integração REP - SCR API:

Você deve criar um novo servidor para se conectar com a API do Hikvision, nesse novo registro, por padrão nomeio o nome do servidor de HIKVISION REP P e no campo URL Base API informe a URL que direciona a API que anteriormente foi instalada no item 2.5: do Manual parte 01 - Instalação Tomcat 8 & 9 - Hikvision | Passo 1 | Requisitos iniciais

http://IPdamaquina:8280/pontosoft-hikvision-api

PSW0330 - Lista de Usuários:

Por padrão é criado o usuário Hikvision com a senha Hikvision para usar esse usuário na geração do arquivo .cfg na PSW7300, para depois o mesmo ser o usuário de autenticação da API do Hikvision:

PSW2580 - Cadastro de Estações de Coleta:

Criar uma estação de coleta e informar o número do servidor anteriormente criado, lembre de informar o valor "Sim" no campo Possui REP Online.

PSW7280 - Cadastro de Registradores Eletrônicos de Ponto - Programa (REP-P):

Inserir aqui os REP-P que a empresa possui, caso ainda não criados. Lembrando, o Modelo sempre será REP-P Coletor e a Porta: 80

Auxílios

Devido a um bug na versão 6 do Ponto Soft, quando for salvo o registro do REP-P na tabela relogios, o campo Senha dispositivo transforma a senha padrão informada toda em maiúscula, e devido a isso, você deve rodar na base de dados do cliente o script abaixo, informando o cod_relogio a ser alterado:

update relogios rep
    set rep.repp_usuario = 'admin'
    ,   rep.repp_senha = pack_criptografia.text_to_cripto_hexa('senha,04')
    where rep.cod_relogio = cod_relogio;

PSW0180 & PSW3580:

Na tela de empresas PSW0180 ou na PSW3580, caso a empresa possuir filial, informar no campo CPF Responsável Legal: o CPF do responsável por essa empresa.

Teste e validações:

Após realizar esse passo a passo dentro do Ponto Soft, o Hikvision está pronto para ser testado e para isso é necessário realizar algumas validações para confirmar o seu funcionamento:

PSW7283 - Consulta de Status Sincronização Empregadores REP-P:

Verificar nessa tela se a sincronização do empregador ou empregadores ocorreu corretamente, caso o campo Data Hora Sincronização esteja populado e o campo Observação esteja null, o empregador foi sincronizado corretamente pela a API do Hikvision:

PSW7490 - Registrar Comandos para Relógios:

Caso o empregador tenha sido processado, estamos chegando no fim desse processo, agora, você deve enviar uma carga de sincronização de colaboradores do Ponto para o equipamento do Hikvision.

Comando que você deve enviar na PSW7490 é o108 - SINCRONIZA LISTA FUNCIONÁRIOS REP-P:

Caso o mesmo retornar com o Status Processado OK, você já pode solicitar ao cliente para verificar no equipamento físico do Hikvision se as pessoas já estão lá e iniciar o processo de cadastros de faces, que será realizado pelo cliente.

Você também pode validar via webserver do Hikvision se as pessoas enviadas via o comando na PSW7490 já estão lá.

Auxílios:

Caso você não encontre o comando 108 e outros comandos oriundos do Hikvision que são descritos no manual de instalação citados no item 2.6 - Instalação do serviço do Hikvision REP-P, você deve rodar esse script na base de dados do cliente para inserir esses comandos na tabela TIPOS_COMANDOS_RELOGIOS:

REM INSERTING into TIPOS_COMANDOS_RELOGIOS
SET DEFINE OFF;
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('1','COPIAR TEMPLATE INDIVIDUAL - PARM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('2','COPIAR TEMPLATE PERFIL - PARM = COD_PERFILS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('3','COPIAR TEMPLATE TODOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('4','RECONECTAR EQUIPAMENTO OFF-LINE/ON-LINE');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('5','CADASTRAR TEMPLATE INDIVIDUAL - PARM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('11','INCLUIR TEMPLATE INDIVIDUAL - PARM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('12','INCLUIR TEMPLATE PERFIL - PARM = COD_PERFIL');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('13','INCLUIR TEMPLATE TODOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('15','ENVIAR LISTA DE PESSOAS - CONTROLID FLEX');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('16','REQUISITAR DADOS DO DISPOSITIVO - CONTROLID');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('17','CARREGAR LISTA DE CARTÕES - CONTROLID');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('18','ENVIAR CONFIGURAÇÕES - CONTROLID');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('21','EXCLUIR TEMPLATE INDIVIDUAL - PARM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('22','EXCLUIR TEMPLATE PERFIL - PARM = COD_PERFIL');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('23','EXCLUIR TEMPLATE TODOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('30','SINCRONIZAR DATA E HORA - ACESSO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('31','ATUALIZAR HORÁRIO DE VERÃO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('32','CARREGAR LISTA DE SIRENES');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('33','EXCLUIR LISTA DE SIRENES');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('35','CARREGAR LISTA DE VALIDACAO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('40','ATUALIZAÇÃO DE FIRMWARE - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('41','ATUALIZAÇÃO DE CONFIGURAÇÃO - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('50','ENVIAR LISTA BRANCA - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('51','EXCLUIR LISTA BRANCA - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('52','INCLUIR LISTA DE BLOQUEIO - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('53','EXCLUIR LISTA DE BLOQUEIO - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('54','ENVIAR LISTA DE EMPREGADOS - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('55','EXCLUIR LISTA DE EMPREGADOS - DIGICON');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('56','CONSULTAR STATUS DA LISTA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('57','REQUISITAR STATUS DO DISPOSITIVO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('58','BLOQUEAR DISPOSITIVO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('59','DESBLOQUEAR DISPOSITIVO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('60','ATIVAR MODO DE EMERGÊNCIA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('61','DESATIVAR MODO DE EMERGÊNCIA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('62','ATUALIZAR SERVIDOR DFS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('63','VERIFICA LISTA BIOMETRICA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('64','CARREGA LISTA DE FUNÇÕES PARA RESERVA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('65','HORARIO DE VERÃO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('67','OBTER STATUS DAS SAÍDAS DIGITAIS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('68','ATIVAR SAÍDA DIGITAL');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('69','DESATIVAR SAÍDA DIGITAL');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('100','SINCRONIZAR DATA E HORA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('101','HORÁRIO DE VERÃO PROGRAMAR - PARAM = DT_INI DT_FIN');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('102','REPOSICIONA PONTEIRO - PARAM = NSR');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('103','REQUISITA BACKUP DE REGISTROS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('105','ENVIA SUPERVISOR PARA REP - MADIS/DIMEP');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('106','ENVIA SUPERVISOR/RESPONSAVEL DCLOCK');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('108','SINCRONIZA LISTA FUNCIONÁRIOS REP-P');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('110','COPIAR BIOMETRIA BANCO DE DADOS - PARAM = COD_FUNC');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('111','ENVIAR BIOMETRIA REP - PARAM = COD_FUNC');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('112','EXCLUIR BIOMTERIA REP - PARAM = COD_FUNC');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('113','VERIFICAR FUNCIONÁRIO REP - PARAM = COD_FUNC');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('114','EXCLUIR TODOS OS TEMPLATES - CODIN');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('115','EXCLUIR TODOS OS TEMPLATES SEM PIS - MADIS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('116','SINCRONIZAR FUNCIONÁRIOS NO REP - ZPM');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('117','SINCRONIZAR CONFIGURAÇÕES DO REP - INNER');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('118','COPIAR SENHA BANCO DE DADOS INNER REP');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('119','TRATAR CADASTRO BIOMETRIA NO REP');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('120','EXCLUI FUNC REP - PARAM = COD_FUNC / MATRICULA REP');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('121','CÓPIA AUTOMÁTICA NOVA BIOMETRIA P/ BANCO DE DADOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('130','COPIAR FACE BANCO DE DADOS - PARAM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('131','ENVIAR FACE EQUIPAMENTO - PARAM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('132','EXCLUIR FACE EQUIPAMENTO - PARAM = COD_PESSOA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('200','HIKVISION - SINCRONIZAR DATA E HORA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('201','HIKVISION - ENVIAR LISTA DE PESSOAS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('202','HIKVISION - EXCLUIR LISTA DE PESSOAS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('203','HIKVISION - ENVIAR FAIXAS HORÁRIAS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('204','HIKVISION - EXCLUIR FAIXAS HORÁRIAS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('205','HIKVISION - SINCRONIZAR CONFIGURAÇÕES');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('206','HIKVISION - ENVIAR LISTA DE VEÍCULOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('208','HIKVISION - COLETAR BACKUP EVENTOS - PARAM = DATA');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('210','HIKVISION - COPIAR FACE BANCO DE DADOS');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('211','HIKVISION - ENVIAR FACE AO EQUIPAMENTO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('212','HIKVISION - EXCLUIR FACE DO EQUIPAMENTO');
Insert into TIPOS_COMANDOS_RELOGIOS (COD_COMANDO,DESCR_COMANDO) values ('213','HIKVISION - VERIFICAR USUÁRIO NO EQUIPAMENTO');
COMMIT;

Erros e dúvidas:

Caso o comando 108 não seja processado e fique como pendente na PSW7490, você deve verificar nos logs do serviço do Hikvision e na API do Hikvision se não tem algum erro retornando por lá, isso lhe dará uma melhor ótica para verificar qual problema possa ser.

Caso o comando seja processado, mas retorne a mensagem de Nenhum Usuário Processado pela API, você deve verificar se todas as parametrizações anteriores foram realizadas corretamente dentro do Ponto Soft.

Há select que o Ponto Soft realiza para enviar essa pessoa para o equipamento do Hikvision:

select fpp.cod_funcionario id
                 , fpp.cpf
                 , rsa.cod_cartao
                 , fpp.nome_funcionario
                 , fpp.cod_pessoa
                 , (case when (select max(bpa.data_vigencia)
                                from biometrias_pessoas_acessos bpa
                                where bpa.cod_pessoa = fpp.cod_pessoa
                                      and bpa.tipo_biometria = 'Hikvision'
                                      and bpa.data_vigencia <= sysdate
                                      and (bpa.data_fim_vigencia is null or bpa.data_fim_vigencia > sysdate)
                               ) is not null then 'S' else 'N' end) biometria_facial
                 , (case when (select max(bpa.data_vigencia)
                                from biometrias_pessoas_acessos bpa
                                where bpa.cod_pessoa = fpp.cod_pessoa
                                      and bpa.tipo_biometria = 'HikvisionD'
                                      and bpa.data_vigencia <= sysdate
                                      and (bpa.data_fim_vigencia is null or bpa.data_fim_vigencia > sysdate)
                               ) is not null then 'S' else 'N' end) biometria_digital
              from rep_setores_acessos rsa
                 , funcionarios_parametros_pontos fpp
                 , relogios rel
                 , empregadores_rep_p erp
              where fpp.cpf is not null
and fpp.cod_funcionario = rsa.cod_funcionario
                and rsa.cod_setor_acesso = rel.cod_setor_acesso
                and rel.cod_relogio = :codRelogio
                and erp.cod_empresa = fpp.cod_empresa 
                and((erp.cod_filial = fpp.cod_filial and fpp.cod_filial is not null)
                        or(erp.cod_filial is null and fpp.cod_filial is null))
                and erp.data_sincronizacao is not null
                and erp.obs_sincronizacao is null
                order by fpp.cod_funcionario , rsa.cod_cartao;

Em caso do retorno de Nenhum Usuário Processado pela API, você pode testar na base de dados do cliente os filtros desse select e tentar descobrir o que está errado.

Caso tudo de certo, após os cadastramentos das faces, você pode pedir para o cliente realizar uma marcação com forma de teste, acompanhando se essa marcação irá integrar corretamente para o Ponto Soft, você pode acompanhar esse fluxo pela a tela PSW9250 - Consulta de Marcações - REP P.

Parabéns ou Boa sorte:

Validando esse último item, a sua instalação do serviço do Hikvision com todas as suas dependências foi finalizada com sucesso, meus parabéns se você chegou até aqui, caso você não tenha esse sucesso, você deve voltar nesse manual e tentar achar o que você fez errado, caso nem esse manual lhe ajude a resolver esse problema, lhe desejo de todo o coração, Boa sorte.