ER_TTKGL1_Autorizador_Biometria_TSA

Informações Gerais

Objetivo

O objetivo deste documento é descrever onde será aplicada a utilização do componente TSA em diferentes sistemas operacionais e navegadores web disponíveis. Os requisitos necessários para ter a funcionalidade que tem por objetivo principal, eliminar a dependência do plug-in Java no navegador.

“TOTVS Smart Agent HTTP Service” denominado simplesmente como TSA, é um componente desenvolvido pela TOTVS para permitir a comunicação via Web aos dispositivos de hardware instalados na máquina do usuário. A comunicação ocorre via mensagens HTTP, ou seja, o TSA é um serviço Windows que inicia um micro servidor Web para receber as requisições. Este serviço local por sua vez, se comunica diretamente com o hardware através de Api’s de alto nível.

Este documento descreve como deverá ser implementada esta solução no módulo Autorizador WEB

Obs: O TSA para esta versão do Autorizador, esta homologado apenas para o leitor biométrico Nitgen Hamster

Definição da Regra de Negócio 

• Implementação do novo componente de biometria da TOTVS que utiliza a tecnologia javascript/json/rest para comunicação, eliminando a necessidade de utilização de Java Applet.
• Ajuste da tela de Checkin atual para utilização deste novo componente.
• Não deverá haver grande impacto visual para o usuário, pois manterá a interface do Checkin ficando mais simples e ágil.
• Deve ser fácil de instalar e atualizar.
• O Autorizador fará a validação do plug-in HTML antes de ativar o plugin do Java.
• A instalação do componente será feita pela Operadora presencialmente/remotamente ou via comunicado aos prestadores.
• A validação de uso do novo componente se dará da seguinte forma:
  • Se existir -> utiliza o Plug-in HTML TSA.
  • Se não existir -> o Autorizador utiliza JAVA e pode reclamar da ausência ou desatualização do JAVA. Lembrando que apenas o navegador Internet Explorer possui suporte a Applets.

O Autorizador gravará na tabela CHECKIN a versão do TSA disponibilizada pela TOTVS. A Operadora poderá fazer o acompanhamento deste log e os plug-ins utilizados. Caso seja utilizado o Applet para captura, não será gravada nenhuma informação no registro do Checkin e, caso for realizada a captura com o TSA, será gravada a versão atual disponibilizada pela TOTVS.

Casos de Teste

Obs: O plugin java atualmente só funciona com o Internet Explorer. Outros navegadores atualizados não estão mais dando suporte ao plugin Java. Portanto o TSA será a unica alternativa.

Especificação Técnica

Na entidade CheckinData deverá ser criado um atributo denominado biometryVersion (String), onde irá armazenar a versão do TSA disponibilizada pela TOTVS. Caso este atributo seja nulo, indica que o Applet Java foi utilizado.

Alteração na página de propriedades do Sistema

Deverá ser disponibilizado um link no TDN para instalação do novo componente, assim como um manual de instruções para o usuário.

Outros arquivos a serem alterados:

/WAC2Web/WebContent/js/functions.js

/WAC2Web/WebContent/pages/biometry/authenticateFingers.xhtml

/WAC2Web/WebContent/pages/biometry/capture.xhtml

/WAC2Web/WebContent/pages/biometry/totvsTecBiometry.xhtml

/WAC2Web/WebContent/pages/biometry/verify.xhtml

/WAC2Web/WebContent/pages/checkin/checkin.xhtml

/WAC2Web/WebContent/js/ajax.js

D:\Desenv\workspace_wac_11\WAC2Web\WebContent\js\nitgen.js

/WAC2Web/WebContent/js/json2.js

/WAC2Web/WebContent/js/websockets.js

/WAC2Web/WebContent/WEB-INF/totvssmart (Diretorio contendo o instalador e manual de utilização)

Abaixo os diretórios de fontes que sofrerão impacto de alteração:

•    /WAC2Web/WebContent/pages/biometry/
•    /WAC2Web/WebContent/pages/checkin/checkin.xhtml
•    /WAC2Web/src/com/totvs/saude/wac/action/fingerprint/
•    /WAC2Web/src/com/totvs/saude/wac/action/checkin/
•    /WAC2Web/src/com/totvs/saude/wac/bean/checkin/
•    /WAC2Web/src/com/totvs/saude/wac/bean/fingerprint/

Tecnologias envolvidas nesta demanda:
•    Javascript
•    Json
•    Java

Implementação do novo Componente de Biometria TSA

O novo componente de biometria TOTVS não utiliza a tecnologia Java Applet. Ele utiliza a tecnologia JSON com requisições via REST para um servidor web instalado na maquina cliente. Este servidor web fica responsável pela comunicação com o driver do dispositivo e de devolver a camada web requisitante as respostas de autenticação da biometria.

Para esta implementação foi disponibilizado um projeto de exemplo contendo as funções de comunicação com o novo componente, bem como uma página de teste onde é possível fazer o teste da biometria.



Registrar em uma tabela cada utilização de biometria, identificando qual componente foi utilizado e qual prestador/clinica utilizou.

Por fim, será implementado a gravação do log de utilização da biometria, onde deverá ser identificado qual componente foi utilizado e qual prestador/clínica utilizou. Esta tabela será monitorada pelo cliente para saber como estará a utilização do novo plugin e, posteriormente, decretar o fim da utilização do componente atual em Java. Utilizar a tabela existente CHECKIN.