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.

O Autorizador gravará na tabela CHECKIN a versão do TSA utilizada pela máquina no momento da leitura. A Operadora poderá fazer o acompanhando deste log os plug-ins utilizados.

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.

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"));

Na entidade CheckinData deverá ser criado um atributo denominado biometryVersion (String) onde irá armazenar a versão do TSA utilizada para a captura da biometria. 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 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 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 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

Fluxo do processo

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