...
- Visão Geral
- Exemplo de utilização
- Procedimentos para Implantação
- Procedimentos para Configuração
- Configuração dos Parâmetros de Integração Reconhecimento Facial
- Configuração para habilitar o Cadastro da Biometria
- Configuração para Habilitar a Alteração da Biometria
- Configuração de Importação de Certificado
- Procedimentos para Utilização
- Seleção da Biometria Facial
- Cadastro da Biometria Facial
- Validação da Biometria Facial
- Atualização da Biometria Facial
- Remoção da Biometria Facial
- Outras Ações / Ações relacionadas
- Tela Registro de Biometria
- Outras Ações / Ações relacionadas
- Tela Validação de Validação da Biometria
- Outras Ações / Ações relacionadas
- Tela XXXValidação Realizada com Sucesso
- Outras Ações / Ações relacionadas
- Tela Alterar Biometria CadastradaPrincipais Campos e Parâmetros
01. VISÃO GERAL
As implementações descritas neste documento correspondem a alteração do layout da tela de Identificação do Beneficiário no módulo Autorizador WEB para utilização do Reconhecimento Facial.
Aviso |
---|
Para o total funcionamento da Reconhecimento Facial, é necessário que a versão do Progress do Appserver Autorizador esteja na versão mínima recomendada pela TOTVS, que é a 11.7.5. Essa informações já foi encaminhada na data 20/05/2020 para os clientes TOTVS. Qualquer inconsistência sobre a versão do seu Progress, deve ser acionado o suporte da Progress. |
02. EXEMPLO DE UTILIZAÇÃO Âncora |
---|
| exemplo_utilizacao |
---|
| exemplo_utilizacao |
---|
|
Para utilizar é necessário realizar os passos da implantação e configuração.
Procedimentos para Implantação
A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.
O pacote está disponível no portal (https://suporte.totvs.com/download) e também na console de atualização.
Procedimentos para Configuração
i. Configuração dos Parâmetros de Integração Reconhecimento Facial Âncora |
---|
| parametros_integracao |
---|
| parametros_integracao |
---|
|
No programa Central de Integração Saúde Planos (hgp.integrationsParams) há um cadastro de reconhecimento facial que possibilita o registro referente ao sistema de integração para reconhecimento facial.
Nele serão informados o Sistema de Integração, a URL da API, o Token e a Acuracidade Aceitável.
As URL's disponíveis se encontram na página de Ambientes de Integração da Biodoc . Segue abaixo as opções disponíveis para serem configuradas no sistema:
URL | Ambiente de Homologação | Ambiente de Produção |
---|
API’s | https://api.sandbox.biodoc.com.br/ | https://api.biodoc.com.br/ |
- O Token para integração deve ser obtido no canal de suporte da equipe Biodoc, através do endereço https://biodoc.atlassian.net/servicedesk/customer/user/login
Image Added
Mais informações sobre esse programa em: DT Central de Integrações Saúde Planos - (hgp.integrationsParams).
ii. Configuração para habilitar o Cadastro da Biometria Âncora |
---|
| configuracao_cadastro |
---|
| configuracao_cadastro |
---|
|
Necessário cadastrar as propriedades "com.totvs.saude.wac.biometry.newPage" e "com.totvs.saude.wac.checkin.newPage" ambas como "true" para utilizar a nova página de biometria.
Foi adicionado um novo label Permite Biometria Facial no programa Manutenção Associativa Prestador x Clínica (AC0210H) para habilitar biometria facial. Quando parametrizado como Sim será apresentado a biometria facial. E quando parametrizado o campo Permite Biom.Facial Intercambio, passa apresentado a biometria facial para beneficiários de intercâmbio.
Image RemovedImage Added
Também é necessário alterar a configuração da Manutenção Associativa Processos x Anexos (hcg.associativeProcessAttachments), no item "11 - Autorizador", deve ser habilitado o armazenamento a opção “Armazenamento dos anexos” e informado o tipo de anexo escolher uma opção em “Tipo de Armazenamento”.
Image Added
Após as definições acimas realizadas, deve ser informado no "Tipo de Anexo" a informação que contenha ".PNG" para guardar a imagem capturada pela webcam do beneficiário.
Image Modified
Na configuração do propath do appserver utilizado no autorizador é necessário informar biblioteca OpenEdge.Net.pl para o correto funcionamento das integrações utilizadas para validar a biometria facial.
Informações |
---|
Caso não apareça outras associativas em "Manutenção Associativa Processos x Anexos" além do "1 - Tipo de Anexo Padrão" ou a opção "11 - Autorizador", deve ser executado a SPP SPCG034. Mais informações sobre a SPP: DT Gerenciador de Anexos e posteriormente cadastrado os "Tipos de Anexo" no programa hcg.attachmentType. |
Aviso |
---|
Necessário parametrizar no programa Manutenção de Parâmetros Web (hac.webparams) a faixa etária que capturar a biometria facial. Caso o beneficiário não esteja na faixa etária não será apresentado em tela a biometria facial para cadastro ou validação. |
iii. Configuração para Habilitar a Alteração da Biometria Âncora |
---|
| atualizacao_configuracao |
---|
| atualizacao_configuracao |
---|
|
Foi criado um novo campo no menu Manutenção de Secretários(as) (hat.secretary) onde é possível parametrizar se o(a) secretário(a) terá permissão para alterar a foto referência da biometria facial do beneficiário.
Image Added
Ao editar o cadastro de secretária é necessário acessar a aba Clínicas Associadas, conforme imagem abaixo:
Image Added
Ao editar a clínica desejada é exibido em tela a Associativa de Secretario(a) x Clínica, contendo o novo parâmetro Permitir Alterar Biometria:
Image Added
Além disso foram criadas 2 novas propriedades: com.totvs.saude.wac.changeBiometry e com.totvs.saude.wac.biometry.validateBeforeUpdate, sendo:
- com.totvs.saude.wac.changeBiometry: Propriedade que define se será possível atualizar a biometria facial do beneficiário caso o(a) secretário(a) tenha permissão.
- com.totvs.saude.wac.biometry.validateBeforeUpdate: Propriedade que define se será validado a imagem do beneficiário antes de realizar a atualização.
A primeira propriedade listada é obrigatória para possibilitar a alteração da foto referência pela secretária, sem esta propriedade ativa o botão de alterar a foto referência não será habilitado. A segunda propriedade quando não cadastrada permite a alteração da foto referência sem qualquer tipo de validação a fim de verificar se a foto capturada trata-se do beneficiário em questão, ou seja, é possível alterar a foto do beneficiário por qualquer imagem.
iv. Configuração de Importação de Certificado
Para utilizar a biometria facial é necessário realizar a importação do certificado https do sistema de integração que está sento utilizado.
Aviso |
---|
A não importação do certificado poderá causar a seguinte mensagem em tela: Erro: Erro ao Integrar Nenhuma reposta obtida. |
Certificado Biodoc:
View file |
---|
name | CertificadosBiodoc.zip |
---|
height | 250 |
---|
|
Aviso |
---|
Não é necessário efetuar a instalação dos certificados em anexo pelo "proenv", conforme consta na TDN Autorizador Reconhecimento Facial. Os certificados em anexo devem ser inseridos na pasta "certs" . |
No documento Importação de certificados Https pode ser visualizado o passo a passo de como realizar a importação do certificado acima ou obter certificados de outros links https e efetuar a importação.
Procedimentos para Utilização
Aviso |
---|
Para a utilização dessa funcionalidade é necessário utilizar o autorizador com https Além disso, essa funcionalidade não é compatível com nenhuma versão do Internet Explorer. |
1.
...
Seleção da Biometria Digital
Com a parametrização do programa ac0210h AC0210H é apresentada a biometria facial junto a biometria digital. São disponibilizados dois botões. Quando não houver a biometria facial cadastrada será habilitado o botão Cadastrar Biometria Facial:
Caso haja a biometria cadastrada será habilitado apenas o botão de Validar Biometria:
Informações |
---|
Para saber os procedimentos de configuração e utilização da Biometria Digital acessar a documentação: DT (Autorizador) - Autenticação Biometria Digital |
2.
...
Cadastro da Biometria Facial
Ao clicar no botão Cadastrar Biometria Facial será aberto um pop-up onde poderá ser selecionada a câmera que deverá ser utilizada para capturar a imagem:
Nota |
---|
É necessário permitir a utilização da câmera quando realizada validação por seu respectivo navegador. |
Ao clicar no botão Capturar Imagem será retornada a imagem capturada e dois botões o Tentar Novamente e o Salvar:
Image Modified
O botão Tentar Novamente retorna a tela de seleção da câmera e novamente aparece a imagem para capturar.
Image Modified
O botão Salvar salva a imagem que foi capturada e redireciona para a tela do usuário:
3.
...
Validação da Biometria
Ao clicar no botão Validar Biometria será aberto um pop-up onde poderá ser selecionada a câmera que deverá ser utilizada para capturar a imagem:
Image Modified
Ao clicar no botão Capturar Imagem será retornada a imagem capturada e dois botões o Tentar Novamente e o Validar:
Image Modified
O botão Tentar Novamente retorna para a tela de seleção da câmera e captura, assim como no registro da biometria facial.
O botão Validar, valida a imagem capturada com imagem de referência que foi salva durante o cadastro. Caso o beneficiário seja identificado será retornado na tela a foto capturada e a foto de referência e dois botões o Atualizar foto de referência pela atual e o Continuar com Atendimento.
Image Modified
Informações |
---|
A validação leva em consideração a similaridade da imagem capturada com a imagem de referência. Essa similaridade considera uma porcentagem mínima que é parametrizada no campo Acuracidade Aceitável presente na aba de Reconhecimento Facial do programa Central de Integração Saúde Planos (hgp.integrationsParams). Dessa forma se a similaridade for menor que a informada no programa será apresentada uma mensagem de erro e ficará disponível a tela de captura de imagem com o botão de Tentar Novamente.
|
O botão Atualizar foto de referência pela atual altera a foto de referência da validação pela foto que foi capturada:
Image Modified
O botão Continuar com Atendimento, fecha o pop-up e redireciona para a tela com as informações do usuário:
...
04.
...
Atualização da Biometria Facial
Caso seja necessário atualizar a foto referência do beneficiário, através desta funcionalidade é possível realizar a atualização da foto.
Ao informar a carteira de um beneficiário que já possua uma foto referência salva, é habilitado o botão Alterar Biometria Cadastrada. Segue abaixo demonstração do processo:
Image Added
05. Remoção da Biometria Facial
Caso seja necessário remover a biometria facial que foi cadastrada, é necessário realizar login como Administrador do Sistema.
Dessa forma na barra lateral é apresentada a opção de Remover Biometria. Ao clicar e informar a carteira do beneficiário será apresentada se há alguma biometria cadastrada (seja facial ou digital).
Caso haja cadastro biométrico, apresentará as opções e o botão de excluir de cada biometria.
Image Added
03. TELA
...
SELEÇÃO DA CÂMERA Âncora |
---|
| tela_selecao_camera |
---|
| tela_selecao_camera |
---|
|
Image Added
Outras
...
Ações / Ações relacionadas
Ação | Descrição |
---|
Selecionar | No tela de seleção da câmera está disponível um botão para selecionar qual câmera será usada para capturar a imagem. |
Capturar Imagem | Responsável por capturar a imagem de câmera e retornar a imagem que foi capturada em tela. |
04. TELA
...
Principais Campos e Parâmetros
...
Card documentos |
---|
Informacao | Use esse box para destacar informações relevantes e/ou de destaque. |
---|
Titulo | IMPORTANTE! |
---|
|
REGISTRO DE BIOMETRIA Âncora |
---|
| tela_registro_biometria |
---|
| tela_registro_biometria |
---|
|
Image Added
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Tentar Novamente | Retorna para a seleção de câmera para capturar a imagem novamente. |
Salvar Imagem | Salva a imagem capturada como foto referência do beneficiário |
05. TELA VALIDAÇÃO DE BIOMETRIA Âncora |
---|
| tela_validacao_biometria |
---|
| tela_validacao_biometria |
---|
|
Image Added
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Tentar Novamente | Retorna para a seleção de câmera para capturar a imagem novamente. |
Validar | Valida se a pessoa da imagem capturada corresponde à pessoa da foto referência. |
06. TELA VALIDAÇÃO REALIZADA COM SUCESSO Âncora |
---|
| tela_validacao_sucesso |
---|
| tela_validacao_sucesso |
---|
|
Image Added
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Atualizar foto de referência pela atual | Atualiza a foto de referência do beneficiário pela foto capturada. |
Continuar com Atendimento | Fecha a tela de validação e retorna para o checkin, contendo os dados do beneficiário. |
07. TELA ALTERAR BIOMETRIA CADASTRADA Âncora |
---|
| tela_alterar_biometria_cadastrada |
---|
| tela_alterar_biometria_cadastrada |
---|
|
Image Added
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Capturar Imagem | Responsável por capturar a imagem de câmera e retornar a imagem que foi capturada em tela. |
Image Added
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Tentar Novamente | Retorna para a seleção de câmera para capturar a imagem novamente. |
Salvar Nova Imagem | Atualiza a foto de referência do beneficiário pela foto capturada. |
...
HTML |
---|
<!-- esconder o menu -->
<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;
}
</style>
|
...