Automação do Estado de Marcação Biométrica: Entrada e Saída
Num sistema de controlo de presenças biométrico, identificar com precisão se uma marcação é um registo de IN (entrada) ou OUT (saída) é fundamental para garantir um controlo de presenças adequado. Na Cams Biometrics, oferecemos formas flexíveis de determinar o estado da marcação—tanto ao nível do hardware como ao nível do portal de administração (API).
Este artigo explica como os estados de marcação são registados, que opções os programadores podem configurar e quais as importantes restrições técnicas que devem ser consideradas para garantir um desempenho fiável em sistemas em tempo real.
🛠️ 1. Estado de Marcação ao Nível do Hardware
Na maioria dos dispositivos biométricos, todas as marcações são registadas como “Check In” por defeito.
Se um utilizador pretender registar um “Check Out” ou qualquer outro estado personalizado, deve selecionar manualmente o modo de marcação adequado no dispositivo (por exemplo, premindo um botão “Check Out” ou utilizando uma opção no ecrã tátil) antes de marcar.
✅ Esta configuração funciona bem em ambientes onde os utilizadores são formados para selecionar o modo de marcação correto no dispositivo.
❌ Importante: Selecionar o estado automaticamente ao nível do hardware não é possível. Os dispositivos biométricos não mantêm qualquer lógica de negócio. Os programadores devem garantir que os estados de marcação são corretamente processados pelo software ligado ou pela lógica da API.
🌐 2. Estado de Marcação ao Nível do Portal Cams (Opções de Automação)
Para simplificar a experiência do utilizador e automatizar a classificação do estado de marcação, os programadores que integram com a Cams Web API podem escolher entre as seguintes opções de lógica no servidor. Estas regras são aplicadas depois de a marcação ser registada no dispositivo.
📌 Opção 1: Actual
- O estado exato da marcação (IN/OUT) selecionado pelo utilizador no dispositivo é transmitido para o servidor.
📌 Opção 2: First In Rest Out
- A primeira marcação do dia é registada como IN.
- Todas as marcações seguintes, dentro do mesmo período de 24 horas e para o mesmo utilizador, são registadas como OUT.
- Ideal para sistemas em que os utilizadores não selecionam manualmente o tipo de marcação.
📌 Opção 3: ZigZag
- As marcações alternam entre IN e OUT ao longo do dia.
- A primeira marcação é IN, a segunda é OUT, a terceira é IN, e assim sucessivamente.
- A lógica é mantida para cada utilizador com base na atividade das últimas 24 horas.
ℹ️ Os modos
First In Rest OuteZigZagrequerem acesso ao histórico de marcações das últimas 24 horas para funcionarem com precisão.
⚠️ Principais Restrições a Ter em Conta
Embora estas opções de lógica automática simplifiquem a integração, existem limitações importantes a compreender:
❗ 1. Sem Armazenamento Permanente de Dados de Utilizadores
A Cams Biometrics não armazena dados de utilizadores ou de marcações de forma permanente. Para First In Rest Out e ZigZag, guardamos temporariamente o histórico de marcações apenas das últimas 24 horas.
Se uma máquina estiver offline durante mais de 24 horas, as marcações anteriores deixam de estar disponíveis para avaliar corretamente a marcação seguinte. Isto pode levar a uma classificação incorreta (por exemplo, tratar a segunda marcação como IN em vez de OUT).
❗ 2. A Lógica Funciona Apenas por Dispositivo
Estas lógicas de estado de marcação são aplicadas por dispositivo e por utilizador. Se um utilizador marcar em vários dispositivos, o sistema não cruza informação entre máquinas. Isto causará falhas de lógica em cenários com utilização em múltiplos dispositivos.
❗ 3. As Máquinas Devem Ligar-se Pelo Menos Uma Vez a Cada 24 Horas
Para que a automação do estado de marcação funcione de forma fiável, as máquinas devem ficar online e sincronizar pelo menos uma vez em cada período de 24 horas. Caso contrário, os servidores da Cams não conseguirão manter o histórico de marcações de curto prazo necessário.
❗ 4. Não Adequado para Presenças Baseadas em Turnos
A automação do estado de marcação baseia-se apenas em dados das últimas 24 horas, e a classificação é feita dentro do mesmo dia de calendário da marcação.
Se estiver a gerir presenças baseadas em turnos, especialmente turnos noturnos ou flexíveis, recomendamos vivamente que não dependa do estado de marcação da API. Em vez disso, desenvolva a sua própria lógica no seu sistema para interpretar as marcações com base nas suas definições de turnos.
🛠️ A Cams não suporta atualmente a automação do estado de marcação com base em horários de turnos. Essa lógica deve ser implementada no seu software de gestão de presenças designado.
✅ Boas Práticas e Recomendações
Antes de ativar a lógica automática do estado de marcação (First In Rest Out ou ZigZag), certifique-se de que:
- Os utilizadores marcam sempre a partir de uma máquina atribuída.
- Cada máquina se liga ao servidor pelo menos uma vez em cada 24 horas.
- Compreende o comportamento e as limitações destes modos de lógica, para evitar uma interpretação incorreta das marcações.
🛑 Não ative estas opções a menos que a sua configuração cumpra totalmente as condições acima indicadas—uma utilização incorreta pode levar a erros de cálculo de presenças para o seu cliente.
🚀 A Cams Oferece Integração Sem Código ou Instantânea
Para simplificar o seu processo de desenvolvimento, a Cams oferece opções de integração plug-and-play (sem código), bem como suporte personalizado completo.
Se necessário, a nossa equipa pode:
- Desenvolver lógica personalizada com base no fluxo de trabalho do seu sistema.
- Fornecer código de integração pronto a instalar para qualquer linguagem de servidor (PHP, Node.js, Java, Python, .NET, etc.) e qualquer base de dados (MySQL, PostgreSQL, SQL Server, etc.).
Basta indicar-nos a sua stack tecnológica, e ajudamo-lo a integrar de forma harmoniosa.