介绍
字段作为飞书项目的核心组成部分，用于需求、缺陷等工作项的详情页信息展示，表格视图中列呈现与筛选、分组、排序条件，通过自由组合的字段实现自适应业务变化。
250px|700px|reset
功能入口
空间配置 → 工作项管理 → 需求、缺陷等工作项 → 字段管理
250px|700px|reset
字段管理
新建字段
以创建一个文本类型字段“备注”为例，点击右上角“新建字段”按钮新建字段。
250px|700px|reset
字段筛选与搜索
字段管理模块支持通过“字段类型”、“授权角色”、“有效性”与“默认值”快捷筛选。
250px|700px|reset
如果需要精准定位，可以点击右上角“搜索”，搜索功能支持通过字段名称、对接标识与 ID 检索。
250px|700px|reset
字段类型与清单
飞书项目默认提供了文本、选择、人员、日期、投票、其他与关联工作项等 7 种不同分类。7 种分类下又分不同的字段类型。具体使用场景如下：
- 需要对不同需求进行打标签，可以考虑使用“多选”类型字段；
- 需要一个地方填写产品 PRD 文档链接，可以考虑使用“URL 链接”类型字段；
- ...
分类 | 类型 | 介绍 |
文本 | 单行文本 | 可自由填写的文本，适合于单行的场景。类似需求名称名称可以采用单行文本。 |
| 多行文本 | 可自由填写的文本，适合于多行的场景，类似简单备注可采用。 |
| 富文本 | 支持富文本编辑器，包括插入图片、@人、文本格式等，描述内容可采用。 |
选择 | 单选 | 提供一组选项列表来选择其中的一个项目，菜单样式 |
| 多选 | 提供一组选项列表来选择其中的一个或多个项目 |
| 级联单选 | 可以选择多级分类下的一个项目 |
| 级联多选 | 可以选择多级分类下的一个或多个项目 |
| 单选按钮 | 按钮样式，提供一组选项列表来选择其中的一个项目 |
人员 | 单选人员 | 可搜索并选择一个人员 |
| 多选人员 | 可搜索并选择多个人员 |
日期 | 日期 | 通过日期选择器选择某一天 |
| 日期区间 | 可以选择起止日期，用于排期等时间范围选择 |
| 日期+时间 | 通过精确到秒的日期选择器选择某一天的具体时刻 |
投票 | 表态投票 | 允许用户对需求一个选项进行投票操作 |
| 单选投票 | 允许用户对需求一个选项进行投票操作 |
| 多选投票 | 允许用户对需求一个或多个选项进行投票操作 |
其他 | URL 链接 | 展示可以快速跳转访问的链接 |
| 数字 | 可自由填写的数字，附带快速增减按钮 |
| 附件 | 可上传保存一个或多个文件 |
| 开关 | 开关类型字段，提供是和否两种状态 |
| 系统外信号 | 只读信号标志，在系统内无法编辑，可通过 Open API 修改，可用作为阻止节点流转的条件。 |
| 多值系统外信号 | 只读信号标志，可标记多个外部平台对象状态，可通过 Open API 修改，可用作为阻止节点流转的条件。 |
| 复合字段 | 复合字段可设置添加一组子字段，并可对每个子字段进行配置。 250px|700px|reset 复合字段添加至表单后，可自行添加多组信息。 250px|700px|reset |
关联工作项 | 单选关联工作项 | 关联空间内支持的任一工作项类型，双方为关联关系、非父子关系 |
| 多选关联工作项 | 关联空间内支持的任一或多个工作项类型，双方为关联关系、非父子关系 |
系统默认字段 | 工作项类型 | 对应“流程配置”中配置的流程名，无法在字段上添加更改。 |
基础配置
基础信息配置
- 字段名称：字段的名字，用于配置需求、缺陷等工作项详情页的搜索识别；
- 字段类型：可以切换文本、选择、人员、日期、投票、其他与关联工作项等不同的类型字段；
- 配置选项：新增与删除选择类型字段的选项，高级配置可参考“选项高级配置”；
- 允许用户添加选项：允许用户在前台操作页面直接对选择类型字段添加选项。
250px|700px|reset
启用“允许用户添加选项”。
选择类型的字段如果打开了“用户侧可添加”，则选项 ID 为用户创建的名字，而非英文与数字混合的 ID。
数据规则配置
字段有效性
字段有效性用于控制字段在什么条件下才能被使用。例如：某 PMO 希望控制某业务线下的核心需求专用某标签字段，其他业务线一律无法使用该字段，避免误选影响业务数据。
250px|700px|reset
配置后，如下图所示，蓝色框内对应字段无法进行选择，默认-展示。
250px|700px|reset
注意：仅当字段有效时，默认值、显示条件等规则才生效。
字段有效性条件优先执行，接着执行显示条件、默认值。与显示条件不同的是，有效性无论是需求创建时还是创建后，均生效。
有效性配置修改后，工作项下的全部需求、缺陷等实例将会以新的规则重新计算该字段的有效性。如果没有定制化需求，请保持对应字段“字段默认有效”。
默认值
默认值可以在创建需求、缺陷时，设置字段的默认填充值，无需每次手动填写。注意，字段如有设置有效性，则需要满足有效性后，默认值才能显示。
250px|700px|reset
- 不展示默认值：创建需求、缺陷等实例时，对应的字段默认值为空；
- 统一展示默认值：创建需求、缺陷等实例时，对应的字段默认展示预设默认值，如创建需求时，默认展示需求类型为“业务需求”，个人可以根据诉求自行修改。
- 在条件下展示默认值：创建需求、缺陷等实例时，对应的字段根据条件来展示预设默认值。如创建缺陷时，选择业务线为“Video”时，缺陷优先级展示默认值为“P0”。个人可以根据诉求自行修改。
- 250px|700px|reset
生效方式：按条件配置默认值有「从上至下」和「取并集」两种生效方式。「从上至下」的方式会取首个符合规则的条件组的人员；「取并集」的方式会取所有符合规则条件的默认值的并集。其中，「取并集」的生效方式仅供部分「多选类型字段」可配置。
- 250px|700px|reset
- 250px|700px|reset
- 附录：不同类型字段默认值生效规则一览表
- 默认值生效规则 字段类型 支持「从上至下」规则配置 单行文本、多行文本、富文本、单选、多选、级联单选、级联多选、单选按钮、单选人员、多选人员、日期、日期区间、日期+时间、URL链接、数字、附件、开关、单选关联工作项、多选关联工作项 支持「取并集」规则配置 多选字段、多选人员、多选关联工作项
管理员配置后效果展示如下，注意，仅创建需求、缺陷等实例时生效，已经创建不生效。
250px|700px|reset
重复值检验
开启后，填写时将校验此字段是否重复，避免重复建单。
仅支持单行文本字段。
开启重复值校验后，当默认值与已有字段值重复时，默认值规则将失效。
250px|700px|reset
删除字段
字段废弃不用后，点击对应字段，再点击右上角删除按钮，即可删除字段。
250px|700px|reset
注意，字段已经应用至对应的需求、缺陷等实例，删除后对应字段默认移除，会影响视图筛选，且系统字段不允许删除。
进阶配置
对于一些类型字段，增加了一些特异化配置，如选项字段有“选项高级配置”、“选项复用”；关联工作项字段有“数据可见范围”设置。下面梳理了一些关于字段的特异化功能配置进阶内容。
选项配置
对于选择类型的字段，点击字段配置的“查看选项”，可以对选项名称、颜色、是否禁用、是否出现进行配置。
包括：单选类型、多选类型、级联单选类型、级联多选类型、单选按钮类型。
250px|700px|reset
选项颜色
添加选项后，系统会默认添加选项背景颜色，在选项后更改选择色盘中的颜色。
用于标识选项差异，例如优先级字段，低优、中优、高优的选项颜色依次加深。
250px|700px|reset
选项禁用
点击选项后的高级配置，可将选项禁用。
用于选项废弃后，之前选择此选项的数据需要保留。
250px|700px|reset
选项禁用后，新建表单或编辑表单时，该选项将不会出现。历史选择此选项的实例，字段值仍保留，可通过筛选进行查找。
250px|700px|reset
选项排他
开启后，该选项会与其他选项互斥。此功能只能在多选类型字段中配置。
适用于选项互斥的场景。
250px|700px|reset
选项满足条件展示
打开满足条件展示开关，若条件满足出现此选项，若条件不满足则隐藏此选项。
适用于避免空间成员误操作的场景。
250px|700px|reset
选项复用
考虑不同工作项之间会存在选择字段值需要进行选项复用的情况，如优先级同时出现在需求和缺陷中。飞书项目提供选择类型字段支持选项复用能力，一处修改，多处同步。
点击创建字段，选择字段类型为“选择”，在“配置选项”下点击“添加选项”，在弹出的窗口中，选择“自定义选项”或“复用已有字段的选项”。
250px|700px|reset
选择“自定义选项”时，即从零开始创建选项。点击下方”添加“选项完成选项添加。
250px|700px|reset
选择“复用已有字段的选项”后，在菜单中选择对应的工作项、选择对应的字段。同时选择对应的字段时支持展示字段值，方便快捷确认时候需要选择此字段。
250px|700px|reset
如果勾选“复制出一份数据”，则复制字段选项配置，当前字段独立维护选项，不与复用字段的选项进行联动修改；
如果勾选“与选项来源进行两端联动”，则与复用字段的选项配置双向同步，其中一个字段的选项配置修改会导致另一个字段的选项配置修改。
250px|700px|reset
点击确定，完成选项复用的创建。
数据可见范围
在使用关联工作项类字段，如规划版本、规划迭代、实际上车版本等字段时，通常有以下场景：
- 选项列表越来越长，是否可以将未启动、已结束 的版本、迭代实例从选项中去掉？
- 选项太多，多个业务线的多个版本都展示在下拉列表，是否可以只展示对应业务线的版本？
借助数据可见范围设置，管理员可根据实际业务情况设置相关字段的数据范围，同时用户在实际使用时可更精准定位到需要选定的版本、迭代或其它工作项。
250px|700px|reset
- 固定数据范围：固定筛选条件，设置后保存，前端页面将仅展示符合条件的关联工作项选项值，可设置多个条件，支持并且、或者、公式的计算关系。
- 通过条件控制数据范围：与“固定数据范围”相比，“通过条件控制数据范围”支持更复杂的业务场景，比如选择 A业务线后，只显示 A 业务线对应的版本、迭代。条件数据范围支持设置多组条件与数据范围。
复制至其他工作项
在多个工作项使用的常规通用字段，例如优先级、描述、文档等字段，需要在每个工作项重复创建？飞书项目支持在新建字段和编辑字段时，一键复制创建至其他工作项。
新建字段时，支持同步创建至其他工作项。点击“批量创建至其他工作项”，选择目标工作项，即可同步创建。
250px|700px|reset
编辑字段时，支持同步创建至其他工作项。在字段编辑页面右上角，点击“...”-“复制至其他工作项”，选择目标工作项，即可复制创建。
250px|700px|reset
250px|700px|reset
可复制的字段配置：
- 字段信息：字段名称、字段类型、字段ID、对接标识、帮助说明
- 字段选项：选项名称、选项ID、选项启用与禁用
- 用户是否可以添加选项
- 授权角色
- 默认值：仅支持复制“不展示默认值”或“展示统一默认值”
- 有效性：仅支持“字段默认有效”
不可复制：
- 字段类型：单选关联工作项、多选关联工作项、计算字段（仅旗舰版客户可用）、复合字段
- 有效性条件：均复制为“字段默认有效”
- 默认值条件：均复制为“不展示默认值”
- 字段选项展示条件：均复制为“字段选项默认展示”
复合字段
对于复合字段，管理员可以在详情页中切换字段的显示样式，适配不同的展示诉求。列表模式适用于子字段较简单的复合字段场景，同时支持展示多行数据，信息密度高；表单模式适用于包含附件、富文本的复合字段，适合填写区域充足的场景。
250px|700px|reset
每组复合字段中的子字段支持分别设置必填属性，满足多个子字段必填差异化要求。
250px|700px|reset
在字段管理中，管理员可以通过拖动字段前方按钮，直接改变复合字段中子字段的展示顺序。
250px|700px|reset
条件公式
对于一些复合条件公式组，如且、或条件并行展示，可以通过条件公式简化输入。例如需要根据业务线、优先级针对性展示某个字段的默认值。当业务线为“消息”且优先级为“P0”或者业务线为“文档”且优先级为“P1”时，展示预设默认值。
- 首先点击“添加默认与条件”选项，添加多组条件，点击“并且”后选择“公式”选项。
250px|700px|reset
- 将条件前 A、B、C、D 代号结合条件输入到下方条件公式选框，上述场景公式为：(A And B) Or (C And D)
输入过程中如果提示公式不合法，请检查是否存在以下情况。
- 书写公式时，默认只能识别首字母大写的公式。如 and 需要书写为 And，or 需要书写为 Or；
- 括号内公式优先执行，请注意括号需使用英文半角括号。
250px|700px|reset
高级信息配置
- 授权角色：字段权限是独立控制，在“授权角色”选项中，可以控制不同角色是否有权限编辑此字段。设置后，仅有权限的角色才可以编辑字段。
- 对接标识：字段别名，可以用于 Open API 中；
- 帮助说明：补充说明该字段的含义，指引用户正确填写该字段，可添加文字链接。填写后，字段旁边会出现小标识；
250px|700px|reset
- 成员自动入群：在人员类型的字段中，勾选“成员自动入群”，字段中的相关人员自动加入工作项群聊。
250px|700px|reset
字段应用范围
工作项详情页配置
将字段配置在详情页后，创建需求、缺陷等实例时的新建页可以展示该字段。
250px|700px|reset
节点流表单配置
如需为每个节点下设置交付物或者需要表单信息填写，可以前往流程规则，在节点流转选项中配置表单即可。
250px|700px|reset
配置完成后，展示效果如下：
250px|700px|reset
任务交付物配置
250px|700px|reset
配置后效果如下：
250px|700px|reset
状态流表单配置
通常缺陷状态流转时，希望限制研发或测试填写某些表单或交付物后才能流转状态，则可以参考下方配置：
250px|700px|reset
配置后效果如下：
250px|700px|reset
视图使用
视图上展示对应字段，则可以在表格视图快捷添加字段。
250px|700px|reset
字段同时还可以作为筛选条件、分组和排序，按需生成不同场景下的需求清单。
250px|700px|reset
条件配置
角色出现方式、角色成员分配方式、字段显示条件、字段是否必填、字段可见性的条件均需要使用字段来设置条件。
功能实践
创建需求时，不同业务线关联不同流程
字段管理中搜索“类型”，选择需求类型，接着右侧选择默认值，添加条件即可。
250px|700px|reset
创建需求时，部分字段默认填充预设内容
点击“详情页布局”，选择需要展示默认值的字段，点击左侧“字段配置”，选择“默认值”配置默认还是按照条件展示。
250px|700px|reset
常见问题
如何批量修改实例中的字段信息？
目前只有管理员有权限批量修改字段信息，在列表页选中需要修改的实例后，可以点击批量修改按钮，则可以批量修改字段至目标值。
除了选择类型字段，还有什么类型字段支持复用？
暂无，仅选择类型字段，不包括关联工作项字段。
字段配置后如果被删除后，有什么影响？
如果已经应用在详情页、视图列表，那么会以 ID 形式展示，切换后无法选择。
