触发器目录
触发器是把员工注册进自动化流程的规则。下面的表格按触发器在 Select Trigger 中所属的类别列出每一个触发器,附旁边显示的描述、它监测的数据、注册获得的参考日期,以及你可以在触发器的 Configure 标签页上更改的默认值;如果你的工作区启用了编辑重复注册,还可以在其 Advanced 标签页上更改。
触发器分为五类。日期触发器把员工记录上的某个日期与今天比较。关系和群组触发器在关系或群组成员身份变化的那一刻触发。表单提交触发器在表单完成时触发。Webhook 触发器在 Bob 向 HiBob webhook 推送员工事件时触发。定期触发器按时间表触发。
Employee Lifecycle
Section titled “Employee Lifecycle”| 触发器 | 应用中的描述 | 监测 | 默认起点 | 默认重复 | 参考日期 | 重复注册 |
|---|---|---|---|---|---|---|
| Will be joining | An employee first appears in the HRIS with a future start date, however far out. | 员工进入 Upcoming Employees 群组 | 进入的那一刻 | 不适用 | 记录出现的那天 | Never reenroll |
| Pre-onboarding | Prepare the employee prior to starting employment. | Start Date | 1 week before,窗口内触发(从一周前到入职日期的任何一天都会触发) | just once | 入职日期 | Never reenroll |
| Start of Onboarding | Steps to take at the commencement of employment. | Start Date | on the day of | just once | 入职日期 | Never reenroll |
| Off-boarding | Triggers when an employee is departing the organization. | Termination Date(Configure 标签页把该字段称为 Off-boarding) | the day before | just once | 离职日期 | 1 个月 |
Will be joining 监测 Upcoming Employees 群组,所以它没有偏移或重复设置,它的 Configure 标签页就是预选了该群组的 Group Change 表单。
Dates and Schedules
Section titled “Dates and Schedules”| 触发器 | 应用中的描述 | 监测 | 默认起点 | 默认重复 | 参考日期 | 重复注册 |
|---|---|---|---|---|---|---|
| Upcoming Anniversary | The upcoming anniversary of a start date. | Start Date | on the day of | every year | 匹配年份中的周年纪念日 | 1 个月 |
| Upcoming Milestone Anniversary | A significant anniversary (e.g. 5 or 10 years) | Start Date | on the day of | every 5 years | 匹配年份中的周年纪念日 | 1 个月 |
| Recurring Trigger | A trigger that runs on a recurring, periodic schedule | 一个时间表:Starting from Date (Inclusive)、Time、In Time Zone、Recurrence | 今天 10:00,按你浏览器的时区 | Weekly | 运行日期 | 1 天 |
每个日期触发器都可用的偏移
Section titled “每个日期触发器都可用的偏移”This flow starts:2 weeks before、1 week before、the day before、on the day of、the day after、1 week after、2 weeks after、1 month after、2 months after、3 months after、6 months after,或自定义的天数、周数、月数或年数。移动起点不会移动参考日期。
每个日期触发器上的重复选项
Section titled “每个日期触发器上的重复选项”| 选项 | 触发的年份 |
|---|---|
| just once | 日期本身,仅一次 |
| every year | 1、2、3…… |
| every year after the first | 2、3、4…… |
| every other year | 1、3、5…… |
| every 2 years | 2、4、6…… |
| every 5 years | 5、10、15…… |
| every 10 years | 10、20、30…… |
第 0 年,也就是日期本身,对任何重复选项都永远不会触发。Birthday 触发器只提供 every year。
Team and Org Changes
Section titled “Team and Org Changes”| 触发器 | 应用中的描述 | 监测 | 参考日期 | 重复注册 |
|---|---|---|---|---|
| Buddy Assigned | An employee was assigned a buddy. | 员工的伙伴关系被设置。主体是获得伙伴的员工。 | 变更当天 | 1 个月 |
| Promoted to Manager | An employee moves from zero to one or more reports. | 某位员工名下添加了第一位直接下属。主体是新任经理。 | 变更当天 | 1 个月 |
| Change of Manager | The reporting line for an employee has changed. | 员工的经理关系被设置或更改。主体是经理发生变化的员工。 | 变更当天 | 1 个月 |
| Group Change | An employee joins or leaves a group. | 你挑选的群组的成员身份,Trigger when 设为 Employee enters group 或 Employee leaves group | 变更当天 | 1 个月 |
| Change of Location | A change in the primary work location for the employee. | 员工加入某个国家群组。它的 Configure 标签页显示“This flow runs when an employee joins a matching group.” | 变更当天 | 1 个月 |
| Connected to Slack | An employee is matched to their Slack account. | 员工的 Slack 来源被连接。它的 Configure 标签页显示“This flow runs when an employee is connected to a matching source, such as Slack.” | 变更当天 | 1 个月 |
这个类别中的每个触发器都会忽略在你的 HRIS 或消息集成首次加载期间到达的变更,所以连接一个系统不会把每一位现有的经理、伙伴或 Slack 成员当作新的。Buddy Assigned、Promoted to Manager、Change of Manager 和 Change of Location 的侧面板显示“Only … after the first time the employee directory loads are included.”;Connected to Slack 显示“Only connections made after the first time the messaging integration loads are included.”;Group Change 没有这样的说明。
Form Submission
Section titled “Form Submission”| 触发器 | 应用中的描述 | 监测 | 参考日期 | 重复注册 |
|---|---|---|---|---|
| 一个表单,命名为 Submission: 表单名称 | Triggered when a submission is completed for: Submission: 表单名称. | 该表单已完成的非测试提交。主体是提交者。投票不会触发。 | 提交者所在时区的提交日 | Always reenroll |
Form Submission 自动化流程以 Verification 模式创建。
Employee Properties
Section titled “Employee Properties”| 属性类型 | 你要设置的 | 行为如同 | 参考日期 | 重复注册 |
|---|---|---|---|---|
| 日期(例如 Probation End Date、Tenure Date、Termination Date、Start Date) | 该属性 | 带完整偏移和重复选项的日期触发器 | 属性中的日期 | 1 个月 |
文本(例如存储为 MM-DD 文本的 Birthday,或某个自定义字段) |
该属性和一个要匹配的 Value | 在存储的值等于该文本时触发 | 员工所在时区的匹配当天 | Never reenroll |
| 是/否 | 该属性 | 在值变为 true 时触发 | 员工所在时区的匹配当天 | Never reenroll |
HiBob Webhook
Section titled “HiBob Webhook”| 触发器 | 你要设置的 | 监测 | 参考日期 | 重复注册 |
|---|---|---|---|---|
| 一个 Bob 事件,标题为 HiBob: 事件类型 | Webhook Type:Bob 的事件类型,与投递中显示的一致,例如 employee.updated。可选地再设置一个 Filter Key,即指向投递内部的点分路径,例如 data.employeeId 或 triggeredBy,以及它必须等于的 Filter Value;两者要么都设置,要么都不设置。 |
推送到 HiBob webhook 并且指向 Pyn 已从 Bob 同步过的员工的投递;见 HiBob。 | 投递到达的那一天,以员工所在时区计 | Always reenroll |
匹配是精确且区分大小写的,筛选把值作为文本比较,所以 Bob 发送的数字 id 仍然能匹配你输入的数字。Configure 标签页显示“Triggered by HiBob’s event type webhook for the employee.”,带筛选时还显示“Only when key is value.”。该自动化流程以 Verification 模式创建,不提供 Manual Enroll。请把它用于已在 Directory 中的人员的事件。这个类别在每个工作区的 Select Trigger 中都会显示,但只有在启用并设置了 HiBob webhook 的工作区才会收到投递。
模板目录触发器
Section titled “模板目录触发器”有些触发器只能通过 Add from Template 添加模板才能获得。它们使用同样的偏移和重复选项。
| 模板 | 触发器 | 默认起点 | 重复 | 重复注册 |
|---|---|---|---|---|
| Birthday celebration、Birthday opt-in | Birthday(“This is the birthday on the Employee Record.”) | 1 week before | every year | 1 个月 |
| 90-day check-in | Start Date,参考日期移到入职后 90 天 | 移动后日期的 2 weeks before | just once | Never reenroll |
| Check in with new manager | Promoted to Manager。参考日期是晋升当天 | 晋升当天 | 不适用 | 1 个月 |
| 触发器 | 应用中的描述 | 行为 | 重复注册 |
|---|---|---|---|
| Custom trigger | Triggered by an external system via custom code or integration. | 注册通过 API 或 Pyn 与你一起设置的集成到达。侧面板显示“This automation is triggered by an external system. Employees are enrolled via API or integration.”。它 Advanced 标签页上的 Prevent repeat enrollments 在每个工作区中都是只读的。 | Always reenroll |
| No trigger | Will not trigger automatically. Employees can be manually enrolled. | 只有 Manual Enroll 能添加人员。Audience、Exit conditions 和 Advanced 标签页被关闭。 | Never reenroll |
列出但不可选择
Section titled “列出但不可选择”Leave Based(Leave Requested、High Leave Balance、Departing on Leave、Returning from Leave)、Sales Enablement(Increase stalled opportunities、Increase in no-show meetings、Drop in Email open rate)和 Support Enablement(First 100 tickets、Increase repeat escalations、Drop in CSAT)类别显示横幅“Some triggers are only available with the associated integration and plan”。其中每一行都处于未激活状态,无法选择。