---
title: "员工属性"
description: "员工的每个字段、员工之间的关系、把个人资料与其来源关联起来的外部 id、生命周期阶段如何决定，以及时区如何解析。"
sidebar:
  order: 3
area: directory
feature: employees
appPath: /directory/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - directory/employees/fix-missing-details
  - directory/employees/upload-employees-from-a-spreadsheet
  - directory/employee-groups/reference-group-types
intercom:
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: draws on
translation:
  source: directory/employees/reference-employee-properties.mdx
  sourceSha: 26c518f755f0f65bd8a7a9d1ee1045b6b8884d0a
---

员工个人资料是一组固定的属性，加上你的 HRIS 添加的任何自定义字段。第一列中的键是令牌使用的名称；当**上传列**为“是”时，它也是 Employee File 上传读取的表头。

## 属性

| 键 | 标签 | 上传列 | 说明 |
| --- | --- | --- | --- |
| `displayName` | Display Name | 是 | 到处显示的全名。 |
| `preferredName` | Preferred Name | 是 | 供令牌使用，例如问候语中的名字。 |
| `legalName` | Legal Name | 是 | 用于文件。 |
| `jobTitle` | Job Title | 是 | |
| `primaryEmail` | Primary Email Address | 是，必填 | 消息发往的工作地址。 |
| `personalEmail` | Personal Email Address | 是 | 没有工作地址时在列表中以斜体显示。 |
| `secondaryEmail` | Secondary Email Address | 是 | |
| `avatarUri` | Avatar Image | 是 | 一个 URL。为空时显示首字母。 |
| `startDate` | Start Date | 是 | 最近一次或下一次入职。`yyyy-MM-dd` 或 `yyyy/MM/dd`。驱动 Onboarding 和周年纪念触发器以及 Upcoming 视图。 |
| `terminationDate` | Termination Date | 是 | `yyyy-MM-dd` 或 `yyyy/MM/dd`。 |
| `tenureDate` | Tenure Date | 是 | 用于计算工龄的最初入职日期，与 Start Date 不同时使用。`yyyy-MM-dd` 或 `yyyy/MM/dd`。 |
| `probationEndDate` | Probation End Date | 否 | 只在有来源提供时显示。 |
| `birthday` | Birthday | 是 | 个人资料上为 `MM-dd`；上传还接受 `dd/MM`、`yyyy-MM-dd` 和 ISO 8601 日期时间。 |
| `businessUnit`、`department`、`division`、`location`、`team` | Business Unit、Department、Division、Location、Team | 是 | 自由文本。Department、Division、Location 和 Country 从一开始就是人口统计属性。 |
| `employmentType` | Employment Type | 否 | 自由文本，例如 Full-Time 或 Contractor，来自你的 HRIS。从一开始就是人口统计属性。 |
| `jobClass` | Job Class | 否 | 来自 ADP 的自由文本；可以成为人口统计属性。 |
| `country` | Primary Country | 是 | 个人资料上为 ISO 代码；上传接受名称。 |
| `postalCode` | Postal Code | 是 | 用于解析美国、加拿大和澳大利亚的时区。 |
| `timeZone` | Time Zone | 是 | IANA 名称。 |
| `locale` | Locale | 否 | BCP 47 标签，例如 `en-US`。缺失时从国家解析。 |
| `active` | Active status | 是，以 `status` 为列名 | **Active**、**Inactive**、**On Leave** 或 **Removed**。上传时为空表示活跃。 |
| `stage` | Lifecycle | 否 | 由 Pyn 算出；见下文。 |
| `exempt` | Exempt Status | 否 | **Exempt** 或 **Non-Exempt**（美国）。 |
| `workerType`、`employeeType`、`timeType` | Worker Type、Employee Type、Time Type | 否 | **Contingent Worker** / **Employee**；**Fixed Term** / **PEO** / **Regular**；**Full-Time** / **Part-Time**。来自 Workday 和 Rippling。 |
| `removed` | Removed | 否 | 当此人已从来源系统中消失时设置。 |
| `returningEmployee` | Returning Employee | 否 | 离职后再次聘用（BambooHR）。 |
| `missingSsn` | Missing Social Security Number | 否 | 是/否，来自 Workday。此行和下面四行只在 Pyn 已开启它们的工作区中显示在个人资料上。 |
| `orientationDate` | Orientation Date | 否 | 新员工的入职培训日期，来自 Workday。 |
| `orientationEligible` | Orientation Eligible | 否 | 是/否，来自 Workday。 |
| `over401kLimit` | Over-contribution to 401k | 否 | 是/否，来自 Workday。 |
| `surveyLink` | Survey Link | 否 | 此人当前调查的 URL，来自 Workday。 |

上传还需要 `employeeId`，即你自己为该行设定的稳定 id，并接受下面的四个关系列。Pyn 忽略任何其他表头，所以电子表格中 `employmentType` 之类的列不会设置任何内容。

HRIS 可以添加自定义字段；它们在 **Details** 上显示在标准字段之前，其中单选和多选字段出现在 **Filters** 列表中。字符串、布尔或单选属性可以成为人口统计属性：[创建人口统计属性](https://support.pyn.ai/zh-cn/directory/demographics/create-a-demographic/)。

## 关系

| 关系 | 上传列 | 用途 |
| --- | --- | --- |
| **Manager** | `managerId` | Manager 收件人和令牌；**Managers** 关系群组。 |
| **Buddy** | `buddyId` | Buddy 收件人；**Buddies** 群组。 |
| **HRBP** | `hrbpId` | HRBP 收件人和令牌；**HRBPs** 群组。 |
| **Mentor** | `mentorId` | **Mentors** 群组。 |

每个上传列存放同一文件中另一人的 `employeeId`。HRIS 提供自己的 id，由 Pyn 匹配。只有当相关的人是在职员工时，关系才对关系群组算数。

## 外部 id 和来源

Pyn 按系统自己的 id（BambooHR 员工 id、Workday worker id、Employee File 中你的 `employeeId`）和此人的电子邮件把记录匹配到同一个个人资料，所以工作电子邮件相同的一行电子表格和一条 HRIS 记录会成为同一位员工。用与某个个人资料匹配的电子邮件登录，会把该用户关联到它。

每个值都取自第一个提供它的来源，顺序如下：表单答案和 webhook 提交，然后是 Workday、BambooHR、ADP、Greenhouse、Ashby、Rippling、HiBob，然后是 Employee File。Slack 排在最后，并且只提供显示名称、常用名、主要电子邮件、时区和自定义字段。头像是例外：Slack 的图片优先于来自 HRIS 的图片。个人资料上的 **Sources** 标签页列出这些记录，某条记录上的 **Disconnect** 把它从合并中移除。

## 生命周期阶段如何决定

Pyn 把入职日期、离职日期和今天排序，并从顺序中读出阶段：

| 日期 | 阶段 |
| --- | --- |
| 已从来源移除 | **Terminated**，无论日期如何。 |
| 入职日期在未来（离职日期缺失或更早） | **Upcoming Joiner** |
| 入职日期已过，无离职日期或离职日期在未来，未被标记为非活跃 | **Current Active Employee** |
| 入职日期已过且被标记为非活跃（或没有雇佣来源） | **Terminated** |
| 离职日期已过 | **Terminated** |
| 完全没有日期 | 活跃则为 **Current Active Employee**，否则为 **Terminated** |

“被标记为非活跃”是指优先级最高的来源显示 `inactive`，或者没有任何来源是雇佣系统。Slack、Microsoft Teams、Greenhouse 和 Ashby 不是：只有它们知道的人被视为非活跃。`active` 为 `leave` 时在记录上显示为 **On Leave**，但不改变阶段：已入职的休假员工是 **Current Active Employee**。

## 时区如何解析

1. 来源提供的时区，如果它是有效的 IANA 名称、可识别的缩写或 Windows 时区名称。
2. 否则是国家和邮政编码，适用于美国（ZIP）、加拿大和澳大利亚。
3. 否则是国家，如果它只有一个时区。
4. 否则没有。发给此人的消息按 **Settings** > **Account Settings** 中工作区的时区发送，Employee File 上传会报告该行，让你补充时区或邮政编码。

## 相关

- [修复缺失的经理、时区或电子邮件](https://support.pyn.ai/zh-cn/directory/employees/fix-missing-details/)，了解如何改正一个值。
- [从电子表格上传员工](https://support.pyn.ai/zh-cn/directory/employees/upload-employees-from-a-spreadsheet/)，了解以这些键为表头的文件。
- [群组类型](https://support.pyn.ai/zh-cn/directory/employee-groups/reference-group-types/)，了解由这些属性构建的群组。
