生体認証IDの関連付け

1. 関連付けを実行したり、既存の関連付け情報を表示したりするには、［処理］→［出退勤］→［生体認証IDの関連付け］の順に移動します。
2. 新しい関連付けを設定するには、［ユーザーIDの関連付けを追加する］をクリックします。
3. ［］（その他）アイコンをクリックすると、インポート／エクスポート／ダウンロードの機能が表示されます。 
   

データベース要件

1. テーブルに［downloadDate］列がない場合、SQLデータベースのデータがすべてZoho Peopleに送信されないことがあります。また、データが消失する可能性もあります。
   
2. 従業員のシフトが複数ある場合、それらをすべてZoho Peopleで関連付ける必要があります。
3. 生体認証IDがZoho Peopleの従業員番号と異なる場合、Zoho Peopleで［処理］→［出退勤］→［生体認証IDの関連付け］の順に移動して、生体認証IDを関連付ける必要があります。
4. 機能連携は、生体認証データを保存するサーバーのシステムに完全に依存します。誤ってシステムをシャットダウンしたためにクラッシュや再起動が起きた場合、設定画面に不具合が生じることがあります。このような場合、機能連携を再度設定する必要があります。

手順

Tomcatの設定

1. サービス名： Tomcat9ZohoPeople
2. シャットダウンポート：8989
3. コネクターポート／Tomcatサーバーポート：8584（このポート番号が他のサービスで使われていないことをご確認ください）
4. 以下の順に移動して、Open Logic Javaファイルパスを選択します：Cドライブ→［Program Files/ Program Files（x86）/ Open Logic/ jdk 〈バージョン〉］
5. スタートアップの種類：［スタート］→検索→［Tomcat9Zoho］（右クリック）→［プロパティ］→［スタートアップの種類］→［自動］
   

WARファイルのインストール

1. 以下のリンクをクリックして、WARファイルをダウンロードします。
   https://www.zoho.com/people/downloads/ZAttendance.war
2. ［ローカルディスク（C:）］→［Program Files］→［Apache Software Foundation］→［Tomcat9］→［Web apps］（Webアプリ）の順に移動し、WARファイルを貼り付けてから更新して、ファイルを抽出します。
3. http://localhost:8584/ZAttendanceからプラグイン画面を読み込めるか確認します。
   

プラグイン設定の手順

1. プラグイン画面右上の［Configure］（設定）ボタンをクリックして設定画面を開き、データベースの種類を選択します。
2. 項目の下に記載されている接続URLの例をコピーして貼り付け、データベース名を変更します。
   
   
   
   データベースのインスタンスのポート番号を適宜変更します。
   Microsoft SQLの場合：［C:］→［Windows］→［SysWoW64］→該当するSQL Server構成マネージャー→［SQL Server ネットワークの
   構成］→［SQLEXPRESSのプロトコル］→［TCP/IP］→［IPアドレス］→TCPポート：1433→［適用］→［OK］の順に移動します。
   または
   ［スタート］→検索→［コンピューターの管理］→［SQL Serverネットワークの
   構成］（左側の2つ目の選択肢）→［TCP/IP］→［IPアドレス］→TCPポート：1433→［適用］→［OK］の順に移動します。
   
   
   MySQLの場合：初期設定のポート番号は3306です。
   
   
   Microsoft Accessの場合：データベースのパスを追加し、フォワードスラッシュ（/）をバックスラッシュ（\）に変更します。
   
   
3.  データベースのユーザー名とパスワードを追加します。初期設定のユーザー名は、MySQLでは「root」、Microsoft Accessでは「admin」です。
   
4. ［Delay Time］（遅延時間）と［Sleep Time］（実行間隔）を5分にします（最短の時間）。
   
5. SQLクエリーを設定します。
   
   
   
   すべての列が要件どおりの場合：
   静的テーブル：
   

   select employeeId, isCheckin, eventTime, [downloadDate] FROM [ZAttendance].[dbo].[Attendance] where downloadDate>=$1 and downloadDate<$2
   
   
   動的テーブル：
   

   select employeeId, isCheckin, eventTime, [downloadDate] FROM #Tablename_%M_%Y# where downloadDate>=$1 and downloadDate<$2

   
   

   ダウンロード日の列に入力できない場合：（遅延時間が1～2時間）
   

   select employeeId, isCheckin, eventTime FROM [ZAttendance].[dbo].[Attendance] where eventTime>=$1 and eventTime<$2

   
   

   テーブルで［出勤］／［退勤］の区別が明示されていない場合：
   

   それぞれの打刻を［出勤］および［退勤］としてZoho Peopleに送信する：

   select employeeId, '1' as isCheckin, eventTime, [downloadDate] FROM [ZAttendance].[dbo].[Attendance] where downloadDate>=$1 and downloadDate<$2

   UNION

   select employeeId, '0' as isCheckin, eventTime, [downloadDate] FROM [ZAttendance].[dbo].[Attendance] where downloadDate>=$1 and downloadDate<$2

   
   

   または

   
   

   ［出勤］と［退勤］の一部の打刻データを送信する：

   select employeeId ,eventTime, [downloadDate] FROM

   [ZAttendance].[dbo].[Attendance] where downloadDate>=$1 and downloadDate<$2

   
   
6. 認証トークンを作成します。

   api-console.zoho.inにアクセスします（またはデータセンターに応じてapi-console.zoho.com/api-console.zoho.euにアクセスします）。クライアントの種類として［Self Client］（セルフクライアント）を作成し、［Client ID］（クライアントID）と［Client Secret］（クライアントシークレット）をコピーして、プラグイン画面に貼り付けます。

   
   

   ［Generate Code］（コードの生成）タブで、コードを作成します。

   範囲：ZohoPeople.attendance.all

   時間：10分

   説明：BI

   
   

   リフレッシュトークンを作成します。Client ID（クライアントID）／Client Secret（クライアントシークレット）／CODE（コード）を貼り付けて、データセンターを選択します。

   ［Generate］（生成）をクリックし、［Refresh Token］（リフレッシュトークン）の項目にコピーして貼り付けます。

   
   

   プロフィールの［Zohoの役割／役割］が［管理者］となっている管理者アカウントを使って、トークンが生成されていることを確認します。
   
   
7. タイムゾーンを変更します。あなたの場所のタイムゾーンを選択します。データベースの出退勤データのタイムゾーンと、管理者アカウントのタイムゾーンが同じであることを確認します。プラグイン画面のタイムゾーンは、データベースのデータのタイムゾーンを参照しています（GMT、GMT+4、GMT+5:30など）。 

   
   

   管理者アカウントのタイムゾーン（認証トークン生成時の基準となる）は、生体認証デバイスのユーザーのタイムゾーンと同一である必要があります。
   
   
8. 手動によるテストと送信を行います。いずれかの従業員のデータを試験的に同期します。SQLクエリーで、whereの条件の後、［downloadDate］列の名前を［eventTime］列の名前に変更し、従業員番号のフィルターを以下のとおり追加します。
   

   
   

    select employeeId, isCheckin, eventTime , [DownloadDate] FROM [ZAttendance].[dbo].[Attendance] where eventTime>=$1 and eventTime<$2 and employeeId=‘1001’

   
   

   ［Manual sync］（手動の同期）タブで［Get record count］（データ数の取得）をクリックして、データを取得およびアップロードしてZoho Peopleに送信します。

   
   
9. テストが完了すると、プラグイン画面で［Resume sync］（同期を再開する）をクリックすることで、自動的に同期を実行できます。
   
   
10. 設定のバックアップを取るために、Apache Software Foundationフォルダーに「Backup」という名前のフォルダーを作成し、Tomcatフォルダーの.configファイル（ファイルの種類：.xml）をコピーしたあと、Backupフォルダーに移動して貼り付けます。