跳转到内容
PynPyn

BambooHR

BambooHR 集成通过 BambooHR API 读取你的员工目录和一份自定义报表,所以入职日期、部门、经理和离职员工无需电子表格就能驱动你的流程。在启用了 BambooHR webhook 的工作区中,BambooHR 还会在两次刷新之间把变更通知 Pyn。

  • 你是 Pyn 中的管理员或所有者。
  • 你知道你的 BambooHR 公司域名:BambooHR 地址中 .bamboohr.com 之前的部分。
  • 你可以用一个有 API 访问权限、并能看到你想同步的字段的账户登录 BambooHR。非员工的服务账户比个人登录更好,因为个人登录会在那个人离职时失效。
The Connect to BambooHR dialog with the Company Domain field.
Connect to BambooHR asks for your Company Domain.
  1. 在 Pyn 中,打开左侧导航中的 Settings,然后打开 Integrations 下的 Available。

  2. 选择 BambooHR 磁贴。Connect to BambooHR 对话框打开。

  3. 输入你的 Company Domain。可以粘贴整个地址,例如 https://acme.bamboohr.com;Pyn 保留 acme。“This is not a valid company domain.” 表示它看起来不像 BambooHR 子域名。

  4. 选择 Connect。BambooHR 打开;登录并选择 Allow Access。

  5. BambooHR 把你带回 Pyn。面板显示 “You’re connected. Syncing can take a few minutes. Check the journey map then!” 如果你在 BambooHR 拒绝了访问,或在那里停留太久,你会回到 Installed,并看到一条标题为 BambooHR wasn’t connected 的提示说明原因:“You didn’t grant access, so nothing was connected.”或“The sign-in took too long, so nothing was connected. Try again.”

Pyn 大约每小时刷新一次;报表没有变化的运行会记录为 “Successfully integrated to BambooHR. No employee changes found”。在启用了 webhook 的工作区中,BambooHR 自己的变更通知到达时会记录在 History 下。Details 标签页显示 Subdomain、Primary Source(Custom Report 或 Directory)、Last Refresh 和 Last Successful Refresh;Advanced 标签页列出 Fields in Report,每个字段带有计数。

Pyn 属性 来自 BambooHR
显示名称、法定姓名、常用名 显示名称、全名和常用名
工作邮箱、个人邮箱 工作邮箱和家庭邮箱
入职日期 雇用日期;比它更早的原始雇用日期表示这是回聘员工
离职日期、状态 离职日期;Active 以外的雇用状态变为非在职
部门、分部、地点、职位 对应的 BambooHR 字段
雇用类型 雇用历史状态
经理 主管员工 id
生日、国家、邮政编码、时区 生日和地址;时区来自国家和邮政编码

如果 Pyn 用来连接的账户只能读取目录,面板会警告:“This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions.” 字段矩阵见 HRIS 字段。

打开 Installed 下的 BambooHR 磁贴,打开 … 菜单并选择 Test Connection。“Successfully tested the connection to BambooHR.” 表示成功;“An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists.” 表示登录已失效。然后检查员工。

  • Reconnect 为同一个公司域名重复 BambooHR 登录。在所连接账户的密码更改或权限扩大之后使用它。
  • Deactivate 停止同步;Activate 恢复同步。Archive 把集成从 Installed 中移除;已同步的员工保留。任一操作失败时,会弹出 Could not deactivate the integration 或 Could not archive the integration,并且什么都不会改变。
你看到的 含义
History:“Error: Insufficient permissions to access BambooHR” 所连接账户的访问级别失去了 API 或字段权限。在 BambooHR 中打开 Access Levels > Custom Levels,选择该级别,在 Access Level Settings 下允许 Settings > Company Field Settings,然后重新连接。
History:“Error: Authentication failed, please reconnect” 登录已过期或被撤销。重新连接。
History:“Could not connect to BambooHR, please reconnect” BambooHR 拒绝了连接。重新连接;如果重复出现,联系支持。
History:“BambooHR returned data in an unexpected format”(琥珀色) 一次刷新收到了 Pyn 无法读取的回复,通常是偶发的,所以集成保持活跃,下次刷新会再试。如果每次运行都出现,联系支持。
某人离职后员工不再更新 集成是用那个人的登录连接的。用非员工账户重新连接。
入职日期等字段为空 它们在 BambooHR 中为空,或者该账户看不到它们。检查 Advanced 下的字段计数。