Support Hub/API & Integrations/生体認証による打刻状態の自動化:チェックインとチェックアウト
Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Fix

生体認証による打刻状態の自動化:チェックインとチェックアウト

生体認証による打刻状態の自動化:チェックインとチェックアウト

生体認証による勤怠管理システムでは、打刻がIN(入室)かOUT(退室)かを正確に判別することが、適切な勤怠追跡を行ううえで不可欠です。Cams Biometricsでは、打刻状態を判定するための柔軟な方法を提供しています。具体的には、ハードウェアレベルと管理ポータル(API)レベルの両方で設定できます。

本記事では、打刻状態がどのように記録されるか、開発者が設定できるオプション、そしてリアルタイムシステムで確実に動作させるために考慮すべき重要な技術的制約について説明します。


🛠️ 1. ハードウェアレベルでの打刻状態

ほとんどの生体認証機器では、すべての打刻がデフォルトで「チェックイン」として記録されます。

ユーザーが「チェックアウト」やその他のカスタム状態を記録したい場合は、打刻の前に機器上で適切な打刻モードを手動で選択しなければなりません(例:「チェックアウト」ボタンを押す、またはタッチスクリーンのオプションを使用する)。

✅ この設定は、ユーザーが機器で正しい打刻モードを選択するよう教育されている環境では効果的に機能します。

❌ 重要:ハードウェアレベルで状態を自動的に選択することはできません。生体認証機器は業務ロジックを保持しません。開発者は、打刻状態が接続されたソフトウェアまたはAPIのロジックによって正しく処理されるようにする必要があります。


🌐 2. Camsポータルレベルでの打刻状態(自動化オプション)

ユーザー体験を簡素化し、打刻状態の分類を自動化するために、Cams Web APIと連携する開発者は、以下のサーバー側ロジックオプションから選択できます。これらのルールは、打刻が機器に記録された後に適用されます。

📌 オプション1:Actual

  • 機器でユーザーが選択した正確な打刻状態(IN/OUT)が、そのままサーバーに渡されます。

📌 オプション2:First In Rest Out

  • その日の最初の打刻はINとしてマークされます。
  • 同じユーザーについて、同じ24時間以内の後続のすべての打刻はOUTとしてマークされます。
  • ユーザーが打刻の種類を手動で選択しないシステムに最適です。

📌 オプション3:ZigZag

  • 打刻は一日を通してINとOUTが交互に切り替わります。
  • 1回目の打刻はIN、2回目はOUT、3回目はIN、というように続きます。
  • このロジックは、各ユーザーの過去24時間の打刻履歴に基づいて維持されます。

ℹ️ First In Rest OutとZigZagのどちらのモードも、正確に機能させるには直近24時間の打刻履歴へのアクセスが必要です。


⚠️ 留意すべき主な制約

これらの自動ロジックオプションは連携を簡素化しますが、理解しておくべき重要な制限事項があります。

❗ 1. ユーザーデータの永続的な保存はありません

Cams Biometricsは、ユーザーおよび打刻データを永続的に保存しません。First In Rest OutとZigZagについては、直近24時間分の打刻履歴のみを一時的に保存します。

機器が24時間を超えてオフラインの場合、以前の打刻は次の打刻を正しく判定するために利用できなくなります。その結果、分類が誤る可能性があります(例:2回目の打刻をOUTではなくINとして扱う)。

❗ 2. ロジックは機器単位でのみ動作します

これらの打刻状態ロジックは、機器ごと、ユーザーごとに適用されます。ユーザーが複数の機器で打刻する場合、システムは機器間で照合を行いません。これは、複数機器を使用するケースでロジックの誤動作を引き起こします。

❗ 3. 機器は24時間に少なくとも1回接続する必要があります

打刻状態の自動化を確実に動作させるには、機器が24時間に少なくとも1回オンラインになり、同期する必要があります。そうしなければ、Camsサーバーは必要な短期間の打刻履歴を維持できません。

❗ 4. シフト制の勤怠管理には適していません

打刻状態の自動化は直近24時間のデータのみに基づいており、分類は打刻と同じ暦日内で行われます。

シフト制の勤怠管理、特に夜間勤務や変則的なシフトを扱う場合は、APIからの打刻状態に依存しないことを強くお勧めします。代わりに、シフト定義に基づいて打刻を解釈する独自のロジックをご自身のシステム内に構築してください。

🛠️ Camsは現在、シフト時間に基づく打刻状態の自動化をサポートしていません。そのロジックは、お客様が指定する勤怠管理ソフトウェアに実装する必要があります。


✅ ベストプラクティスと推奨事項

打刻状態の自動ロジック(First In Rest OutまたはZigZag)を有効にする前に、以下を確認してください。

  • ユーザーが常に割り当てられた1台の機器から打刻していること。
  • 各機器が24時間に少なくとも1回サーバーに接続していること。
  • 誤った打刻解釈を避けるため、これらのロジックモードの動作と制限を理解していること。

🛑 上記の条件を環境が完全に満たしていない限り、これらのオプションを有効にしないでください。不適切な使用は、お客様の勤怠計算の誤りにつながるおそれがあります。


🚀 Camsはノーコードおよび即時連携を提供します

開発プロセスを簡素化するため、Camsはプラグアンドプレイ(ノーコード)の連携オプションに加え、フルカスタムサポートを提供しています。

必要に応じて、当社チームは以下を行うことができます。

  • お客様のシステムのワークフローに基づいて、カスタムロジックを開発する。
  • 任意のサーバー言語(PHP、Node.js、Java、Python、.NETなど)および任意のデータベース(MySQL、PostgreSQL、SQL Serverなど)向けの、すぐにインストール可能な連携コードを提供する。

技術スタックをお知らせいただければ、スムーズな連携をサポートいたします。

Was this article helpful?