Histórico da Página

...

01. VISÃO GERAL

Esta documentação tem como objetivo orientar sobre o que é a funcionalidade NO DAT tanto no Clockin Mobile (app para smartphone) .

...

finalidade fornecer orientações o processo de unificação dos aplicativos e migração doaplicativo Clock In Kiosk para o Clock In Mobile. 

A  Unificação dos Aplicativos nasceu da necessidade de termos mais qualidade e agilidade nas entregas de melhorias e manutenções referente ao aplicativo. Desta forma a ideia é uma versão única de aplicativo contemplando e centralizando todas as novas funcionalidades. 

Na primeira versão única que liberamos para o mercado tivemos grandes mudanças em relação a forma como ocorre o gerenciamento de imagens dentro do aplicativo.  Enquanto o Kiosk faz esse gerenciamento através de arquivos contendo os hashes (os códigos das imagens), o Mobile possui uma estrutura de banco de dados que permite um gerenciamento de hashes de forma mais otimizada. A seguir temos uma detalhamento maior dessa nova arquitetura que chamados de "NO DAT".

02. O QUE É O NO DAT ?

O conceito "NO DAT consiste em mudanças " engloba modificações nos aplicativos Mobile para possibilitar a melhoria do com o propósito de aprimorar o reconhecimento facial. Atualmente Tradicionalmente, o processo atual de reconhecimento envolve facial envolvia a leitura de dados da imagem do funcionário em um informações contidas em arquivo de imagens com extensão "DAT" para o reconhecimento facial. 

O fluxo atual do reconhecimento foi modificado para que essa leitura dos dados citados seja feita através da consulta em banco de dados dentro do próprio aplicativo (usaremos um termo chamado de hash).

Alguns pontos relevantes sobre o NO DAT:

• A versão do NO DAT estará disponível a partir de junho de 2023 e será necessário atualizar o aplicativo para a versão 12.1.23030000 ou superior; 
• A atualização é facilmente feita através da loja de aplicativos (Google Play para dispositivos Android e App Store para dispositivos IOS);
• O mesmo está disponibilizado para a versão Mobile 
• Com o NO DAT a Geração de DAT (generate_dat_file), será substituída pela Geração do Hashes (hash_db)

Quais são os Benefícios do NO DAT?

• Ganho de velocidade e performance nas cargas iniciais e parciais dos dados. (Hashes e Employees).

• Remoção do arquivo .dat, o mesmo que causava perda de perfomance e problemas no reconhecimento facial.
• Facilidade de análise dos Hashes ativos na plataforma Carol.

• App mais ágil e íntegro para a operação.

• Possibilidade dos funcionários em aviso prévio realizar batidas.

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 segundo um agendamento realizado. Para acessar o mesmo, clica-se em Carol Apps, e depois em “TOTVS RH Clockin BackOffice”. Conforme print abaixo na Aba Process, temos o processo “hash_db”:

Image Removed

Após a execução do mesmos, os hashes das imagens são gerados.

Image Removed

Como Consultar os hashes gerados na plataforma ?

Os hashes gerados pelo NO DAT são facilmente visualizados através do DM Hashes. A consulta dos Hashes gerados é feita pelo DM 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.  

Image Removed

, correspondentes às imagens dos funcionários.

No entanto, uma transformação foi implementada nesse fluxo. Agora, a leitura de informações contidas nas imagens é efetuada por meio de consultas diretas ao banco de dados, realizadas dentro do próprio aplicativo. 

Para viabilizar o reconhecimento facial, o processo gera conjuntos de dados de imagem denominados "hashes". Essencialmente, esses "hashes" representam codificações das características faciais de cada indivíduo.

Essa nova arquitetura operacional introduziu uma mudança notável no processo. A geração do arquivo DAT, anteriormente conhecido como "generate_dat_file", foi substituída pelo processo de criação dos "hashes", denominado "hash_db".

Dessa maneira, o "NO DAT" impulsiona uma abordagem mais ágil e eficiente no reconhecimento facial, simplificando a operação ao utilizar diretamente os dados codificados das imagens e eliminando a necessidade de manipulação de arquivos intermediários. Para saber mais sobre a Geração de Hashes acessar aqui.

03. QUAIS SÃO OS BENEFÍCIOS DE MIGRAR PARA CLOCK IN MOBILE ?

Quando os cliente migram para a solução do Aplicativo Mobile tem uma série de benefícios que listamos a seguir:

• Ganho de performance no Reconhecimento Facial. A transição para essa abordagem resulta em uma melhoria no desempenho do processo de reconhecimento facial, otimizando a velocidade e eficácia da identificação.

• Ganho de performance e estabilidade nas cargas através do login e nas atualizações dados dados da imagem no aplicativo. Isso contribui para uma experiência mais fluída e confiável para os usuários.

• Mais segurança na utilização do Mobile em Tablet com a utilização do PIN. A introdução do PIN como medida de segurança acrescenta um nível adicional de proteção, aprimorando a segurança geral da utilização do aplicativo.
• Maior integridade no reconhecimento facial através da solicitação do CPF para o Multi reconhecimento. 
• Maior integridade das marcações através da mudança na arquitetura do banco de marcações. 
• Outras funcionalidades e correções descritas aqui. 

04. COMO VERIFICAR SE O AMBIENTE UTILIZA O APLICATIVO KIOSK PARA MARCAÇÃO DE PONTO

Para identificar se existem funcionários efetuando marcação no aplicativo Clock In Kiosk,  pode ser realizada consulta no BackOffice do Clock In, através do passo a passo abaixo:

1. Acessar o Backoffice do Clock In através do login; 
2. Selecionar a opção de menu "Marcações";
3. Realizar o filtro de data que poderá ser através da seleção da opção "Customizar";
4. Informar a data de início e fim que poderá ser os últimos 60 dias; 
5. Na ícone "engrenagem" selecionar o campo "Nome do App";
6. No canto superior direito da consulta clicar no link "Busca Avançada";
7. Na opção "Busca Avançada" clicar no link "Selecionar Filtros" e selecionar o campo 'Nome do app";
8. Informar "Clock-In Kiosk" no campo "Nome do app" e pressionar o botão "Aplicar filtro".

Caso sejam demonstradas informações na consulta significa que existem funcionários que efetuaram marcações no aplicativo Clock In Kiosk nos últimos 60 dias. Então será necessário ações para migração para o Aplicativo Clock In Mobile descritas a seguir. 

05. QUAL O PROCESSO PARA MIGRAR PARA O MOBILE ?

Para facilitar esse processo elaboramos um passo a passo  detalhado para a migração.

06. SERÁ NECESSÁRIO ATUALIZAR TODOS OS DISPOSITIVOS DE UMA SÓ VEZ ?

Não. Essa migração poderá ser feita de forma gradual. 

Haverá um processo de descontinuidade da Geração de DAT dentro em breve, onde os clientes serão comunicados sobre qual será o prazo dessa migração.