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.

O Autorizador gravará na tabela CHECKIN a versão do TSA utilizada pela máquina no momento da leituradisponibilizada 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

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)

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 um pagina uma página de teste onde é possível fazer o teste da biometria.
A primeira etapa deste desenvolvimento será implementar as funções de comunicação do novo componente dentro da tela de biometria, para que seja testada a leitura/validação da biometria com o componente novo.
Posteriormente iremos avançar nos requisitos, onde iremos implantar o redirecionamento do novo componente na tela de cadastro de digitais e demais telas envolvidas.
Implementar validação do novo componente
Após estes passos deverá ser feito controle/ validação da instalação do plugin de biometria novo. Caso o mesmo não tenha sido instalado deverá ser redirecionado para o componente de biometria atual.



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/clinica clínica utilizou. Esta tabela será monitorada pelo cliente para saber como estará a utilização do novo plugin e, e posteriormente, decretar o fim da utilização do componente atual em Java. Utilizar a tabela existente CHECKIN.

Fluxo do processo

Image Removed

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