Integrador

Para realizar a integração, verifique os pré-requisitos de instalação do ambiente híbrido, considerando que o Integrador Ronda senior X utiliza o Open JDK 11.

Em seguida, confira os demais requisitos para instalar o Integrador:

1. Instalação do Open JDK 11;
2. Inclusão da variável de ambiente "JAVA_HOME_SAM" com o valor do diretório onde o Open JDK 11 foi instalado. Por exemplo: C:\jdk-11.0.2\ .

Observações

• Os seguintes recursos dependem do RabbitMQ:
  • Gestão de Portarias;
  • Gestão de Terceiros;
  • Sincronismo de Biometrias entre o Ronda Senior e o Ronda senior X.
• Quando a máquina possui uma variável de ambiente JAVA_HOME apontando para uma versão 32 bits do Java, o Integrador acaba tentando utilizá-la também em sua inicialização, o que faz com que o serviço do Integrador não inicie. Nesta situação, utilize o arquivo Integrador.exe que está dentro da pasta 32 Bits do Integrador.

1. Na Senior X, acesse Gestão de Riscos e Segurança > Downloads;
2. Clique em Baixar o Integrador Ronda senior X e extraia a pasta no servidor desejado;
3. Execute o arquivo create-service.bat. Com isso, o serviço SAM-Integrador é criado.

Observação

Caso o Rabbit do cliente seja compartilhado, ou seja, caso utilize o VIRTUAL_HOST, é necessário configurar seu arquivo create-service.bat, alterando a propriedade VIRTUAL_HOST, como no exemplo a seguir:

set VIRTUAL_HOST=senior

Quando o Rabbit não utiliza o VIRTUAL_HOST, deve ficar assim: set VIRTUAL_HOST=/

4. Nos Serviços do Windows, inicie o serviço SAM-Integrador.

Após a instalação do Integrador:

1. No Ronda Senior, acesse Diversos > Assinalamentos > Diversos (FR000ASS) > guia Ronda senior X e:
   1. Defina a opção Integra com o Ronda senior X como Sim;
   2. Marque todas as informações que deseja integrar como Sim.

Observações:

• Se você possui o Gestão de Pessoas | HCM, acesse Diversos > Assinalamentos (FR000ASS) > guia Ronda senior X e defina a opção Integra com o Ronda senior X como Sim. Além disso, no painel Integração, defina Sim para cada tipo de Registro que deseja integrar via Pendências.
• O campo Foto dessa tela do Ronda Senior XT se refere às fotos de todos os tipos de pessoas (colaborador, terceiro, visitante etc.) e ao gerar pendências, tem prioridade aos outros campos da guia, que são para tipos específicos de pessoas. No entanto, o Integrador integra somente as fotos de pessoas que possuem vínculo. Ao definir um certo tipo de pessoa como "Não", por não haver sincronismo desse tipo de pessoa para o Ronda senior X, ela não irá possuir vínculo, e a foto não será sincronizada - mesmo se a integração de fotos como estiver definida como "Sim".

2. No diretório onde o Integrador foi instalado, abra o arquivo config.properties em modo de edição e:
   1. Caso queira definir empresas específicas a serem integradas na carga inicial de Colaboradores, Credenciais/Crachás de Colaboradores, Usuários do Ronda senior X e Suspensões de Papel/Afastamentos, defina seus códigos no parâmetro sync.company.idfilter, separando cada empresa por vírgula. Exemplo: sync.company.idfilter=1,2,5
   2. Para definir filtros e tipo de colaborador no tratamento de pendências, defina seus códigos no parâmetro sync.worker.type.filter, separando os códigos por vírgula. Exemplo: sync.worker.type.filter=1,2,5
   3. Se desejar definir filtros específicos a serem integrados na carga inicial e no tratamento de pendências de empresas e filiais para Credenciais/Crachás de Colaboradores do Ronda Senior, é possível utilizar o parâmetro card.company.branch.filter, deixando os códigos das empresas separados por ponto e vírgula e os das filiais dentro dos colchetes, separados por vírgula. Exemplo: card.company.branch.filter=1[1,2,3,6];2[];3[2];4
   4. Se necessário, altere os valores dos seguintes parâmetros (eles já vêm com valores sugeridos):
      • server.port - identifica a porta do servidor;
      • sync.accessevents.batchsize - define a quantidade de marcações de acesso e ponto tratadas por vez, do Ronda senior X (cloud Senior) para o Ronda Senior (base de dados on-premise). O maior valor possível é 50, pois essa é a quantidade máxima de eventos a serem coletados por lote. O reprocessamento ocorre conforme as marcações são integradas no Ronda senior X, sempre priorizando as primeiras marcações recebidas, independente do dispositivo de origem;
      • sync.pendencies.batchsize - define a quantidade de pendências tratadas por vez;
      • sync.accessevents.frequency - define a frequência de busca de marcações do Ronda senior X (cloud Senior) para o Ronda Senior (base de dados on-premise);
      • sync.photo.blobservice - define se as fotos de colaboradores no sistema Ronda Senior XT são integradas com o Ronda senior X utilizando o blobService (serviço da Senior X para armazenamento de arquivos). Quando uma foto for incluída/alterada em um dos sistemas e essa alteração não for refletida no outro, tente alterar esse parâmetro para verificar se a alteração passa a integrar corretamente;
      • card.technology – define a tecnologia de credencial padrão a ser associada aos crachás atribuídos no Ronda Senior, para os que não tiverem tecnologia atribuída na tela de Pré-Cadastro de Crachás. Os valores possíveis são: 1 – barras; 2 – proximidade; 3 – Smart Card;
      • accessevent.usepersonid - define qual informação será enviada com as marcações de acesso. Se estiver definido como "true" (verdadeiro), o identificador da pessoa é enviado. Caso esteja definido como "false" (falso), envia o número do crachá. O valor padrão é "false". A propriedade possui funcionamento somente para tratamento de pendências;
      • devices.status.sync.timeout - define o tempo para processar as pendências de status de dispositivos. O valor mínimo é 30 e o padrão é 60. A propriedade possui funcionamento somente para tratamento de pendências;
      • devices.status.sync.pendencies.batchsize - define o tamanho do lote de pendências de status de dispositivos. O valor padrão, bem como o valor máximo, é 50. A propriedade possui funcionamento somente para tratamento de pendências;
      • create.credential.facial - indica se existe algum dispositivo de reconhecimento facial habilitado no Ronda senior X. A propriedade possui funcionamento tanto para carga inicial quanto para tratamento de pendências;
      • card.ignoreerrors - indica se a credencial deve ser cadastrada como inativa após falhar na primeira tentativa. A propriedade possui funcionamento tanto para carga inicial quanto para tratamento de pendências;
      • devices.status.as.notification - indica se deve criar uma notificação de evento ao atualizar o status do dispositivo. A propriedade possui funcionamento somente para tratamento de pendências;
      • gas.worker.blockreason - motivo de bloqueio utilizado para bloquear e desbloquear pessoas (deve ser um código válido em R070MBL.CODMOT). Precisa ser utilizado quando o Integrador receber algum request de bloqueio. Neste caso, o código é o identificador do motivo no Ronda Senior XT;
      • gas.worker.block.user - usuário que será utilizado para bloquear pessoas (deve ser um código válido em R999USU.CODUSU). Nesta propriedade, o código do usuário no Ronda Senior XT que será utilizado pelo Integrador quando receber mensagem de bloqueio/desbloqueio de pessoa. Aqui, o Integrador precisa informar ao usuário que executou o bloqueio da pessoa, podendo ser um usuário com o nome de Integrador;
   5. Se desejar integrar com o Gestão de Terceiros, defina os seguintes parâmetros com estes valores:
      • gas.worker.thirdparty.blockreason - Motivo de bloqueio utilizado para bloquear e desbloquear terceiros (deve ser um código válido na tabela R070MBL.CODMOT).
      • gas.worker.thirdparty.block.user - Usuário que será utilizado para bloquear o terceiro (Deve ser um código válido na tabela R999USU.CODUSU);
   6. Defina o parâmetro visitor.photo.integration=true caso deseje integrar a foto do visitante do Gestão de Portarias com o Ronda Senior XT;

   Importante

   • Os demais parâmetros não devem ser alterados no arquivo config.properties; eles devem ser configurados na guia Configurações do Integrador, conforme descrito no passo 5;
   • Os filtros mencionados nos itens acima são usados em cargas iniciais, que consideram os parâmetros definidos. Porém as biometrias são integradas de acordo com as pessoas integradas. Se após a carga inicial, uma pessoa tiver sido integrada, ela seria considerada em sincronismos futuros independente do filtro definido.
3. Acesse o Integrador, abrindo o navegador e informando o servidor e a porta onde ele está configurado (por exemplo: http://localhost:8075);

Importante

Caso as portas 15672 e 5672 não estejam liberadas no firewall, é necessário liberá-las antes de realizar as configurações do ambiente on-premises na Senior X.

4. Na guia Configurações, no painel Informações do Sistema Local:
   • Informe o banco de dados utilizado pelo ambiente on-premises;
   • Em Usuário e Senha, recomenda-se usar os mesmos dados informados na Central de Configurações Senior, em Banco de dados > Ronda Senior. Utilizar outro usuário pode resultar em problemas de integração ou autenticação;
   • O campo URL para conexão JDBC deve conter a mesma informação disponível neste campo na Central de Configurações Senior, em Banco de dados > Ronda Senior;
   • Teste a conexão.
5. Ainda na guia Configurações, no painel Informações do Sistema SAMSenior, você encontrará duas formas de autenticação:
• Por meio de Usuário e Senha para conexão com o sistema. Nesse caso, é necessário que o usuário seja do tipo Administrador no Ronda senior X e possua permissões em todos os recursos do Senior X. É recomendado que o usuário seja específico para uso do Integrador;
• Por meio de Chave de Acesso e o Segredo de Acesso, caso utilize login ADFS. Nesse caso, será possível configurar o integrador do Ronda senior X para que ele não utilize um papel Administrador da Senior X:
  1. Crie um novo papel da Senior X no menu Tecnologia > Administração > Autorização > Gestão dos Papéis, com permissão em todos os recursos lobby, application e third. Essa papel será utilizado pela chave de autenticação;
  2. Crie um novo usuário da Senior X, no menu Tecnologia > Administração > Gestão dos Usuários, e associe-o ao papel criado no passo anterior. Esse usuário será usado no integrador do Ronda senior X;
  3. Crie uma pessoa no Ronda senior X no menu Gestão de Riscos e Segurança > Cadastros Gerais > Pessoas, e associe-a ao login gerado no passo anterior. É importante que esse usuário no Ronda senior X seja colocado como Administrador, conforme a imagem seguinte:

  

  4. Crie uma nova chave de autenticação na Senior X no menu Tecnologia > Administração > Gerenciamento de aplicações, associando o papel criado no passo a;
  5. Acesse as configurações do integrador Ronda senior X e preencha conforme o exemplo da imagem a seguir (os itens em vermelho precisam ser preenchidos):

     

6. Informe o Nome do Tenant Ronda senior X;
7. Informe o Período entre as execuções (em segundos);
8. Selecione a Tecnologia padrão do crachá;
9. Se integrar com o sistema Ronda Senior, marque a opção Tratar pendências para permitir que o Integrador processe as pendências necessárias para envio dos dados para o Ronda senior X. Marque também, na guia Integração, a opção Empresas Terceiras, Contratos e Histórico de Contratos para indicar que estes dados devem ser carregados;

   Importante

   O Integrador irá carregar Outras Empresas quando o contrato estiver cadastrado.

   O Integrador irá carregar os Contratos que estiverem vigentes.

   O Integrador irá carregar os históricos que estiverem vigentes, vinculando o terceiro ao contrato no Ronda senior X.

10. Teste a conexão;
11. Caso haja integração entre o Ronda Senior e a Gestão de Portarias ou Gestão de Terceiros, preencha as informações do RabbitMQ On Premise: Usuário, Senha e Endereço de conexão;
12. Clique no botão Salvar.

Acesse a documentação da Portaria remota para todas as informações.

1. No Integrador, acesse a guia Integração;
2. Selecione quais informações deseja integrar;
3. Clique em Processar;
4. O sistema mostrará os Registros com erro, os Registros enviados e o Status. Havendo registros com erros, é possível consultar quais são eles através do botão Detalhes, que abre um log.

Ordem da carga inicial:

• Diversos: Locais Físicos;
• Dispositivos: Dispositivos;
• Colaboradores: Pessoas;
• Colaboradores: Crachás/Credenciais Colaboradores;
• Dispositivos: Permissões;
• Colaboradores: Permissão/Associação de papel;
• Colaboradores: Afastamentos/Suspensões de papel;
• Colaboradores: Escalas/Faixas de acesso;
• Colaboradores: Bloqueio Temporário;
• Diversos: Portarias;
• Diversos: Feriados;
• Visitantes: Visitantes;
• Visitantes: Tipo de visita;
• Visitantes: Crachás/Credenciais;
• Alunos: Alunos;
• Alunos: Crachás/Credenciais Alunos;
• Responsáveis Aluno: Responsáveis Aluno;
• Responsáveis Aluno: Crachás/Credenciais Responsáveis Aluno;
• Pacientes: Pacientes;
• Pacientes: Crachás/Credenciais Pacientes;
• CFTV: Servidores CFTV;
• CFTV: Câmeras CFTV;
• Estrutura Organizacional: Empresas;
• Estrutura Organizacional: Filiais;
• Estrutura Organizacional: Cargos;
• Estrutura Organizacional: Centros de Custo;
• Estrutura Organizacional: Locais do Organograma;
• Estrutura Organizacional: Outras Empresas;
• Estrutura Organizacional: Contratos;
• Diversos: Usuários;
• Diversos: Fotos;
• Diversos: Pessoa não grata;
• Biometrias.

Estes são os registros enviados do Ronda Senior para o Ronda senior X:

Para realizar a integração de faixas horárias do Ronda senior X, realize os passos a seguir:

1. No Ronda Senior XT, acesse Pessoas > Colaboradores > Empregados/Terceiros/Parceiros > guia Acesso;
2. No campo Controla Faixa Horária, na guia Acesso marque a segunda opção Verifica somente faixa de acesso;
3. No Ronda Senior XT, acesse Diversos > Assinalamentos > Diversos;
4. Marque 'Sim' no campo Escala;
5. Execute a carga Inicial do Integrador SAM novamente, para importar as informações sobre Faixa Horária.

É possível consultar todos os detalhes sobre o processo em Faixas Horárias.

As pendências garantem que as informações continuem sendo integradas do Ronda Senior para o Ronda senior X, quando há adições, edições ou exclusões. Elas só não se aplicam para Servidores e Câmeras CFTV e Portarias.

Para que as pendências sejam geradas, acesse a guia Configurações e marque a opção Tratar Pendências.

Para que os cadastros de empresas terceiras e contratos sejam efetuadas, deve-se definir isso no sistema Ronda senior X. Esta configuração é feita nos cadastros de empresas terceiras e contratos, respectivamente, marcando a opção Integrado com Ronda Senior em cada uma destas telas.

Gere pendências manuais para atribuir papéis a pessoas, através do Ronda Senior ou do Gestão de Pessoas | HCM. Para isso, implemente uma regra para gerar a pendência que será tratada pelo Integrador.

Existem dois tipos dessa pendência: uma em que se fornece a data e a hora de início e término da associação, e outra que não necessita dessas informações. Quando gerada a pendência sem a data e a hora de início e término, será inserida a associação com a data e a hora atual para o início e sem data e hora de término.

Exemplo de regra contendo os dois tipos da pendência:

definir alfa aParametros;
definir alfa aRetorno;
definir alfa aNumEmp;
definir alfa aTipPes;
definir alfa aTipCol;
definir alfa aNumCad;
definir alfa aIdtPes;
definir alfa aNomePapelSAM;
definir alfa aIdRegister;
definir alfa aDataInicial;
definir alfa aHoraInicial;
definir alfa aDataFinal;
definir alfa aHoraFinal;
definir alfa aPapelUsoProvisorio;

/*Converte os valores para ficar com a quantidade de dígitos necessários.*/
ConverteNumero(R034FUN.NumEmp, "9999", "numero", aNumEmp);
ConverteNumero(R034FUN.TipCol, "99", "numero", aTipPes);
ConverteNumero(R034FUN.TipCol, "9", "numero", aTipCol);
ConverteNumero(R034FUN.NumCad, "999999999", "numero", aNumCad);

/*Coloca espaços para completar os 23 caracteres necessários para o idtpes de colaborador.*/
aIdtPes = "        " + aTipPes + aNumEmp + aTipCol + aNumCad;

/*Nome do papel no Ronda senior X que deseja atribuir para a pessoa.*/
aNomePapelSAM = "Usuário de REP";

/**************************************************************************
Associação de papel para a pessoa.
Datagrama: 23 dígitos - identificador da pessoa (idtpes)
           Sem limite dígitos - nome do papel
**************************************************************************/
aIdRegister = aIdtPes + aNomePapelSAM;

/*******************************************************************************************************
Associação de papel para a pessoa com data e hora de início e término.
Datagrama: 23 dígitos - identificador da pessoa (idtpes)
           08 dígitos - data inicial, formato: ddmmaaaa, exemplo: 15/08/2019 = 15082019
           04 dígitos - hora inicial em minutos, exemplo: 08:00 = 0480
           08 dígitos - data final, formato: ddmmaaaa, exemplo: 31/08/2019 = 31082019. Data zerada (sem data final) deve ser: 31121900
           04 dígitos - hora final, exemplo: 18:00 = 1080
           01 dígitos - papel de uso provisório: S ou N
           Sem limite dígitos - nome do papel
******************************************************************************************************/
aDataInicial = "15082019"; /*Data início: 15/08/2019*/
aHoraInicial = "0480"; /*Hora início: 08:00*/
aDataFinal = "31082019"; /*Data término: 31/08/2019*/
aHoraFinal = "1080"; /*Hora término: 18:00*/
aPapelUsoProvisorio = "N";

aIdRegister = aIdtPes + aDataInicial + aHoraInicial + aDataFinal + aHoraFinal + aPapelUsoProvisorio + aNomePapelSAM;

/*
Monta os parâmetros para passar para a stored procedure. Pode escolher qual tipo de pendência gerar, passando ou não a data e hora de início e término para a associação do papel. Para isto, basta seguir o datagrama escolhido.

6 = Rotina de associação de papel para pessoa
1 = Operação (1 - Inserir, 2 - Alterar, 3 - Excluir)
Observação: Para o IdRegister que não passa a data e hora de início e término, só estão disponíveis as operações 1 e 3.
*/
aParametros = "6, 1, " + aIdRegister;

/*Executa a stored procedure SP_SAM_PENDENCIES que insere a pendência na tabela para o Integrador processar.*/
ExecSP("SP_SAM_PENDENCIES", aParametros, aRetorno);

São estes os registros que o Ronda Senior envia para o Ronda senior X:

Realize a integração de todos os itens do Controle de Portaria do Ronda Senior para o Gestão de Portarias do Ronda senior X. Para mais informações, consulte a documentação do Integrador do Gestão de Portarias.

Integre as informações do Controle de Terceiros do Ronda Senior para o Gestão de Terceiros do Ronda senior X. Saiba mais na documentação do Integrador do Gestão de Terceiros.

1. No integrador, clique na guia Pendências;
2. No painel Consulta, utilize os filtros de datas e defina qual Rotina quer verificar e clique em Filtrar;
3. O painel Lista de pendências com erro pode exibir uma mensagem informando que não foi encontrada nenhuma pendência com erro ou então exibir aquelas que têm erro. Nesse caso:
   1. Clique sobre a pendência listada e veja a descrição do erro;
   2. Trate o problema apontado no Ronda Senior;
   3. Marque a caixa de seleção da coluna Reenviar na(s) pendência(s) tratada(s);
   4. Clique em Reenviar e aguarde o aviso de reenvio com sucesso.

O botão Migrar para Ronda X permite a migração dos dispositivos do Ronda Senior XT para o Ronda senior X, transferindo os dados existentes e possibilitando realizar todas as operações no Ronda senior X. Ao fazer a migração, os dispositivos filhos também são migrados, o que desativa a possibilidade de selecionar diretamente o dispositivo pai no integrador.

Ao clicar no botão Tipo de migração, é possível escolher entre duas opções:

• Manter offline no Ronda Senior XT (opção padrão): ao optar por essa ação, o dispositivo será migrado permanentemente para o Ronda senior X, deixando o dispositivo em estado offline no Ronda Senior XT, totalmente operável no Ronda senior X, mas mantendo o link entre os cadastros do Ronda senior X e XT. Essa ação possibilita que eventos (acesso ou marcação de ponto) realizadas no Ronda senior X, ainda sejam enviadas para o ambiente XT.
• Desativar no Ronda Senior XT: o dispositivo será migrado permanentemente para o Ronda senior X, desativando-o do Ronda Senior XT. Assim, todas as operações serão realizadas exclusivamente no Ronda senior X.