---
title: "表单字段类型"
description: "表单或投票可以包含的六种字段类型、每种收集什么、能否设为必填，以及它在 Slack、电子邮件和 CSV 导出中如何呈现。"
sidebar:
  order: 3
area: flows
feature: forms
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-29"
audience: admin
related:
  - flows/forms/build-a-form
  - flows/polls
  - flows/forms/reference-webhook-api
intercom:
  - id: "16857779"
    title: Create and Use Forms (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16857779-create-and-use-forms-pyn-2
    note: draws on
translation:
  source: flows/forms/reference-form-field-types.mdx
  sourceSha: 34b6a2bcb59cb2d27704e24f9fa1ab3a071b6ecd
---

表单或投票编辑器中的 **Add Field** 打开 **Select Field**，有两个类别。每个字段都有 **Label**、**Description**，以及在允许的情况下的 **Required**。设置了 **Description** 时，在 **Text**、**Likert Scale**、**Buddy** 和 **Mentor** 字段上，它会取代标签成为回答者看到的文字，在 Slack 和回复页面上都是如此（在 **Preview** 中也是，但预览只显示 Common 字段）；**Checkbox** 以标签为标题，描述位于复选框旁边。让描述留空则显示标签。

## Common

| 字段 | 收集 | 可否必填？ | 在 Slack 中 | 在回复页面（电子邮件）上 |
| --- | --- | --- | --- | --- |
| **Text** | 最多 2,048 个字符的自由文本答案。 | 可以，在回复页面和 webhook 上；Slack 不强制 | 一个文本输入框 | 一个文本输入框 |
| **Checkbox** | 真或假。 | 不可以；未勾选的框是有效答案 | 一个复选框；在投票中是 **✓ Yes** 和 **✗ No** 按钮 | 一个复选框；在投票中是 **✓ Yes** 和 **✗ No** 按钮 |
| **Likert Scale** | 1 到 5 的数字：**Very Dissatisfied**、**Dissatisfied**、**Neutral**、**Satisfied**、**Very Satisfied**。 | 可以 | 单选按钮；在投票中是五个按钮 | 单选按钮；在投票中是五个按钮 |
| **Content** | 无。显示在字段之间的带格式文本，可含图片和链接。 | 不可以 | 该文本 | 该文本 |

## Employee Fields

| 字段 | 收集 | 可否必填？ | 在 Slack 中 | 在回复页面（电子邮件）上 | 写入 |
| --- | --- | --- | --- | --- | --- |
| **Buddy** | 目录中的一位员工。 | 可以 | 一个 Slack 用户选择器 | 一个姓名搜索：输入两个或更多字母，从最多十个匹配项中挑选 | 主体记录上的 **buddy** 关系 |
| **Mentor** | 目录中的一位员工。 | 可以 | 一个 Slack 用户选择器 | 一个姓名搜索：输入两个或更多字母，从最多十个匹配项中挑选 | 主体记录上的 **mentor** 关系 |

一个表单最多包含一个 **Buddy** 和一个 **Mentor** 字段。主体是注册所针对的员工。在注册之外回答的表单中，例如 webhook 提交或活动步骤，主体是表单发送给的那个人，或负载指定的员工。

在回复页面上，姓名搜索提供在职员工、待入职者和休假中的人，从不提供离职员工。它在消息发出后的 14 天内可用。之后该字段被停用，显示 **Choosing a person is no longer available for this form.**，并且不再是必填，所以表单的其余部分仍然可以提交。同一个链接搜索次数过多后，该字段显示 **This link has made too many searches.**

## 投票

投票使用同一个选择器，但没有字段可以设为必填。在回复页面上，第一次点击就完成投票；页面随后显示 **Submitted**，不能再回答其他字段。在 Slack 中，每个字段都可以点击。文本字段不会显示在投票的回复页面上；一个投票只保留一个李克特量表或复选框。见[投票](https://support.pyn.ai/zh-cn/flows/polls/)。

## 在导出中

**Export to CSV** 写入 `employeeId`、`submissionId`，然后每个字段一列，设置了描述时以字段的描述为列标题，否则以它的键为列标题。Content 字段被排除。李克特答案导出为其数字；复选框导出为 `true` 或 `false`；Buddy 或 Mentor 导出为所选员工的 id。`employeeId` 是这个人在你 HRIS 中的 id，Pyn 没有这个人的 HRIS id 时则为 `unknown`。

## 键与别名

在编辑器中添加的字段带有一个生成的键。对于 webhook，负载通过字段的**别名**（驼峰形式的标签，`Job Title` 变成 `jobTitle`）或键来命名字段。标签生成相同别名的两个字段无法被 webhook 区分。**Buddy** 或 **Mentor** 的 webhook 值是 Pyn 员工 id（36 个字符），而不是 HRIS id。见 [Webhook API](https://support.pyn.ai/zh-cn/flows/forms/reference-webhook-api/)。

## 相关

- [构建表单](https://support.pyn.ai/zh-cn/flows/forms/build-a-form/)，添加和配置字段。
- [投票](https://support.pyn.ai/zh-cn/flows/polls/)，了解一次点击的变体。
- [Webhook API](https://support.pyn.ai/zh-cn/flows/forms/reference-webhook-api/)，了解在负载中命名字段。
