Workday
Workday 集成读取你的 Workday 管理员以服务形式发布(RaaS)的自定义报表,并让 Directory 保持最新。你通过选择报表的列来精确控制 Pyn 能看到什么,Advanced 标签页则显示哪些列到达了。
- 你是 Pyn 中的管理员或所有者。
- 一位 Workday 管理员创建自定义报表,把它启用为输出 JSON 的 Web 服务,并把它的 Report URL,以及能运行它的集成系统用户的 Username 和 Password 交给你。
- 报表应包含这些列,按名称匹配,忽略空格和下划线:
Employee_ID、WorkEmail、Name或Preferred_Name、Preferred_Name_First_Name、Business_Title、Hire_Date、Original_Hire_Date、Termination_Date、Worker_Status或Active_Status、Department_Name、Division、Business_Unit、Team、Manager_ID、Work_Country、Time_Zone(IANA 名称,例如Australia/Sydney)、用于入职前沟通的Home_Email_Address、Birthday(YYYY-MM-DD或MM-DD,接受斜杠;保留 2 月 29 日)、Worker_Type、Employee_Type、Employment_Type、Time_Type和Exempt。

-
在 Pyn 中,打开左侧导航中的 Settings,然后打开 Integrations 下的 Available。
-
选择 Workday RaaS 磁贴。Connect to Workday 对话框打开。
-
输入 Username 和 Password。
-
输入 Report URL。它必须以
https://开头;“That URL is not in the correct format.” 表示它不是以此开头。 -
选择 Connect。Pyn 运行报表时,对话框显示 “Validating those credentials…”
-
成功后,通知显示 “Your Workday RaaS has successfully been added to Pyn. It will take a minute or two for the employee data to be pulled from Workday.”
对话框可能显示的错误:“Could not verify the credentials. The username or password appear to be invalid.” / “Could not verify the credentials. The supplied URL is not in the correct format.” / 一条说明 Workday 返回了 “Down for Maintenance” 响应的提示,此时请稍等再试 / “An unexpected error occurred. Please check the details and try again. If the error persists, contact support.”,表示请求没有送达。
Pyn 大约每小时运行一次报表,并把每次运行记录在 History 下。Details 显示 Report Type(Employee、Candidate 或 Evergreen)、Username 和 Report URL;Advanced 列出 Fields in Report,并带有每个收到的列的计数。
| Pyn 属性 | 报表列 |
|---|---|
| 外部 id | Employee_ID 和 Worker_ID;两者混用的报表会同时保留两者 |
| 显示名称、法定姓名、常用名 | Name / Full_Name / Preferred_Name、Preferred_Name_First_Name |
| 工作邮箱、次要邮箱、个人邮箱 | Work_Email、CF_Additional_Work_Email、Email_Primary_Home / Home_Email_Address / Personal_Email |
| 入职日期、司龄起算日期、离职日期 | Hire_Date、Original_Hire_Date、Termination_Date / Term_Date |
| 状态 | Worker_Status(Active、On Leave 或 Terminated);否则为 Active_Status(1 或 0) |
| 职位 | Business_Title |
| 部门、分部、业务单元、团队 | Department_Name、Division / Division_Name、Business_Unit、Team |
| 国家、时区 | Country / Work_Address_Country / Work_Country、Time_Zone |
| 经理 | Manager_ID |
| 雇用类型 | Employment_Type |
| 豁免、工作者类型、员工类型、工时类型 | Exempt、Worker_Type、Employee_Type、Time_Type |
| 自定义列 | 映射到报表列的工作区扩展字段 |
列名匹配时不区分大小写,并去掉下划线和空格,所以 Hire_Date、HireDate 和 Hire Date 都可以。字段矩阵见 HRIS 字段。
在 Installed 下打开 Workday 磁贴,在 History 中查看是否有一次成功运行,然后把 Advanced 下的 Fields in Report 与你预期的列对照。打开员工并确认姓名、入职日期和经理。
重新连接或断开连接
Section titled “重新连接或断开连接”- Reconnect 打开 Reconnect to Workday,用户名和 URL 已填好;输入密码(以及任何更改过的值)并选择 Connect。“Your Workday RaaS has successfully been updated.” 表示成功,并清除错误状态。
- Deactivate 停止运行报表;Activate 恢复。
| 你看到的 | 含义 |
|---|---|
| History:“Error: Authentication failed, please reconnect” | 集成用户的密码已更改或账户已被禁用。重新连接。 |
| Fields in Report 下缺少某一列 | 它不在报表中,或者它的名称与 Pyn 读取的任何名称都不匹配。在 Workday 中添加或重命名它。 |
| 缺少人员 | 报表的筛选条件没有返回他们;检查 Worker_Status 或 Active_Status 以及报表覆盖的人群。 |
| 时区错误 | Time_Zone 缺失,或者不是 Pyn 识别的 IANA 名称或 Workday 时区名称。Pyn 不会为 Workday 时区读取其他任何内容,所以这些员工会得到工作区默认值。 |