表单字段类型
表单或投票编辑器中的 Add Field 打开 Select Field,有两个类别。每个字段都有 Label、Description,以及在允许的情况下的 Required。设置了 Description 时,在 Text、Likert Scale、Buddy 和 Mentor 字段上,它会取代标签成为回答者看到的文字,在 Slack 和回复页面上都是如此(在 Preview 中也是,但预览只显示 Common 字段);Checkbox 以标签为标题,描述位于复选框旁边。让描述留空则显示标签。
Common
Section titled “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
Section titled “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 中,每个字段都可以点击。文本字段不会显示在投票的回复页面上;一个投票只保留一个李克特量表或复选框。见投票。
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。
- 构建表单,添加和配置字段。
- 投票,了解一次点击的变体。
- Webhook API,了解在负载中命名字段。