Visão Geral
Esta documentação tem como objetivo orientar sobre a funcionalidade NO DAT no Clockin Mobile.
O que é o NO DAT?
O NO DAT consiste em mudanças nos aplicativos Mobile para possibilitar a melhoria do reconhecimento facial. Atualmente o processo de reconhecimento envolve a leitura de dados da imagem do funcionário em um arquivo de imagens com extensão "DAT" para o reconhecimento facial.
O fluxo atual do reconhecimento foi modificado para que essa leitura de dados da imagem seja feita através de consulta em banco de dados dentro do próprio aplicativo.
Os dados de imagem gerados para que seja feito o reconhecimento facial são chamados de hashes de imagem que nada mais é do que a codificação dos pontos da face da pessoa.
Com essa nova funcionalidade a geração de Arquivo DAT (nome do processo na Carol - generate_dat_file) foi substituída pelo processo de Geração de Hashes (nome do processo na Carol - hash_db).
Alguns pontos a liberação do NO DAT:
- O NO DAT estará disponível a partir de junho de 2023, na versão 12.1.23030000 ou superior.
- A atualização poderá ser feita através da loja de aplicativos (Google Play para dispositivos Android e App Store para dispositivos IOS);
- A funcionalidade estará disponível para a versão Mobile.
Quais são os Benefícios do NO DAT?
Como fazer para habilitar e efetuar a geração do novo processo de geração de hashes ?
A Geração dos Hashes é feita por um processo da Plataforma Carol, o processo chama-se “hash_db”, é executado através de agendamento. Para acessar, selecionar Carol Apps, e depois “TOTVS RH Clockin BackOffice”. Conforme print abaixo na Aba Process, temos o processo “hash_db”:
Após a execução do mesmos, os hashes das imagens são gerados.
Como Consultar os hashes gerados na plataforma ?
Os hashes gerados são facilmente visualizados através do Data Model Hashes. No Menu lateral esquerdo clica-se em Data Models, para escolher a opção Hashes. Segue abaixo um descritivo do que significa cada campo do Data Model Hashes:
- Image Sequence: é a sequencia de imagem do Data Model Imagem
- Source: qual é a origem do Hash. Aqui podemos ter a origem Clockin que significa que o hash veio de uma marcação. Tmbém podemos ter "hr" que significa que o hash veio de uma foto cadastrada no Cadastro de Imagens
- Sequence: é a sequencia do hash gerada para o Person ID (CPF)
- Image Code: é o Image Code (Código da Imagem) do Data Model Imagem
- Code: é o campo usado para guardar o código do dispositivo que a pessoa efetua a marcação. Esta informação permite buscar os hashes por dispositivo num primeiro momento. Então para pessoas que batem sempre no mesmo dispositivo a busca será bem mais rápida.
- PersonId: é o CPF do Funcionário
- Grouping field: é a informação do funcionário relativa ao grupo usado como separador de imagem. Ex: se o separador de imagem é o campo "mdmgroupsectioncode" então o conteudo do campo Grouped Section Code do Funcionario será gerado nesse campo.
- Active: se o funcionário está ativo ou a data de desligamento do funcionário é futura então este campo fica como Active, Caso o funcionário seja desligado a informação será atualizado como inactive. Os registros inativos são utilizados para atualização no aplicativo quando o funcionário for desligado.
- Image Hash: são os códigos gerados referente aos pontos da face. São utilizados para o reconhecimento facial
- Name: nome do funcionário
- Connector: connector de origem do registros. Como foi gerado pelo processo de HASH_DB as informações são atualizadas por esse connector no Clockin.
- Created: data e hora que o registro foi criado no Data Model Hashes
- Last Updated: ultima atualização do registro
- Record Id: é o campo chave de identificação do registro
Regras de Geração:
- Funcionários ativos ou com data de desligamento futura são considerados para a geração do hashes
- São considerados os hashes das imagens válidas (campo observation code = 0) e cujo o hash já foi gerado do Data Model de Image
- São considerados os hashes das últimas 5 marcações realizadas pelo funcionário e o dispositivo em que ele realizou a marcação
Quais são os passos para realizar o fluxo do NO DAT ?
O fluxo do NO DAT é composto dos seguintes passos:
1) Cadastramento da Foto, que pode ser feito de três maneiras:
- Inserir no Backoffice
- Associação de Fotos na Marcação
- Integração da Foto via ERP
2) Efetuar o agendamento do processo de geração de hash (hash_db). Este processo gera informações no Data Model Hashes,
3) O aplicativo Mobile realiza a sincronização dos hashes e grava as informações em banco de dado de três maneiras:
- No momento do login,
- de tempos em tempos através de uma agendamento no aplicativo
- pelo botão Sincronização realiza a sincronização no início e através do botão de sincronização parcial (menu lateral do app)
4) Quando o funcionário se posiciona para realizar a marcação por reconhecimento o aplicativo consulta as informações no banco de dados para realizar o reconhecimento facial
Implementações Futuras:
- Ao efetuarmos a liberação do NO DAT teremos um período em que a funcionalidades de banco de imagem pelo arquivo DAT e NO DAT funcionarão em paralelo enquanto os aplicativos não são todos atualizados para a versão do NO DAT. Para facilitar a transição, será disponibilizada uma forma de o cliente poder ter um único processo que irá gerar tanto os hashes quando o DAT. No settings temos já um parametro que irá possibilitar essa função porém o campo ainda tem a funcionalidade.
