同期の頻度とマッチング
各連携は自身のスケジュールで更新し、各実行をHistoryに記録します。Directoryはそのレコードを、ソース自身のidまたはメールアドレスで従業員と照合します。このリファレンスは、スケジュールと照合のルール、そしてPynが従業員のタイムゾーンを決めるのに使う順序をまとめています。
更新のスケジュール
Section titled “更新のスケジュール”| 連携 | 更新 | その他 |
|---|---|---|
| BambooHR | 約1時間に1回 | BambooHRのWebhookが有効なワークスペースでは、更新と更新の間にBambooHRからの変更通知。変更のない実行はスキップとして記録されます |
| HiBob | 約1時間に1回 | HiBobのWebhookが有効なワークスペースでは、BobのWebhookが受け付けた各配信がHistoryに一度記録されます。変更のない実行はスキップとして記録されます |
| Rippling | 約1時間に1回 | |
| Workday | 約1時間に1回 | |
| ADP Workforce Now | 約1時間に1回 | |
| Greenhouse | 約1時間に1回 | |
| Ashby | 約1時間に1回 | |
| Google Workspace | アクティブなカレンダーごとに約1時間に1回 | 定期的なカレンダーイベント。カレンダーのRefresh Eventsですぐに取り込みます |
| Microsoft 365 | アクティブなカレンダーごとに約1時間に1回 | 定期的なカレンダーイベント。Refresh Eventsですぐに取り込みます |
| Slack | 約1時間に1回 | メンバー。チャンネルの更新が有効なワークスペースではチャンネルも。チャンネルのメンバーは毎日更新されます |
| Jira | 1日に2回 | プロジェクトと、ステップで使えるプロジェクトの課題タイプ |
| Microsoft Teams | 定期的な更新はなし。Pynのチームが接続を維持 | チームのメンバーとチャンネル。Pynのチームと一緒に設定します |
| メール | 数分ごと | 配信イベント |
| Employee File、Sample Data | アップロードまたは再読み込みのたび |
ソース側の変更は約1時間以内にPynに届きます。連携を無効化するかワークスペースを一時停止すると、その更新は止まります。各実行は連携パネルのHistoryタブに、成功、一時的なエラー、致命的なエラーを示す緑、黄、赤のドット付きで表示されます。Last RefreshとLast Successful RefreshはBambooHR、Rippling、Slack、Google WorkspaceのパネルのDetailsタブに表示されます。ほかのパネルでは各実行はHistoryにのみ表示されます。認証情報のエラーが起きると、連携は「Needs Attention 🚨」に移り、通知が出ます。
レコードが従業員になる仕組み
Section titled “レコードが従業員になる仕組み”Pynは各ソースのレコードを、ソース自身のid、次に勤務先メールアドレス、次に個人メールアドレスの順で従業員と照合します。そのため、個人のアドレスしかないプレボーディングのレコードも照合されます。誰にも一致しないレコードは新しい従業員になります。つまり:
- 同じ勤務先メールアドレスを持つHRISのレコードとSlackのメンバーは、両方のソースが紐づいた1人の従業員になります。従業員のプロフィールには各ソースが一覧表示され、Disconnectで1つを外せます。「Disconnect this source? The employee will no longer take any of their details from it.」
- GreenhouseまたはAshbyからの採用者は入社予定の従業員として表示されます。同じ勤務先メールアドレスのHRISレコードが届くと、2人目を作らずに同じ従業員に紐づきます。
- Employee Fileは
employeeIdで最初に照合し、次に勤務先と個人のメールアドレスで照合するので、idが変わった行もメールアドレスが一致する限り同じ人に紐づきます。idとメールアドレスがすべて変わった行からは新しい人が作成されます。 - SlackやTeamsのメンバーシップだけでは従業員は作成されません。その人がHRIS、ファイル、またはATSから取り込まれている必要があります。
- HRISのフィールドはPynでは読み取り専用で、ソース側でのみ変わります。
従業員より後にPynに届いたマネージャー、HRBP、バディ、メンターは、次の更新で紐づけられます。
ライフサイクルのステージ
Section titled “ライフサイクルのステージ”入社日、退職日、アクティブフラグがステージを決めます。入社日より前はJoiner、入社日からはCurrent、退職日から、またはソースがその人を非アクティブにした時点でTerminatedです。ソースの休職ステータスはレコードにActive status: On Leaveとして保持され、ステージを変えません。ライフサイクルのグループ(Upcoming Employees、Current Active Employees、Terminated Employees、Inactive Employees)とすべてのトリガーはこのステージを読み取ります。
タイムゾーン
Section titled “タイムゾーン”受信者のタイムゾーンでスケジュールされたステップにはタイムゾーンが必要です。Pynはソースのレコードから次の順序で決めます。
- ソースが提供するタイムゾーン。IANA名(
Europe/London)、一般的な略称、またはWindowsのタイムゾーン名として。 - 米国、カナダ、オーストラリアでは国と郵便番号。複数のゾーンにまたがるほかの国(ブラジル、メキシコ、ロシア、アルゼンチンなど)はソースからのタイムゾーンが必要で、なければ4番目に進みます。
- タイムゾーンが1つの国では、その国。
- それ以外はアカウント設定のワークスペースのTime Zone。「Employees without timezone data get messages in this default timezone.」
Workdayは例外です。PynはTime_Zone列だけをIANA名またはGMT-05:00 Eastern Time (New York)のようなWorkday独自のゾーン名として読み取り、国や郵便番号からゾーンを導きません。そのため、タイムゾーンのないWorkdayの従業員はワークスペースのデフォルトになります。
複数ゾーンの国のEmployee Fileの行にtimeZoneもpostalCodeもないと、「Could not determine timezone from country … Add a postal code or choose a time zone.」として拒否されます。カスタムメール受信者には独自のTime Zoneフィールドがあり、同じフォールバックが適用されます。