# Testando o Suricato Face ## Visão Geral Aprenda como **testar o funcionamento do Suricato Face**, desde o cadastro da foto do colaborador ou visitante até a validação do sincronismo com o equipamento facial Intelbras. O objetivo é orientar o usuário na verificação prática do processo, permitindo identificar se a foto foi corretamente enviada, sincronizada e reconhecida pelo equipamento, além de facilitar a análise de possíveis erros por meio de logs e tabelas do sistema. ## Regra de Negócio Para realizar os testes do Suricato Face, é obrigatório que os seguintes pré-requisitos sejam atendidos: * Suricato Cliente instalado e em funcionamento. * Equipamento Facial Intelbras configurado. * Serviço Suricato Face ativo. * Colaborador ou Visitante cadastrado no grupo de acesso do equipamento facial Intelbras. * Cadastro da foto da pessoa realizado no sistema. * Equipamento compatível com o processo de sincronismo (modelos 73 – SS5530 e 74 – Standalone). Sem o atendimento desses requisitos, o teste do Suricato Face não poderá ser executado corretamente. ## Como testar o Suricato Face Para a utilização do Suricato Face, é necessário garantir que todos os pré-requisitos estejam atendidos. O cadastro da foto do colaborador ou visitante pode ser realizado utilizando o próprio Suricato, por meio do Suricato Cliente. No Suricato Cliente: * Acesse o cadastro da pessoa, clique na opção **FACE**. * Realize o cadastro da foto da pessoa.

Após a inserção da foto no sistema, é possível verificar no **Equipamento Facial Intelbras** se o perfil do usuário foi atualizado com a nova imagem. ### Registro – Suricato Facial Na tabela **TBFACEPESSOAHISTORICO**, é possível visualizar a situação do processamento da pessoa. Na coluna **OBSERVAÇÃO**, é apresentada a condição do processamento, podendo ser: * **Sucesso** * **Erro** Os possíveis erros são: * **“Não possui foto no database”**\ Indica que a pessoa não possui foto cadastrada no sistema. * **“Enviado face do crachá” (Bad Request)**\ Indica que o equipamento não reconheceu a foto enviada ou que a imagem não possui qualidade adequada.

*Exemplo – Tabela TBFACEPESSOAHISTORICO*

### Logs do Suricato Face Na pasta do **Suricato-Face**, existe a pasta **Log**. Dentro dela, encontra-se o arquivo de texto: ``` suricato-face.info.log ```

Nesse arquivo é possível visualizar os sincronismos realizados com o equipamento facial, organizados por data e hora, facilitando a identificação de possíveis erros.

*Exemplo – Arquivo suricato-face.info.log.txt*

### Sincronismo de Tabelas – Suricato-Face O **Suricato-Face** é uma aplicação **JAR (Java)** responsável por executar a regra de negócio para sincronismo de face. O processo de sincronismo é executado **somente** para equipamentos dos modelos: * **73 (SS5530)** * **74 (Standalone)**

As regras de sincronismo seguem os seguintes critérios: * Caso a pessoa esteja presente na tabela **TBFACEPESSOACONTROLE** e não esteja na tabela **VHISTORICOCRACHAFACE**, ela será excluída da tabela **TBFACEPESSOACONTROLE**. * Caso a pessoa esteja presente na tabela **VHISTORICOCRACHAFACE** e não esteja na tabela **TBFACEPESSOACONTROLE**, ela será incluída na tabela **VHISTORICOCRACHAFACE**. ### Facial Intelbras Na tela inicial do codin facial Intelbras, estão disponíveis as seguintes opções: * Menu * Senha * QR Code

Ao clicar na opção **Menu**, será exibida uma tela com quatro opções: * Face * Acesso por Cartão Smart * Acesso por Senha * Admin

### Menu Admin Na tela **Admin**, é possível visualizar diversas opções e configurar o codin conforme a necessidade. É possível visualizar as pessoas que estão no grupo de acesso do equipamento facial acessando: ``` Usuário → Lista de Usuário ``` Na opção **Conexão**, é possível configurar o endereço IP do equipamento facial Intelbras acessando: ``` Conexão → Configuração de rede → Rede cabeada ```

#### Lista de Usuários Nesta tela, é possível visualizar: * Todas as pessoas cadastradas. * Quais possuem facial cadastrada. * ID do usuário. * Nome. * Formas de acesso disponíveis. * Perfil do usuário. **Observação:** Os ícones exibidos na coluna **Método** representam as formas de acesso disponíveis para o usuário.

#### Perfil do Usuário Ao acessar o perfil da pessoa, é possível visualizar de forma detalhada as informações do usuário. Ao clicar no item **Face**, é exibida a foto cadastrada no Suricato, utilizada pelo equipamento como referência para liberação de acesso.

### Configuração de Rede Nesta tela, é possível visualizar e configurar: * Endereço IP * Máscara de sub-rede * Gateway padrão Essa mesma configuração também pode ser realizada por meio do Suricato.

Clique aqui para ver as instruções para o Cadastro de fotos ## Guia Rápido de Uso 1. Verificar se o Suricato Cliente e o serviço Suricato Face estão ativos. 2. Cadastrar a foto do colaborador ou visitante na opção **FACE**. 3. Confirmar a atualização do perfil no equipamento facial. 4. Consultar a tabela **TBFACEPESSOAHISTORICO** para validar o processamento. 5. Analisar o arquivo `suricato-face.info.log` em caso de erro. ## Glossário * **Bad Request:** Erro retornado quando o equipamento não consegue processar a foto enviada ou a imagem não atende aos critérios de qualidade. ## FAQ – Perguntas Frequentes

A foto foi cadastrada, mas não aparece no equipamento. O que verificar?

Verifique se o serviço Suricato Face está ativo e se o equipamento é compatível com o sincronismo.

O que significa o erro “Não possui foto no database”?

Significa que a pessoa não possui foto cadastrada no sistema.

Por que ocorre o erro “Enviado face do crachá (Bad Request)”?

Ocorre quando a foto enviada não é reconhecida pelo equipamento ou possui baixa qualidade.

Onde posso verificar se o sincronismo foi executado?

No arquivo `suricato-face.info.log` e na tabela `TBFACEPESSOAHISTORICO`.

Posso testar o Suricato Face em qualquer modelo de equipamento?

Não. O sincronismo é executado apenas para os modelos 73 (SS5530) e 74 (Standalone).

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-suricato-face/testando-o-suricato-face.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.