1. Introdução

O GBS CardScan é uma aplicação web para captura de fichas de identificação com dados biométricos tais como impressões digitais, impressões palmares, fotos faciais, assinaturas e dados biográficos textuais. A aplicação captura os dados das fichas e os cadastra na base de dados biométrica do GBS. Ela emprega extração de campos flexível e configurável, permitindo operar com múltiplos modelos de fichas.

Esse manual está atualizado para a versão 1.4.0 do CardScan.

1.1. Acesso e Autenticação

Você deve acessar o CardScan com um navegador e recomendamos o Google Chrome. A URL para acesso é específica para cada ambiente.

Note

Se necessário, entre em contato com a equipe de suporte da Griaule para obter a URL correta.

A autenticação é necessária para acessar a aplicação. As credenciais necessárias ao CardScan são nome de usuário e senha.

../../../_images/login15.png

Note

Na parte inferior da tela há uma opção para alterar o idioma para o desejado. Esta opção também está disponível nas configurações após o login.

1.2. Autenticação de dois fatores (2FA)

Quando a autenticação de dois fatores (2FA) estiver ligada, na primeira vez que você fizer login, após entrar seu username e senha, será mostrado um QR Code que deve ser registrado no Google Authenticator.

Note

Google Authenticator é um gerador de códigos de autenticação disponível como um aplicativo para smartphones Android e iOS.

QR Code do Google authenticator para autenticação de dois fatores

Após registrar com sucesso o QR Code no Google Authenticator, insira o código de seis dígitos gerado e clique em Enviar.

Você só precisará registrar o QR Code uma vez. Mas, a cada login subsequente, você precisará inserir o código de seis dígitos gerado pelo Google Authenticator.

Autenticação de dois fatores

Existe um número limitado de tentativas de login sem sucesso que um usuário pode fazer. Sempre que um código incorreto é inserido, uma mensagem de erro será exibida:

Autenticação de dois fatores - código incorreto

Se você atingir o número máximo de tentativas de login sem sucesso, sua conta será automaticamente bloqueada.

Autenticação de dois fatores - conta bloqueada

Warning

Se sua conta for bloqueada, entre em contato com o administrador do sistema.

1.3. Logins Simultâneos e Cadastro de Navegador

Apenas uma sessão por usuário é permitida. Não é possível fazer login simultaneamente com um mesmo perfil mais de uma vez na aplicação. Se um usuário já estiver conectado e outro acesso acontecer usando o mesmo nome de usuário e senha, o usuário com a sessão mais antiga será notificado e desconectado na próxima ação.

../../../_images/simultaneousLogin11.png

Além disso, apenas um navegador pode ser usado de cada vez. Ao tentar fazer login usando um navegador diferente, o usuário será informado que é necessário autenticar o novo navegador. A autenticação de um novo navegador revogará o acesso do navegador anterior.

../../../_images/browserEnrollment111.png

Para autenticar um novo navegador, clique em Autenticar e, em seguida, insira o código de verificação que será enviado para o e-mail vinculado à conta do usuário.

../../../_images/browserEnrollment211.png

Se a autenticação for bem-sucedida, uma notificação aparecerá no canto superior direito da tela após o login.

../../../_images/browserEnrollment311.png

1.4. Redefinir Senha

Você pode redefinir sua senha caso a esqueça.

Para redefinir sua senha, na tela de login, clique em Esqueceu sua senha?:

../../../_images/resetPassword111.png

Em seguida, insira o nome de usuário do perfil e clique em Enviar.

../../../_images/resetPassword211.png

Um e-mail contendo um código de verificação será enviado para o endereço de e-mail vinculado a esse perfil. Insira o código de verificação e clique em Enviar código.

../../../_images/resetPassword311.png

Se o código estiver correto, você poderá criar uma nova senha. Insira a nova senha duas vezes. Certifique-se de atender aos requisitos da senha, eles estão listados abaixo do campo de nova senha e ficarão verdes quando atendidos. Por fim, para confirmar a redefinição, clique em Redefinir senha.

../../../_images/resetPassword411.png

2. Interface do Usuário

2.1. Tela Principal

A tela principal exibe os principais recursos da aplicação:

Página principal

Os recursos estão distribuídos em 3 grupos: Requerer, Listar e Editar. Estes recursos também podem ser acessados pela barra de navegação no topo da página.

2.2. Requerer

Este grupo de recursos é usado para capturar e cadastrar fichas com dados biográficos e biométricos. Esta operação pode ser realizada de 3 formas: Ficha unitária, Múltiplas fichas em arquivo, e Múltiplas fichas em servidor.

2.2.1. Ficha Unitária

Esta operação é usada para processar uma única.

Ficha única

Uma requisição de ficha única exige 4 parâmetros:

Nome do processo

Um identificador (forma livre) para a operação.

Resolução

Resolução de digitalização da(s) imagem(ns). Para melhor resultado, a ficha deve ser digitalizada na mesma resolução do layout selecionado.

Layout

O layout de ficha usado para interpretar a imagem. Uma miniatura do layout selecionada será exibida.

Arquivos

Um ou mais arquivos de imagem contendo a digitalização da ficha. Se a ficha tiver múltiplas páginas, ou tiver conteúdo frente/verso, múltiplas imagens devem ser enviadas (uma por página).

Após preencher os parâmetros e enviar as imagens, o usuário pode reordenar as imagens enviadas para casar com a ordem do layout, arrastando os ícones no lado esquerdo da tela. Imagens podem ser removidas clicando no ícone “X”:

Ficha única

Clique em Enviar para enviar a requisição para processamento no servidor.

Para verificar o progresso da operação, selecione Listar > Processos no barra de navegação no topo da tela.

2.2.2. Múltiplas fichas em arquivo

Este tipo de operação é usado para processar um pacote contendo múltiplas fichas digitalizadas. O pacote deve ser um único arquivo Zip contendo todas as imagens digitalizadas.

O CardScan processará os arquivos seguindo a ordem lexicográfica de seus nomes. É recomendável iniciar os nomes de arquivos com números, para garantir uma ordem previsível de processamento.

Múltiplas fichas em arquivo

2.2.3. Múltiplas fichas em servidor

Esta operação é usada para processar uma lista de arquivos localizados no servidor que executa o serviço do CardScan. Ela processará os arquivos seguindo a ordem lexicográfica de seus nomes. É recomendável iniciar os nomes de arquivos com números, para garantir uma ordem previsível de processamento. Esta operação é indicada para migração de dados em larga escala, e pode exigir credenciais administrativas no servidor.

2.3. Listar

Este grupo de recursos permite ao usuário listar os perfis gerados para cadastramento ao processar requerimentos; Para listar requerimentos enviados and inspecionar sua situação; E para inspecionar logs de operação.

2.3.1. Perfis

Esta seção exibe uma lista dos perfis existentes criados pelo sistema. É possível filtrar a lista por ID de processo, ID do perfil, chave, dado biográfico e/ou status, permitindo a localização de perfis específicos.

Listar perfis

Clicar em uma linha de da listagem de perfis exibe seus detalhes, tais como imagens originais da ficha e imagens biométricas extraídas da ficha (impressões digitais, impressões palmares, foto facial, assinatura, etc.).

Detalhes do perfil

Nesta página também é possível editar os campos textuais obtidos por OCR (sigla em inglês para Reconhecimento óptico de caracteres), remover o perfil, atualizar a listagem e reprocessar os dados do perfil.

2.3.1.1. Editando campos OCR

Na página de detalhes do perfil o usuário pode editar campos textuais tais como dados biográficos, chaves e rótulos (labels). Para tal, deve-se clicar em Editar:

Editar detalhes do perfil

Após clicar em Editar, os campos do perfil tornam-se editáveis pelo usuário. Os campos do perfil são mostrados na imagem abaixo. os campos podem ser Chaves (Keys), Biográficos (Biographics) e Labels. Quando o OCR for incapaz de extrair as informações de Biográficos, Chaves ou Labels da imagem digitalizada, elas devem ser inseridas manualmente com essa opção.

Editar detalhes do perfil

2.3.1.2. Enviando o perfil para o GBDS

Se a ficha foi processada sem erros, o botão Enviar para GBDS estará habilitado, permitindo ao usuário que envie o perfil para cadastro no banco de dados biométrico GBS.

Enviar para GBDS

Warning

Uma vez enviado para o GBDS, os campos OCR não podem mais ser alterados.

2.3.1.3. Status do Perfil

Todos os perfis têm um status indicando sua situação atual. O status do perfil está normalmente associado ao status do processo. Quando um processo tem o status Processando, os perfis a ele associados podem ter os seguintes status:

Gerado

Perfil criado.

Segmentando

Segmentação em andamento.

Validação

Validação necessária.

Erro de Segmentação

Erro no processo de segmentação.

Segmentação OK

A segmentação foi realizada com sucesso, esperando que o usuário envie o perfil ao GBDS.

Quando o processamento é concluído, o status do perfil pode assumir outros valores:

Deletado

Perfil deletado antes de ser enviado ao GBDS.

Ok

Fluxo do perfil concluído (cadastro completo no GBDS).

Validação

Validação necessária.

Erro de Segmentação

Erro no processo de segmentação.

Erro

Erro ao processar o perfil.

Pronto para o GBDS

Pronto para ser enviado ao GBDS.

Enviando para o GBDS

Enviando para o GBDS.

Enviado para o GBDS

Envio para o GBDS concluído.

OK no GBDS

Cadastro concluído com sucesso, pode realizar transição para Ok.

Falha no GBDS

Falha no cadastro no GBDS.

Em análise (MIR)

Esperando revisão manual de qualidade.

Aprovado (MIR)

Aprovado na revisão de qualidade, pode realizar transição para Ok.

Rejeitado (MIR)

Rejeitada na revisão de qualidade.

Em análise (ETR)

Cadastro gerou uma exceção, aguardando resolução no ETR.

Mesmas biometrias (ETR)

Resolução no ETR: encontradas as mesmas biometrias (fraude em operação de cadastro).

Biometrias diferentes (ETR)

Resolução no ETR: biometrias diferentes (fraude em operação de atualização).

Recoletar (ETR)

Resolução no ETR: recoleta necessária.

Aprovado (ETR)

Resolução no ETR: aprovado, pode realizar transição para Ok.

2.3.2. Processos

A seção de processos exibe uma lista de processos existentes e seus detalhes. A lista pode ser filtrada por data, nome de usuário, ID do processo e/ou status.

Listar processos

Clicar em uma linha da lista de processos abre uma página com detalhes do processo e opções para recarregar as informações, exibir perfis associados e logs do processo:

Detalhe de processo

2.3.2.1. Status do Processo

Todo processo tem um status indicando sua situação atual, que pode assumir os seguintes valores:

Recebido

Processo recebido e criado.

Validando

O processo está sendo validado.

Detectando layout

Detectando o layout automaticamente.

Layout não detectado

Erro: sistema não conseguiu detectar o layout.

Layout detectado

Detecção de layout concluída com sucesso.

Pronto para segmentação

Pronto para ser segmentado. Aguardado validação do usuário.

Processando

Processando perfis.

Perfis gerados

Perfis gerados com sucesso, usuário pode enviá-los ao GBDS.

Processado

Processo concluído.

Erro

Erro no processo.

2.3.3. Logs de Operação

A seção de logs de operação exibe uma lista dos logs existentes e seus detalhes.

Lista de logs

Esta lista não oferece uma vista detalhada de cada entrada de log, diferentemente das outras listas.

2.4. Editar

Este grupo de recursos permite ao usuário editar configurações da aplicação, bem como layouts.

2.4.1. Configurações

Esta seção permite ao usuário alterar configurações gerais da aplicação:

Configurações

É possível alterar o tema da aplicação de escuro para claro, o idioma, o formato de data/hora e o tipo de busca. Estas configurações afetam apenas a interface com o usuário, e não as operações de processamento de fichas.

2.4.2. Layouts

Esta seção exibe uma lista de layouts existentes e permite ao usuário editá-los, cloná-los e/ou removê-los. Note que um layout só pode ser editado ou removido se não houver processos associados a ele.

Lista de layouts

Clicar em um layout da lista abrirá uma página mostrando o layout com seus campos em destaque:

Detalhe de layout

3. Layouts

Um layout é uma representação de um modelo específico de ficha biométrica. Cada modelo distinto de ficha deve ter um layout correspondente no sistema.

No exemplo a seguir podemos ver as digitais (borradas neste manual para anonimização) e dados biográficos de uma pessoa:

Exemplo de layout

Para criar um layout correspondente, o usuário precisa especificar as regiões da imagem onde há dados biométricos e biográficos.

3.1. Criando um novo layout

Para criar um novo layout, clique em Novo Layout:

Criar novo layout

A tela de criação de layout será exibida:

Criar novo layout (vazio)

3.1.1. Importar arquivo ou Adquirir Imagem

O primeiro passo na criação do layout é importar um arquivo de imagem para servir de base:

Imagem de ficha biométrica importada

3.1.2. Resolução

Um passo importante é a especificação da resolução da imagem importada (dada em pontos por polegada, dpi na sigla em inglês). A resolução pode ser indicada manualmente na barra lateral à direita:

Imagem de ficha biométrica importada: resolução

O usuário também pode clicar em Ajustar resolução na barra de ferramentas à esquerda:

Ferramenta de ajuste de resolução

Escolha a unidade de medida desejada e informe a distância que será marcada na imagem:

Exemplo de uso da ferramenta de ajuste de resolução

Neste exemplo, o primeiro passo (1) indica 5 cm como a distância que será marcada na imagem. O segundo passo (2) é a marcação da distância na imagem. Após os passos 1 e 2, a aplicação informará a resolução calculada (3). Neste exemplo, 354 dpi.

Warning

A resolução mínima permitida é 300 dpi.

As seguintes informações podem ser adicionados ao layout:

Nome

Um identificador (forma livre) para o layout.

Descrição

Descrição do layout (ex.: “fichas do estado de Roraima, 1985-1993”)

Idioma

O idioma em que os dados das fichas estão grafados.
Propriedades do layout.

3.1.3. Criar região

Em seguida, o usuário deve especificar uma ou mais regiões da imagem que contenham dados biométricos ou biográficos.

Na barra de ferramentas, clique em Extrair região:

Extrair região com ferramenta de retângulo

Clique e arraste o mouse sobre a imagem para definir um retângulo, e então use a barra lateral à direita para preencher seus detalhes:

Detalhes da região

è possível ajustar a posição e tamanho da região. Nesta tela, o usuário também pode alterar os seguintes ajustes:

  • Ângulo:

    • Sem rotação: sem alteração na região criada
    • Rotacionar 90° no sentido horário: rotaciona a região por este ângulo
    • Rotacionar 90° no sentido anti-horário: rotaciona a região por este ângulo
    • Inverter: rotação de 180°
  • Tipo:

    • Digital: impressão digital
    • Palmar: impressão palmar
    • Assinatura: assinatura
    • Chave: para campos que serão chave (valores que não podem se repetir para pessoas distintas). Chaves serão armazenadas na base de dados do GBS.
    • Biográfico: para campos com dados biográficos da pessoa. Esta informação será armazenada na base de dados do GBS.
    • Label: para campos que serão tratados como rótulos (labels). Labels serão armazenados na base de dados do GBS.
  • Subtipo para Digitais:

    • Digital Simples: para regiões com uma única digital.
    • Dois Polegares: para regiões com dois polegares.
    • Duas Digitais: para regiões com duas impressões digitais.
    • Quatro Digitais: para regiões com quatro impressões digitais.
  • Digitais: Esta opção depende do subtipo acima, e indica qual dedo ou dedos estão presentes na região.

  • Subtipo para Palmares:

    • Interdigital esquerda
    • Tenar esquerda
    • Hipotenar esquerda
    • Interdigital direita
    • Tenar direita
    • Hipotenar direita
    • Completa esquerda
    • Escrita esquerda
    • Completa direita
    • Escrita direita
  • Subtipo para Face:

    • Face frontal
    • Mugshot esquerdo
    • Mugshot direito
  • Subtipo para Chave:

    • Chave OCR: O campo será interpretado por OCR (reconhecimento óptico de caracteres).
    • Chave Código de barras: O campo será interpretado como um código de barras.
  • Campos para Chaves:

    • Lista os campos registrados no servidor GBS para o tipo “Chave”:

      Campos chave
    • Exemplos de campos chave: número de passaporte, número da CNH, número do título de eleitor.

  • Subtipo para Biográfico:

    • Biográfico OCR: O campo será interpretado por OCR (reconhecimento óptico de caracteres).
    • Biográfico Código de barras: O campo será interpretado como um código de barras.
  • Campos biográficos:

    • Lista os campos registrados no servidor GBS para o tipo “Biográfico”:

      Campos biográficos
    • Exemplos de campos biográficos: nome, data de nascimento, nome da mãe, nome do pai.

  • Subtipo para Label:

    • Label OCR: O campo será interpretado por OCR (reconhecimento óptico de caracteres).
    • Label Código de barras: O campo será interpretado como um código de barras.
  • Campos de Label:

    • Lista os campos registrados no servidor GBS para o tipo “Label”:

      Campos de Label
    • Labels podem ser usadas para agrupar e filtrar pessoas nas operações de busca do GBS.

Quando a criação da região é concluída, a imagem terá as regiões associadas como na imagem abaixo:

Ficha biométrica demarcada

Para ajustar qualquer região criada, clique nela. Seus detalhes serão destacados na barra lateral e a lista de opções será exibida:

Janela de edição de região