同步频率与匹配
每个集成按自己的计划刷新,并把每次运行记录在 History 下;Directory 按来源自己的 id 或邮箱把记录匹配到员工。这份参考列出各项计划和匹配规则,以及 Pyn 决定员工时区所用的顺序。
| 集成 | 刷新 | 另外 |
|---|---|---|
| BambooHR | 大约每小时一次 | 在启用了 BambooHR webhook 的工作区中,两次刷新之间接收来自 BambooHR 的变更通知;没有变化的运行记录为已跳过 |
| HiBob | 大约每小时一次 | 在启用了 HiBob webhook 的工作区中,Bob webhook 接受的每条投递在 History 下记录一次;没有变化的运行记录为已跳过 |
| Rippling | 大约每小时一次 | |
| Workday | 大约每小时一次 | |
| ADP Workforce Now | 大约每小时一次 | |
| Greenhouse | 大约每小时一次 | |
| Ashby | 大约每小时一次 | |
| Google Workspace | 每个活跃日历大约每小时一次 | 定期日历事件;日历上的 Refresh Events 立即拉取 |
| Microsoft 365 | 每个活跃日历大约每小时一次 | 定期日历事件;Refresh Events 立即拉取 |
| Slack | 大约每小时一次 | 成员;在启用了频道刷新的工作区中还有频道,频道成员每天更新 |
| Jira | 每天两次 | 项目,以及向步骤开放的项目的问题类型 |
| Microsoft Teams | 没有计划刷新;由 Pyn 团队维护连接 | 团队成员和频道,由 Pyn 团队协助设置 |
| 电子邮件 | 每隔几分钟 | 投递事件 |
| Employee File、Sample Data | 每次上传或重新加载时 |
来源处的更改会在大约一小时内到达 Pyn。停用集成或暂停工作区会停止它的刷新。每次运行都出现在集成面板的 History 标签页下,用绿色、琥珀色或红色圆点表示成功、暂时性错误或致命错误。Last Refresh 和 Last Successful Refresh 显示在 BambooHR、Rippling、Slack 和 Google Workspace 面板的 Details 标签页上;其他面板只在 History 下显示每次运行。凭据失败会把集成移到 Needs Attention 🚨 并发出通知。
记录如何成为员工
Section titled “记录如何成为员工”Pyn 把每条来源记录匹配到员工时,先按来源自己的 id,然后按工作邮箱,再按个人邮箱,所以只有个人地址的入职前记录仍然能匹配。没有匹配到任何人的记录会成为一位新员工。因此:
- 工作邮箱相同的一条 HRIS 记录和一位 Slack 成员会成为同一位员工,两个来源都附加在上面。员工的资料列出每个来源,并带有 Disconnect 以取消其中一个的关联:“Disconnect this source? The employee will no longer take any of their details from it.”
- 来自 Greenhouse 或 Ashby 的录用者显示为即将入职的员工;当工作邮箱相同的 HRIS 记录到达时,它会附加到同一位员工,而不是创建第二位。
- 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)和每个触发器读取的都是这些阶段。
按收件人时区排期的步骤需要一个时区。Pyn 按以下顺序从来源记录中决定它:
- 来源提供的时区,形式为 IANA 名称(
Europe/London)、常见缩写或 Windows 时区名称。 - 国家加邮政编码,适用于美国、加拿大和澳大利亚。横跨多个时区的其他国家(包括巴西、墨西哥、俄罗斯和阿根廷)需要来源提供时区,否则落到第 4 步。
- 国家,适用于只有一个时区的国家。
- 否则使用账户设置中的工作区 Time Zone:“Employees without timezone data get messages in this default timezone.”
Workday 是例外:Pyn 只读取 Time_Zone 列,形式为 IANA 名称或 Workday 自己的时区名称,例如 GMT-05:00 Eastern Time (New York),不会从国家或邮政编码推导时区,所以没有时区的 Workday 员工会得到工作区默认值。
多时区国家的 Employee File 行如果没有 timeZone 或 postalCode,会被拒绝并提示 “Could not determine timezone from country … Add a postal code or choose a time zone.” 自定义电子邮件收件人有自己的 Time Zone 字段,回退规则相同。