页面导航

工作项详情页布局配置

工作项详情页呈现了单个工作项所需展示的字段信息，比如工作项名称、角色信息、关联的物料信息等等。飞书项目提供了自定义排版配置与丰富的字段供选用。

配置后展示效果如下：

管理员可以定义需要新建时填写的内容，也可根据具体的流程信息配置详情页表单项的出现条件、默认值、是否为必填项等，实现表单字段的动态展示，以应对不同场景下的使用。

本文将以需求详情页布局配置为例，其他如缺陷、迭代、版本与自定义工作项参考进行配置。

表单项资源库

功能要点

了解如何配置工作项详情页的字段展示；
了解如何在详情页布局页添加新字段。

左侧丰富的表单项资源库提供各种类型的字段以满足不同业务的工作项。如果表单项资源库已有的字段不能满足工作项，管理员可点击页面左下角的「添加字段」来自定义添加字段实现自己的工作项。

搜索字段或控件

侧边栏上可以搜索自己需要配置到详情页表单的字段，搜索完成后可以直接拖拽到详情页中。

添加字段

如果没有搜索到满足工作项的字段，可以选择添加新字段，比如当前页面缺少一个备注的文本字段。

详情页

功能要点

了解如何配置工作项详情页的字段展示；
了解如何通过排版合理规划详情页的信息展示；
了解如何使用详情页预览功能；

两栏配置

对于一些开关、选项字段，占用详情页的空间位置比较小，可以调整双栏展示让信息布局展示更清晰。

同样也支持鼠标移入调整页面布局占比。

标签页

为了方便用户管理工作项，用户可在工作项详情页下添加不同的标签管理工作项，如系统预置的评论/备注和操作记录；也可以尝试新建其他标签，并从表单项资源库选择需要添加的表单项拖到新建的标签页，即可实现自定义的标签。

配置后展示在详情页如下图所示：

注意的是，上图中的「GitLab 代码分支」以及「ByteCycle代码分支」标签均由插件控制。i

标签页解析

基本信息：详情页表单的信息
工作项排期：如果流程配置中设置了排期，则所有的排期会统一在工作项排期下显示
实验管理：如果开启了 AB 实验，可在实验管理下添加并管理实验
评论/备注：用户添加的评论
操作记录：用户相关的操作记录

字段展示方式

当字段的名称过长或者使用长英文名时，可以更改侧面标签为顶部标签。

添加新分组

针对一些相似的字段信息，可以使用分组进行聚合，比如新建一个版本信息，用来存放规划版本，上车版本。

注意：组内所有资源项不可见时，整组将不可见。

预览详情页

完整配置完详情页后，可以点击上方的「预览详情页」预览抽屉和全屏模式的展示。

表单项检查器

功能要点

了解如何根据特定条件启用、隐藏字段以及设置默认值。
了解如何配置新建工作项时的表单页配置；

用户可在表单项检查器设置从表单项资源库添加的表单项的出现条件，但每个表单项的表单检查器样式不一样，有些没有默认值、有些没有标签，而有些不可删除，视具体的表单项而定。

以下是表单项“文案内容”相关字段的解释，仅供参考：

表单项名称：可以针对原有的字段名称进行修改；

占位文本

占位文本可以实现对用户进行默认的提示、说明或引导等功能。如为 PRD 链接字段设置「请粘贴工作项 PRD 文档链接」说明字样。

使用侧展示效果如下：

附加说明

如针对设计稿字段增加「了解设计规范：https://project.f.mioffice.cn/workbench」说明文字。

使用侧展示如下：

是否可见

当单个空间并行多条业务线，且业务线的所需字段内容不同时，可以使用字段的可见性来针对不同业务线进行个性化。如需不选择自定义展示条件，可直接选择是否可为「默认全部可见」选项。

如需选择自定义展示条件，如「需要 AB」字段只对消息业务线可见，那么就可以修改「是否可见」为「在某些条件下可见」选项，添加一组条件选择对应的属于消息业务线即可。

在使用侧展示如下：

是否展示默认值

配置完「AB 实验」字段的可见性后，需要此字段在展示都自动是开的状态，而不是手动去点，这时候则需要为「AB 实验」字段配置可见性。

实际应用场景一般有：

选择「业务线」选项后，默认工作项类型为「产品类型」；
选择某个「工作项类型」后，默认是否开启「自动拉群」；
默认「安全合规」开关是打开状态，所有工作项需要走合规；
不同工作项类型，工作项描述提供不同的默认模板。

展示默认值选项解析

不展示默认值：新建工作项或在详情页中重选某些选项时，此选项默认为空；
统一展示默认值：新建工作项或在详情页中重选某些选项时，此选项展示默认是唯一的值；
在某条件下展示默认值：新建工作项或在详情页中重选某些选项时，根据条件展示默认值；

新建页配置

新建页可见

当为某个字段打开「新建页可见」开关时，该字段会默认出现在新建页的表单上。

是否必填

业务中针对一些必要字段可以设置为必填，即用户新建工作项时必填填写某字段内容才能完成创建。

是否必填选项解析

非必填：新建工作项时，此选项可填写可不填写；
必填：新建工作项时，此选项必须填写；
在某条件下必填：新建工作项时，在某些条件下才会展示必填，如选 A 业务线必填，选 B 业务线非必填。

使用侧会在必填项扎实红色「*」星号，效果如下：

查看新建页

新建页即使用侧创建工作项的页面，点击详情页配置右上角的「查看新建页」选项即可预览与配置字段展示位置与是否可见。

新建页界面中，可以调整选项位置，比如调整所有必填项前移。

如不需要某些选项，点击字段后🗑️删除即可。

使用侧效果展示如下：