様々なご質問

図でのご説明で恐れ入りますが、まず、まる１のAPPS PASSからは、１分に１度、溜めた打刻データをTeamSpiritのまる２のデータベースに向けて直接送信します。
打刻されたデータはすべてTeamSpiritのまる２にすべて記録されます。

送信されるまでは端末の不揮発メモリに保持され、消えることはなく、端末後は端末には保持しません。


そしてまる３のTeamSpiritの５分間隔のバッチ処理の中で、TeamSpiritの設定を反映させた時刻を勤務表に記録します。

なおまる２のデータはチームスピリットにサンプルでインストールされていますレポートを
カスタマイズすることで閲覧することができます。

APPS PASSはTeamSpiritの社員と同期しており、端末から簡単に紐付けすることができます。よくある操作のご質問は以下となります。

• 「新入社員のICカードの紐付け方法、どうやるんでしたっけ？」
• 「ICカード・ライセンスをまとめて付与できますか？」
• 「ICカード・ライセンスを他の社員に付け替えられますか？」

APPS PASSは「ICカードをタッチした時点での、タイムレコーダーに表示されている時刻」がTeamSpiritの打刻時間になりますので、タイムレコーダーの表示時刻とTeamSpiritの記録時刻がずれることはございません。
なお端末自体はNTPサーバと同期しており時刻を合わせております。

APPS PASSの仕様としては、TeamSpiritのWEB打刻と同様に、出勤であれば早い方が優先され、退勤であれば遅い方で上書きとなります。（同日内）

端末とTeamSpiritの組み合わせの場合でも、どちらで打刻したかに関係なく上記の通り勤務表に反映されます。

TeamSpiritの仕様に準じますが、TeamSpiritで制御することはできません。

例

「出社打刻がない状態」でAPPS PASS退社打刻→　退社時間が入ります。

「直行・直帰申請をON」「直行：未承認」の状態でAPPS PASS退社打刻→　退社時間が入ります。

TeamSpiritの「退社後の再出社打刻可能」をONにして、1日に2回以上打刻を記録する場合、TeamSpiritではA→Dの流れを辿りますが、APPS PASSも同様となります。

■出退社動作

A.出勤 09:00
↓
B.退勤 15:00
↓
C.２回めの出勤が17:00
↓
D.２回めの退勤が19:00

■勤務表
出社 09:00
休憩開始 15:00　（自動的に休憩開始となる）　休憩終了 17:00　（自動的に休憩終了となる）
退社 19:00

B→Cの間が休憩となります。

１回の打刻につき、以下の情報を端末に記録し、送信いたします。

・端末で読み取ったICカードのICチップの個体番号（IDｍ（UID））
・打刻種別（出社や退社など端末でタッチされた際の打刻の種類）
・打刻日時
・打刻されたピットタッチのシリアル番号とプログラムのバージョン

なお、TeamSpiritの社員IDを特定するもの等はICカードにも端末にもデータはないため、TeamSpiritに送信もされません。

端末で読み取ったIDｍを、TeamSpiritに格納されておりますIDｍと照合して、TeamSpiritのシステム上で社員IDを特定します。

また連携するために記載した内容に加え、Salesforceへの認証用トークン情報も送信しております。

はい、端末からTeamSpiritへは１分に１度打刻されたデータをまとめてSSLで送信しますため、暗号化されています。

「専用端末　←A→　TeamSpirit　←B→　TeamSpirit勤怠表」

APPS PASSはA.Bの２種の同期を経て勤務表に記録します。

まず、Aの部分はTeamSpiritの管理者画面で設定が可能です。
現在最短は1分間隔、Bの部分のバッチ処理は５分間隔固定となっており、
A+B＝合計６分以内となります。

AとBの組み合わせによっては、専用端末にタッチした数秒後にAの処理間隔のタイミングが来て送信、Bの処理間隔のタイミングも数秒後に来て、数秒で勤怠表に記録されることもありますし、６分まるまるかかる場合もあります。

なおAの部分は、分数が短いとAPIのコール数も増え、API消費量の上限とも絡んできますので、もしいくつか複数のアプリを使う場合は注意が必要になります。（その場合1分間隔を最大60分間隔まで遅らせることもできます）

またAの専用端末の1分周期は、それぞれ、端末が稼働した時からの1分周期、Bの５分周期はバッチスクリプトを打ったときからの５分周期となります。

打刻機で打刻された際に、その方がTeamSpirit上で休暇かどうかを判別することができず、下記のような挙動となっております。

・全休の場合
　全休の場合はAPPS PASSの打刻時刻は勤務表に表示されますが、勤務時間と認められない状態です (月次確定時を行うとエラーになります) 。
　この状態から月次確定を行うためには、休暇申請を取り消すか、打刻時刻をクリアする必要があります。

・半休の場合
　・午前半休の場合で、その時間の中でAPPS PASSで出社打刻された場合、打刻はTeamSpirit内部には記録されますが、勤怠表には午前半休明け後の出社時間が表示されます。
　・午前半休の場合で、その時間の中でAPPS PASSで退社打刻された場合、打刻はTeamSpirit内部には記録されますが、勤怠表には午前半休明け後の退社時間が表示されます。
　・午後半休の場合で、その時間の中でAPPS PASSで出社打刻された場合、打刻はTeamSpirit内部には記録されますが、勤怠表には午後半休に入る前の出社時間が表示されます。
　・午前半休の場合で、その時間の中でAPPS PASSで退社打刻された場合、打刻はTeamSpirit内部には記録されますが、勤怠表には午後半休に入る前の退社時間が表示されます。


なお上記の場合でも勤務表に記録されますのは、打刻者にその旨を気づかせたいためという意図があるTeamSpiritの仕様となります。

詳しくはTeamSpirit側の設定となりますが、例えば勤務体系の設定の「勤怠時刻修正申請」を使用しますと、この申請を上げない限り、打刻忘れも含め勤務表からの修正ができなくなります。

APPS PASSの端末打刻では「定時打刻ボタンの使用」と同じ動作はできません。
定時出社/退社打刻ボタンはWEBに表示されるTeamSpiritのタイムレコーダーのボタンのみ動作します。

APPS PASSの場合以下のような動作になります。
（定時の時間は、各勤務体系の「始業終業の時刻」を参照します）

■「定時打刻ボタンの使用」の仕様
・定時出社打刻ボタン: 始業時刻を過ぎている、または出社打刻済みの場合はボタンは無効（押下できない）
・定時退社ボタン　　: 終業時刻より前の時刻、または退社打刻済みの場合はボタンは無効（押下できない）
・PCの管理画面のみボタンは表示されます。モバイルではできません。

■APPSPASS端末打刻の仕様
・勤務表に反映された出社時刻、退社時刻に対する端末からの打刻の優先順位は
　出社の場合は早い方が優先され、退社時刻は遅い方が優先されます。

■端末からの打刻による定時出社/退社打刻ボタンの影響
・端末打刻の時間はTeamSpiritの定時出社/退社打刻ボタンの影響を受けません。
・定時打刻ボタンの使用＝ONの場合（仮に定時が（9:00-18:00)の場合）

　・定時出社時間前に端末から打刻
　→端末からの打刻時間がそのまま入ります。
　 定時にはなりません。
　　また例えば定時出社打刻ボタンを8:00に押し
　　一旦勤務表に9:00と記録されても
　　その後8:30に端末から打刻した場合は8:30が記録されます。（早い時間が優先）

　・定時出社時間後に端末から打刻
　　→端末からの打刻入ります。
　　　定時にはなりません。（もともと定時出社ボタンは始業時刻より後の時刻では押せません）
　　　また例えば定時出社打刻ボタンを9:00に押し
　　　一旦勤務表に9:00と記録され
　　　その後9:30に端末から打刻しても勤務表は9:00のままです。（早い時間が優先）

　・定時退社時間前に端末から打刻
　　→端末からの打刻入ります。
　　　定時にはなりません。（定時退社ボタンは終業時刻より前の時刻では押せません）
　　　また例えば端末で17:30に退社し
　　　一旦勤務表に17:30と記録されても
　　　その後18:00以降に定時退社ボタンを押した場合は18:00が記録されます。（遅い時間が優先）

　・定時退社時間後に端末から打刻
　　→端末からの打刻時間がそのまま入ります。
　　 定時にはなりません。
　　　また例えば定時退社打刻ボタンを18:30に押し
　　　一旦勤務表に18:30と記録されても
　　　その後19:00に端末から退社打刻した場合は19:00が記録されます。（遅い時間が優先）

たとえばTeamSpirit管理メニュー ＞ 勤怠設定・勤務体系一覧 ＞ 勤務体系の設定の
基本設定 - 申請関連設定 の残業申請および早朝勤務申請で
「使用する」「申請の時間帯以外の勤務は認めない」にチェックを入れた場合、
打刻機からのデータの処理について、こちらの設定で打刻動作がエラーになることはありません。

勤務表へも問題無く打刻時刻が反映されます。また、勤務確定時にもエラーになりません。
これはPCからの打刻、PitTouch打刻いずれも同様です。

この設定を有効にすると、申請が無い場合、時間外労働が実労働時間に反映されなくなります。

実労働時間は、月次サマリーやレポートなどに集計・出力されており、月次サマリーの方は都度確認することができます。（レポートへは勤務確定時に反映されます）

なおこちらはTeamSpirit内の処理動作になりますため、詳細は個々にチームスピリット様にご確認をいただくことをお勧めいたします。（当社からのエスカレーションも可能です）

月次確定や日次確定で対象日の出退勤が操作出来ない状況ではPittouchからも同様に操作出来ない（＝上書き出来ない）になります。
日数が経過していても上書きできる状態であれば通常と同様のTeamSpiritのルールで、出勤より早い時間と退勤より遅い時間で上書きされます。

質問の状態にするには、２通りの方法がございますが、それぞれ以下の動作がTeamSpiritの仕様となります。

■該当の社員に退社日を入れた場合
↓
端末で打刻を行いますとTeamSpirit内のデータ処理の際にエラーになり、勤務表にも反映されない仕様となります。

TeamSpiritとAPPS PASS端末（１台あたり）とのAPIコール数について、最低限必要なコール数として
1時間あたり：

60 ÷ 同期間隔(分) × 3 (APIコール回数)`

となります。

TeamSpiritとAPPS PASS端末の同期間隔は管理画面で調整できますが、たとえば

5分間隔：60 ÷ 5 × 3 =  36回　１日 24時間で864回
4分間隔：60 ÷ 4 × 3 =  45回　１日 24時間で1080回
3分間隔：60 ÷ 3 × 3 =  60回　１日 24時間で1440回
2分間隔：60 ÷ 2 × 3 =  90回　１日 24時間で2160回
1分間隔：60 ÷ 1 × 3 = 180回　１日 24時間で4320回

となります。

ただし、上記はあくまで最低限となり、下記が発生したときは別途追加コールが発生します。

・設定情報の取得、社員検索、IC登録を行ったとき、など

よって、これより多め (3倍) に見積っていただきますと安全かと思われます。（また台数も加味ください）

なお使用する組織の消費コール数と24時間あたりの最大コール数は以下で御確認いただけます。

[設定]-[管理]-[組織プロファイル]-[組織情報]-[API 要求数 (この 24 時間以内)]

APPS PASSのライセンス数は以下のメニューで確認することができます。（但し TeamSpirit Summer 2019(5.260) 以降）

1.TeamSpirit[管理メニュー]タブをクリック

2.環境設定（システム管理者向け）内の“【システム】システム関連の設定をする“をクリック

3.[TS Connect IC for PitTouch設定]メニュー内に以下が表示されます。

---
・許可されているカード数・・・当社よりご契約いただいておりますライセンス数

・登録可能カード数・・・ご契約ライセンス数のうち、ICカードの紐付けが可能な数

・登録済みのカード数・・・ご契約ライセンス数のうち、ICカードの紐付けが行われている数
---

なお、リストで表示したい場合は、管理メニューから以下の方法で検索が可能です。

1.TeamSpirit[管理メニュー]タブをクリック

2.環境設定（システム管理者向け）内の“【共　　通】社員の登録、配属、勤務 体系、権限設定、有休付与をする“をクリック

3.検索ボタンをクリック

4.任意の条件で検索が可能です。

---
・ICカード登録=登録済み/未登録

・ICカード利用可=利用可/利用不可
---

上記条件に該当する社員の一覧が表示されます。

チェックのタイミングですが、仮にAPPS PASS 100ライセンスを付与した場合、以下のタイミングでライセンス数チェックを実行します。

・端末で紐付けを行う時にチェック。
　101人目から「ライセンスが足りない」のエラーが表示されます。

・TeamSpirit「管理メニュー ＞ 社員一覧 ＞ 社員設定」　 TS Connect IC連携機能 利用可フラグをOFF→ONに変更した時にチェック。
　その時点でのICカードの登録枚数をカウントします。但しICカード100枚の紐付けがなければフラグは何人でもONにできます。

・データローダからの登録時にチェック。
　データローダー使用時にもライセンス数チェックは行われ、ライセンス数を超えてICカードを登録しようとした場合は登録エラーとなります。

なお、利用されない勤怠社員の利用可フラグをON→OFFに変更いただければ、ライセンスでの計算には含まなくなりますので、「利用可」フラグをON→OFFにすることで、別の方を紐付けることができます。

ライセンス上限の計算は「ICカード利用可でかつ退職していない(=退職日が入力されていないor退職日が当日の日付以降)社員に紐づくICカードの数」 < ライセンス数の上限 となります。

従って退職日が当日より前の値に設定されている場合はライセンスにカウントされません。

なお、ライセンスの余りがない場合は、TeamSpiritの管理メニュー ＞ 社員一覧 ＞ 社員設定から退社日を本日以降の日付に変更して保存しようといたしますと下記のエラーが表示され復活させることが出来ない仕様となっております。

「エラー：登録できるICカードが上限に達しているため、登録できません。」

APPS PASSの仕様としては、TeamSpiritのマイドメイン変更（例 cloudforce.comからsalesforce.comへ）を行いますと端末が接続エラーとなりますので、手動で修正対応が必要となります。手順としては、端末の管理画面より[端末情報表示]-[接続先組織] の画面で再度[登録]を行っていただき、再起動を行いますと新しいドメインを取得できます。

またドメイン変更の理由として、シングルサインオンの適用が考えられますが、現在のところはシングルサインオン後も問題なくご利用いただくことができます。また私のドメインの設定にある「 https://login.salesforce.com からのログインを防止」の箇所には依存いたしません。

実際はトライアルでお試しいただくことになりますので、詳細はお問い合わせください。

APPS PASSで動かしましたバッチ処理は

TeamSpirit 設定＞監視＞ジョブ＞スケジュール済みジョブ

から確認できます。
勤怠連携バッチスケジュールジョブ1-12というものになります。
（12こあるのは5分バッチのため60分の中に12回あるということとのことです）

スケジュール済みジョブの申請済みの時間が動かし始めた時間、開始時刻が直前に動かした時間となります。

恒久的に停止したい場合、スケジュール済みジョブの
勤怠連携バッチスケジュールジョブ1-12の左側に「削除」がありますので、そこを押しますと停止できますが、通常のAPPS PASSの運用で行うことはございませんので、事前にご相談下さい。

またバッチ処理の注意事項として、バッチを動かしたシステム管理者が退職などされた場合やシステム管理者でなくなった場合、バッチ処理が止まる可能性がありますのでご注意下さい。

休憩の開始は、複数回打刻された場合でも、開始時刻だけを複数回記録します。
その状態で、休憩の終了時刻が打刻されると、最初の休憩終了時刻が入っていない休憩を見つけて終了時刻として入力されます。

休憩の開始が入力されている状態で、休憩の終了が複数回打刻された場合、２回め以降の終了打刻は終了時刻だけの休憩として記録されます。

なお開始時刻、終了時刻だけの休憩は勤怠計算上無視されます。

所定休憩と重なるような休憩の開始や終了が入力された時、例えば以下のようなパターンの場合、

a.12:10休憩開始 12:50休憩終了
b.12:10休憩開始 13:10休憩終了
c.11:50休憩開始 12:50休憩終了
d.11:50休憩開始 13:10休憩終了

それぞれ以下のように都度マージ（結合）されます。
なお開始時刻、終了時刻だけの休憩は勤怠計算上無視されます。

a.
---休憩開始打刻(12:10)
休憩１　12:00-13:00
休憩２　12:10-
---
↓
---休憩終了打刻(12:50)
休憩１　12:00-13:00
休憩２　休憩は１にマージされ、休憩２の表示が消えます (12:10-12:50)
---

b.
---休憩開始打刻(12:10)
休憩１　12:00-13:00
休憩２　12:10-
---
↓
---休憩終了打刻(13:10)
休憩１　12:00-13:00
休憩２　13:00-13:10 休憩1に重なった時間はマージされ、休憩2の開始が13:00に変更されます。
---

c.
---休憩開始打刻(11:50)
休憩１　11:50-
休憩２　12:00-13:00
---
↓
---休憩終了打刻(12:50)
休憩１　11:50-12:00
休憩２　12:00-13:00 休憩2に重なった時間はマージされ、休憩1の終了が12:00に変更されます。
---

d.
---休憩開始打刻(11:50)
休憩１　11:50-
休憩２　12:00-13:00
---
↓
---休憩終了打刻(13:10)
休憩１　11:50-12:00
休憩２　12:00-13:00 休憩2に重なった時間はマージされ、休憩1の終了が12:00に、休憩３の開始が13:00に変更されます。
休憩３　13:00-13:10
---

TeamSpirit側の仕様により、出社・退社については、APPS PASSより送信された打刻データは時刻の丸めで設定された処理が施されて勤務表に反映されます。
なお休憩・休憩終了、外出・帰社はTeamSpirit側が未対応のため、現在はそのままの打刻時間が記録されます。

この場合、契約形態ではなく、どのTeamSpirit組織*かで可能か不可かが分かれます。

お客様のTeamSpiritが物理的に別々の組織の場合、APPS PASSの端末では、1つのTeamSpirit組織への書き込みとなりますので、ご要望には叶いませんが、１つのTeamSpirit組織の中に、理論的に各グループ会社を分けて管理されている場合は、１つの打刻機で可能です。

*TeamSpiritはそれぞれ組織IDという情報が割り当てられており、それを1組織と呼びます。詳しくはお問い合わせください。