---
title: "Workday"
description: "从 Workday Report-as-a-Service 报表同步员工：要包含的列、Pyn 需要的凭据，以及如何阅读 Fields in Report。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: workday
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
intercom:
  - id: "12005093"
    title: Connect to Workday (Pyn 2)
    url: https://intercom.help/pyn/en/articles/12005093-connect-to-workday-pyn-2
    note: replaces
  - id: "6330048"
    title: Connect to Workday (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330048-connect-to-workday-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/workday/index.mdx
  sourceSha: 13613badcd0a5b4a1c787d5cd57ed82a0d1c1422
---

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`。

![Connect to Workday asks for the report Username, Password and Report URL.](https://support.pyn.ai/media/integrations/workday/integrations-workday-connect.png)

## 连接

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **Workday RaaS** 磁贴。**Connect to Workday** 对话框打开。

3. 输入 **Username** 和 **Password**。

4. 输入 **Report URL**。它必须以 `https://` 开头；"That URL is not in the correct format." 表示它不是以此开头。

5. 选择 **Connect**。Pyn 运行报表时，对话框显示 "Validating those credentials..."

6. 成功后，通知显示 "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 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)。

## 测试

在 **Installed** 下打开 Workday 磁贴，在 **History** 中查看是否有一次成功运行，然后把 **Advanced** 下的 **Fields in Report** 与你预期的列对照。打开[员工](https://support.pyn.ai/zh-cn/directory/employees/)并确认姓名、入职日期和经理。

## 重新连接或断开连接

- **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 时区读取其他任何内容，所以这些员工会得到工作区默认值。 |

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看目录。
- [HRIS 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)，查看字段矩阵。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解计划和匹配。
- [员工](https://support.pyn.ai/zh-cn/directory/employees/)，检查已同步的记录。
