研发平台的字段配置，是围绕一个业务字段建立的一组规则设置，常见配置项包括字段类型、是否必填、默认值、可见性和校验规则。字段类型决定字段能存什么形态的数据以及可用的录入方式；必填决定提交时是否允许留空；默认值决定新建记录时字段的初始内容；可见性决定哪些角色在哪些场景能看到或编辑该字段；校验决定录入内容要满足什么条件才算合法。这些配置共同把业务规则固化到平台里，让同一类工作项在录入、流转和统计时保持一致。下文按配置范围、单项作用、组合关系、相邻概念和具体示例逐层展开。
要点总览（TL;DR）
- 研发平台字段配置是围绕单个业务字段建立的一组规则，常见配置项包括字段类型、必填、默认值、可见性和校验。
- 字段类型决定数据形态与录入控件，是其余配置项的基础；必填管提交时能否留空，默认值管新建时的初始内容。
- 可见性控制字段对哪些角色、在哪些场景展示或可编辑；校验检查录入内容是否合法，与必填分工不同。
- 配置项需要组合使用：类型与校验、必填与默认值、可见性与必填都要对齐，否则会出现规则卡住或口径不一致。
- 字段配置与状态流转、角色权限、表单布局分属不同配置层次，按“谁提交、谁可见、谁必填、值是否合法”做一次整体核对更稳妥。
字段配置到底在配置什么
字段配置的对象是业务对象上的单个字段。研发平台里常见的业务对象包括工作项、需求、缺陷、任务、工单等，每个对象上会挂一组字段，例如标题、负责人、优先级、预计上线日期、缺陷严重程度。字段配置就是针对其中某一个字段，设定它在系统中如何被识别、录入、展示和检查。它配置的是字段层面的规则集合，作用范围止于这个字段本身。
配置结果会同时影响四个环节。录入环节，字段类型决定出现文本框、日期选择器还是下拉选项；流转环节，字段值随工作项状态变化被读取和传递；展示环节，可见性决定字段出现在谁的界面上；统计环节，字段类型和选项集决定这个字段能否被稳定地分组、汇总和筛选。一个字段的配置质量，往往在统计报表出错时才被察觉，原因通常就出在类型不统一或校验缺失上。
需要明确的是字段配置不包括哪些内容。业务流程定义、状态流转规则、角色权限模型本身，都属于另外的配置层次。字段配置可以引用角色来决定可见性，可以配合状态来决定某状态下字段是否可编辑，但这些规则的制定主体是流程配置和权限配置，字段配置只负责字段这一层的约束。把字段配置当成流程配置来用，容易导致规则分散、难以维护。
五类配置项分别解决什么问题
五类配置项各自回答一个具体问题，约束发生的时点也不同。下表按“解决什么问题”和“约束时点”两个口径对照，便于快速定位。
| 配置项 | 解决什么问题 | 约束时点 | 典型判断依据 |
|---|---|---|---|
| 字段类型 | 这个字段能存什么形态的数据，用什么控件录入 | 录入前（决定录入方式） | 数据是文本、数值、日期、单选、多选还是人员引用 |
| 必填 | 提交时是否允许该字段为空 | 录入时（提交校验） | 缺少该值是否会导致后续流转或统计无法进行 |
| 默认值 | 新建记录时字段的初始内容是什么 | 录入前（初始化） | 多数情况下该字段有一个合理起点，可减少重复填写 |
| 可见性 | 哪些角色、在哪些场景能看到或编辑该字段 | 录入前与展示时 | 字段信息是否对某些角色敏感或无关 |
| 校验 | 录入内容满足什么条件才算合法 | 录入时（保存或提交校验） | 取值范围、格式、字段间逻辑关系是否有约束 |
字段类型是其余配置项的基础。类型一旦确定，可用的校验方式、默认值形态和统计口径都会随之收窄。例如日期类型字段可以设置“不得早于今天”的校验，数值类型字段可以设置区间校验，文本类型字段则更多依赖格式或长度约束。类型选错，后续配置往往只能打补丁。
必填约束的是提交动作。它回答的是“这条记录能不能在没有该字段值的情况下进入下一环节”。必填设置过宽，会出现关键信息缺失、报表大量空值；设置过严，则会让录入者在信息尚不明确时被迫填写占位内容，反而污染数据。判断依据应放在该字段缺失是否真的阻断后续工作，而不是“希望大家都填”。
默认值解决的是初始化效率问题。新建记录时，字段自动带入一个初始内容，录入者可以保留也可以修改。默认值适合那些多数情况下取值稳定的字段，例如新建缺陷时严重程度默认为“一般”、新建需求时来源默认为“内部提出”。默认值不等于固定值，它只是起点，不限制后续修改。
可见性解决的是信息暴露范围问题。同一个工作项，研发人员关注技术字段，业务方关注交付字段，管理层关注进度字段。可见性让不同角色看到与其工作相关的字段，减少界面干扰，也避免敏感信息在不相关角色面前展示。可见性通常与角色和场景绑定，配置时需要明确“对谁可见”和“在哪个页面或状态下可见”。
校验解决的是数据合法性問題。它在保存或提交时触发，检查字段值是否满足预设条件，例如数值范围、日期先后、文本格式、与其他字段的联动关系。校验与必填的区别在于：必填管“有没有”，校验管“对不对”。一个字段可以必填但无校验，也可以非必填但一旦填写就必须合法。
这些配置项如何组合成一条完整规则
单项配置只能表达一条简单约束，实际业务规则往往需要多项配合。组合得当，规则清晰且录入顺畅；组合失当，会出现规则互相抵消或录入者无所适从的情况。
类型与校验需要配合。类型限定数据形态，校验限定取值范围。以“缺陷严重程度”为例，选择单选类型并绑定一组固定选项，本身就限制了可选取值；如果再叠加校验，通常是检查该字段在特定状态下不允许为空或不允许选择某一档。类型已经收窄的范围，不必用校验重复表达，否则规则分散在两处，后续调整容易遗漏。
必填与默认值需要配合。把字段设为必填，意味着提交前必须有人给出值；配上合理默认值，则新建时已有起点，录入者只需确认或微调。两者组合能在保证完整性的同时降低录入负担。反过来，必填字段不配默认值，录入者每次都要从零填写，容易产生随意填写的倾向。
可见性与必填需要配合。对某一角色不可见的字段，不应同时对该角色设为必填，否则该角色在提交时会遇到无法填写却又无法通过的字段。这类组合失效在跨角色协作的场景中比较常见：字段对研发可见且必填，对业务方隐藏，但提交动作由业务方发起，规则就会卡住。配置时应按“谁提交、谁可见、谁必填”三者对齐检查。
组合失效还有几种典型情形。默认值指向的选项后来被停用，新建记录带入无效值；校验规则依赖的另一个字段被设为不可见，导致校验条件无法判断；可见性按角色收窄后，统计报表仍按全量字段取数，出现口径不一致。这些问题的共同点是配置分散在不同位置，缺少一次整体核对。
在ONES中，工单管理场景支持自定义处理流程与字段配置，并提供多维度数据统计与分析能力。字段配置与流程、统计在同一平台内衔接，调整字段规则时可以同步检查其对流转和报表的影响，减少上述分散配置带来的口径偏差。具体支持哪些字段类型和配置项，以实际产品配置界面为准。
容易混淆的相邻概念
字段配置经常与几个相邻概念混用，划清边界有助于把规则放到正确的配置层次。
| 相邻概念 | 主要管什么 | 与字段配置的边界 |
|---|---|---|
| 状态流转规则 | 工作项可以从哪个状态流转到哪个状态、由谁触发 | 字段配置管字段本身的规则；流转规则可以引用字段值作为条件，但流转定义不在字段配置内 |
| 角色权限 | 角色能访问哪些对象、执行哪些操作 | 可见性借用角色概念控制字段展示，权限模型决定角色能做什么，两者层次不同 |
| 表单布局与页面编排 | 字段在页面上如何分组、排序、折叠 | 布局决定字段放在哪里，字段配置决定字段是什么、能不能空、合不合法 |
| 数据字典与选项集 | 单选、多选字段的可选值集合及其维护 | 选项集是字段类型的一种配套资源，字段配置引用它，但选项的增删改属于字典维护 |
字段配置与状态流转的区别最容易被忽略。字段配置可以规定某字段在录入时必须合法，但不能规定“缺陷从待处理流转到处理中时必须填写修复方案”，后者属于流转规则或状态必填规则。把这类要求写进字段校验，会让字段在所有状态下都被约束，超出原本意图。
可见性与角色权限也常被混为一谈。可见性回答“这个字段对这类角色是否展示”，权限回答“这类角色能否访问该对象或执行该操作”。一个角色可能有权查看工作项，但其中某些字段对其隐藏；也可能字段可见，但该角色无权修改。配置时需要分别检查这两层，避免用可见性替代权限控制。
一个具体例子与常见误解
以“预计上线日期”字段为例，可以串起五类配置项。字段类型选择日期类型，录入时出现日期选择器，统计时可以按月份分组；必填设为是，因为排期评审需要该信息才能判断交付节奏；默认值可以设为新建需求时的当前迭代结束日，给录入者一个合理起点；可见性设为对研发负责人和项目经理可见可编辑，对其他角色只读或隐藏；校验设置为不得早于需求创建日期，防止录入明显不合理的日期。
配置完成后，录入环节的变化是录入者不再手写日期格式，减少格式错误；流转环节，排期评审可以按该字段筛选出未填日期的需求；统计环节，按月份汇总上线数量时口径统一。演示情景中这些效果依赖配置正确且角色对齐，实际效果还受流程设计和数据质量影响。
常见误解有三个。其一，把校验当成必填。校验只在有值时检查合法性，字段为空时校验通常不触发，因此“加了校验”不等于“必须填写”。其二，把可见性当成权限。隐藏字段只是不展示，不等于该角色无法通过其他入口获取或修改数据，敏感字段仍需权限层控制。其三，把默认值当成固定值。默认值只在新建时带入，录入者可以修改，若业务上确实不允许变更，应通过校验或流转规则限制，而不是依赖默认值。
理解这五类配置项各自回答的问题，再按“谁提交、谁可见、谁必填、值是否合法”的顺序做一次组合核对，字段配置就能稳定支撑录入、流转和统计，而不是在问题出现后反复修补。
常见问题
字段已经设了校验，为什么提交时仍然可以留空？
校验和必填约束的是两件事。校验在字段有值时检查内容是否合法，字段为空时通常不触发；必填则在提交动作上检查该字段是否被填写。因此“加了校验”只说明填了要合法，不说明必须填。如果业务上要求该字段不能为空，需要单独开启必填，并确认提交该记录的角色能看到并编辑这个字段。
字段对某个角色隐藏了，是否等于该角色无法修改这个字段的值？
不等于。可见性解决的是字段在界面上是否展示，权限解决的是角色能否访问对象或执行操作。字段隐藏后，该角色仍可能通过其他入口或接口接触到数据。对敏感字段，应在权限层控制访问和修改，可见性作为界面层面的配合手段，两者分别检查。
默认值设好之后，录入者还能改成别的值吗？
通常可以。默认值只在新建记录时带入一个初始内容，作用是减少重复填写，不限制后续修改。如果业务上确实要求该字段在某个阶段之后不允许变更，应通过校验规则或状态流转中的字段可编辑设置来限制，而不是依赖默认值。
跨角色协作时，字段配置最容易在哪个环节出问题？
常见问题出在可见性与必填没有对齐。例如字段对研发角色可见且设为必填，对发起提交的业务方隐藏，提交动作由业务方发起时就会卡住：看不到字段，却无法通过提交。配置时按“谁提交、谁可见、谁必填”三者逐一核对，可以提前发现这类冲突。
字段配置和状态流转规则应该怎么分工？
字段配置管字段本身的规则：存什么类型、能不能空、初始值是什么、谁可见、值是否合法。状态流转规则管工作项能从哪个状态到哪个状态、由谁触发。像“缺陷流转到处理中时必须填写修复方案”这类要求，属于流转或状态必填规则；写进字段校验会让该字段在所有状态下都被约束，超出原本意图。
