---
title: "从电子表格上传员工"
description: "通过 Employee File 集成，从 CSV、XLS 或 XLSX 文件加载或更新你的员工，并读懂上传结果。"
sidebar:
  order: 2
area: directory
feature: employees
appPath: /settings/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
screenshots:
  - id: directory-employees-employee-file-panel
    caption: Settings 中的 Employee File 面板，带有 Download Sample File 和 Upload。
related:
  - directory/employees/reference-employee-properties
  - directory/employees/export-employees
  - integrations/employee-file
intercom:
  - id: "16755797"
    title: How to Upload Employee Data Manually (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2
    note: replaces
  - id: "6024080"
    title: How to upload employee data manually (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6024080-how-to-upload-employee-data-manually-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: directory/employees/upload-employees-from-a-spreadsheet.mdx
  sourceSha: 051ad972061a58edb0af5148cb90a042b5bfef40
---

没有连接 HRIS 时，电子表格就是员工进入 Pyn 的途径，也是保持他们信息最新的途径。每次上传时，各行按你的 `employeeId` 匹配，有变化的值被更新，文件中缺少的人则被标记为已从这个来源移除。

## 开始之前

- 你是工作区管理员。
- 你的文件有一个表头行，使用示例文件（第 2 步）中的列名，示例文件包含所有可接受的列；Pyn 会忽略它不认识的列。每一行都必须有 `employeeId` 和 `primaryEmail`。[员工属性](https://support.pyn.ai/zh-cn/directory/employees/reference-employee-properties/)标明了上传可以设置哪些属性。

![Settings 中的 Employee File 面板，带有 Download Sample File 和 Upload。](https://support.pyn.ai/media/directory/employees/directory-employees-employee-file-panel.png)

## 步骤

1. 在 Pyn 中，打开左侧导航底部的 **Settings**，然后打开 **Integrations**。如果你之前上传过，选择 **Installed** 和 **File Upload** 磁贴；否则选择 **Available** 和 **File Upload** 磁贴，这会创建该集成并打开它。两种方式打开的面板标题都是 **Employee File**。

2. 在面板的横幅中，选择 **Download Sample File**，得到一份包含所有列和示例行的 CSV，把它当作你的模板。

3. 检查有特定格式要求的列：日期写成 `yyyy-MM-dd` 或 `yyyy/MM/dd`，或者在 `.xls` 或 `.xlsx` 文件中用日期单元格；邮政编码这类数字单元格按工作表显示的样子读取，所以 `00000` 格式会保留前导零；`status` 为 `active`、`leave` 或 `inactive`（留空表示 active）；`country` 为名称或 ISO 代码；`timeZone` 为 IANA 名称，如 `Europe/London`（或留空并提供 `country`，对美国、加拿大和澳大利亚还要提供 `postalCode`）；`birthday` 为 `MM-dd`、`dd/MM` 或 `yyyy-MM-dd`；`managerId`、`buddyId`、`hrbpId` 和 `mentorId` 为另一行的 `employeeId`。

4. 选择 **Upload** 并选择文件。

5. 阅读横幅。**Uploading...** 之后出现 **Success!** 和 **Uploaded N records.**，表示每一行都通过了。否则横幅标题为 **There were N errors found in the uploaded file:**，并以 **Row #n:** 列出前五个错误，后面跟着列名和收到的值，例如 **startDate is invalid. Received: 12/01/2026** 或 **Could not determine timezone from country "United States". Add a postal code or choose a time zone.**，然后是 **As well as N additional errors...**。修复每一个列出的行并重新上传；只要有一行失败，整个文件都不会被应用。

6. 打开左侧导航中的 **Directory**。处理需要一两分钟；之后个人资料会出现在 **Active**、**Upcoming** 和 **Inactive** 下，或得到更新。

> **Caution:** 某人在早先的上传中已在 Pyn 里，但不在新文件中，就会被标记为已从 Employee File 来源移除。如果那是他们唯一的来源，他们的阶段变为 **Terminated**，并移到 **Inactive**。拿不准时，先导出，再在导出文件上编辑。

## 你应该看到什么

Employee File 面板的 **History** 标签页记录每次上传，并带有状态圆点。**Advanced** 列出 **Fields in Employee File**：见到的每一列，以及有多少行填了值。在 **Directory** 中，新行带着你文件中的值出现；另一个来源（比如 HRIS）已经提供的值不会被覆盖，因为在合并顺序中 Employee File 排在 HRIS 来源之后。

## 相关

- [员工属性](https://support.pyn.ai/zh-cn/directory/employees/reference-employee-properties/)，了解每一列以及哪个来源优先。
- [导出员工](https://support.pyn.ai/zh-cn/directory/employees/export-employees/)，从 Pyn 现有的数据开始你的下一次更新。
- [员工文件](https://support.pyn.ai/zh-cn/integrations/employee-file/)，了解该集成本身。
