Histórico da Página

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.
• Teremos cadastro de dois parâmetros afim de permitir a utilização ou não deste novo componente
• 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.

Neste período o O Autorizador gravará numa tabela de log o plug-in utilizado pela máquina (Java ou HTML)na tabela CHECKIN a versão do TSA disponibilizada pela TOTVS. A Operadora poderá fazer o acompanhando 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

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

Espeficicação Técnica

Duas propriedades de Sistema irão determinar se o uso do novo componente TSA será ativado. Mesmo que o TSA esteja instalado e funcional, somente será acionado caso as propriedades abaixo sejam configuradas.

/WAC2Web/src/com/totvs/saude/wac/bean/fingerprint/FingerPrintBean.java

    //Indica se ira fazer o uso do applet para biometria

    private boolean usingApplet =

        Boolean.valueOf(System.getProperty("com.totvs.saude.wac.bean.fingerprint.usingApplet", "true"));

    //Indica se ja realizou a verificacao do componente TSA

    private boolean verifyTSA =

        Boolean.valueOf(System.getProperty("com.totvs.saude.wac.bean.fingerprint.verifyTSA", "true"));;

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

 

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

 

Image Added

 Image Removed

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)

 

 

 

Fluxo do processo

 

Image Removed

 

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.

 Obs: Nesta versão 12.1.11 não esta disponivel a verificação de versão do componente TSA