研发平台自定义字段，是平台在系统内置字段之外，允许团队按自身业务规则新增的字段，用来记录团队特有的信息，例如缺陷的发现阶段、需求的客户来源、任务的验收方式。它由字段名称、字段类型、取值范围、适用对象和权限规则共同构成，本质是把业务规则落到平台的数据结构上，让工作项承载团队自己的管理口径。下面从定义、边界、组成和相邻概念几个角度展开。
要点总览（TL;DR）
- 研发平台自定义字段是平台内置字段之外由团队按业务规则新增的字段，用来记录团队特有的信息，例如缺陷的发现阶段、需求的客户来源。
- 一个可用字段由名称、类型、取值范围、适用对象和权限规则共同构成，缺一项都会影响统计和流程判断。
- 新增业务属性、扩展枚举选项属于自定义字段；内置字段改名、布局调整、保存筛选视图不属于。
- 自定义字段记录业务属性，状态描述所处阶段，标签是自由分类，工作流决定流转路径，四者职责不同、可以组合使用。
- 字段数量不等于管理精细度，建字段前先明确要支撑的报表和流程判断，建好后还要挂到对应工作项类型和视图才会生效。
自定义字段到底是什么
自定义字段是研发平台在系统预置字段之外开放的一类扩展配置。平台出厂时会带一批内置字段，比如标题、负责人、创建时间、优先级，这些字段的名称和含义由平台统一约定，所有团队用法一致。自定义字段则不同，它由使用方根据自身业务需要新增，字段叫什么、填什么、给谁看，都由团队自己决定。研发团队常见的用法是给需求加“客户来源”，给缺陷加“发现阶段”，给任务加“验收方式”，把平台原本不记录的信息补进去。
一个自定义字段要真正可用，通常需要同时确定几件事：字段名称（团队内部能看懂的业务叫法）、字段类型（决定能填什么值）、取值范围（可选值或数值区间）、适用对象（出现在哪类工作项上）、权限规则（谁能看、谁能改）。这几项合在一起，才构成一个完整的字段定义。只填了名称、没定类型和取值，字段就只是一个空标签，无法支撑统计和判断。
理解自定义字段的关键，是把它看作业务规则的载体，而非界面上的装饰。团队规定“影响客户的缺陷必须单独统计”，这条规则落到平台上，就是新增一个“影响客户”字段并设定取值；团队规定“需求要区分来自哪类客户”，落到平台上就是“客户来源”字段加一组枚举选项。字段是规则的技术表达，规则变了，字段的取值和用法也要跟着调整。反过来，如果一条规则只停留在口头或文档里，没有对应字段，平台就无法按这条规则筛选、统计和触发流程。
字段要素可以归纳为下面几项：
- 字段名称：团队内部统一的业务叫法，避免同一含义出现多种写法。
- 字段类型：文本、单选、多选、日期、数值、人员等，决定可填值的形态。
- 取值范围：枚举选项、数值区间或格式约束，限定可填内容。
- 适用对象：字段挂载的工作项类型，如需求、任务、缺陷、工单。
- 权限规则：字段的可见范围与编辑权限，区分谁能看、谁能改。
哪些算自定义字段，哪些不算
判断一项配置是否属于自定义字段，可以看它是否新增了平台原本不记录的业务属性。新增属性、新增枚举选项、新增日期或数值型取值，都属于自定义字段的范畴。把内置字段改个名字、调整表单上字段的排列顺序、保存一个筛选视图，这些操作改变的是展示方式或使用方式，字段本身承载的信息没有增加，因此不算自定义字段。
还有两类内容容易被混进来。一类是业务规则本身的定义，比如“什么算严重缺陷”“需求进入开发的准入条件”，这些属于相应业务主题的管理规则，自定义字段只是把规则的结果记录下来，规则怎么定要在业务层面讨论。另一类是旧平台字段配置的搬迁，涉及字段映射、历史数据迁移和流程衔接，属于工作流与扩展能力迁移的工作，超出单个字段的定义范围。
| 情形 | 是否属于自定义字段 | 说明 |
|---|---|---|
| 新增“发现阶段”字段并设定枚举值 | 属于 | 新增了平台原本不记录的业务属性 |
| 给已有单选字段增加一个选项 | 属于 | 扩展了字段的取值范围 |
| 新增日期型“承诺交付日”字段 | 属于 | 新增了日期取值 |
| 把内置“优先级”改名为“紧急度” | 不属于 | 字段含义未变，只是显示名称调整 |
| 调整表单上字段的排列顺序 | 不属于 | 属于界面布局调整 |
| 保存一个按负责人过滤的视图 | 不属于 | 属于筛选视图的保存，未新增字段 |
| 定义“严重缺陷”的判定标准 | 不属于 | 属于业务规则定义，归相应业务主题 |
| 把旧平台的字段配置搬到新平台 | 不属于 | 属于工作流与扩展能力迁移 |
自定义字段由哪些部分组成
字段的各个组成要素分工明确，缺一项都会影响字段的可用性。字段类型决定可填什么值，是字段最基础的约束；取值范围和必填规则决定数据质量，避免出现同一字段有人填“高”、有人填“紧急”的混乱；适用对象决定字段出现在哪类工作项上，防止把只适用于缺陷的字段挂到需求上；权限与可见范围决定谁能看、谁能改，涉及敏感信息时需要单独设置。字段值建好之后并非静止，它会随工作项流转，进入筛选条件、统计报表和流程判断，成为后续分析的数据来源。
| 组成要素 | 作用 | 配置不当的后果 |
|---|---|---|
| 字段类型 | 决定可填值的形态，如文本、单选、多选、日期、数值、人员 | 类型选错，后续统计和流程判断难以进行 |
| 取值范围 | 限定可选值或数值区间，统一填写口径 | 取值过宽，同一含义出现多种写法 |
| 必填规则 | 规定哪些环节必须填写，保证关键信息不缺失 | 全部必填会增加填写负担，全部选填会留下大量空值 |
| 适用对象 | 决定字段挂载到哪类工作项 | 挂错对象，字段在不相关的工作项上形成干扰 |
| 权限与可见范围 | 控制字段的查看与编辑权限 | 敏感信息暴露给不相关人员，或该改的人改不了 |
| 字段值流转 | 字段值随工作项进入筛选、报表与流程判断 | 字段孤立存在，无法支撑统计和自动化 |
以缺陷的“发现阶段”字段为例：类型选单选，取值限定为“需求评审、开发自测、测试、上线后”四档，适用对象设为缺陷，测试和开发角色可编辑，全员可见。这样配置之后，团队既能按阶段筛选缺陷，也能在报表里看到各阶段发现的缺陷占比，还能在流程中设置“上线后发现的缺陷需额外评审”的判断条件。字段的每一部分都在为这个链条服务。
在ONES中，工单管理支持自定义处理流程与字段配置，并提供多维度数据统计与分析能力。这意味着团队把“影响客户”“发现阶段”这类字段配置到工单或相应工作项上之后，字段值可以进入统计口径，用于观察工单分布和处理情况。字段类型、适用对象范围和字段级权限的具体配置方式，以平台实际提供的功能为准。
自定义字段和状态、标签、工作流有什么区别
这几个概念常被混用，但职责不同。状态描述工作项当前所处的阶段，比如“待处理、处理中、已关闭”，它回答的是“这件事进行到哪一步”；自定义字段记录业务属性，回答的是“这件事有什么特征”。标签是一种自由分类方式，谁都可以新建，取值不受约束，适合做粗粒度的归类；自定义字段有明确的类型和取值约束，适合需要统一口径、参与统计的场景。工作流决定工作项在状态之间的流转路径和触发条件，自定义字段则为这些判断提供依据，比如“影响客户为是的缺陷，关闭前必须经过客户确认”这条流程规则，判断依据就来自字段值。
| 概念 | 回答的问题 | 取值特点 | 典型用途 |
|---|---|---|---|
| 状态 | 工作项处于哪个阶段 | 由流程定义，数量有限 | 跟踪处理进度 |
| 标签 | 工作项大致属于哪一类 | 自由创建，无类型约束 | 粗粒度归类、快速检索 |
| 自定义字段 | 工作项具备什么业务属性 | 有类型和取值约束 | 统一口径、统计分析与流程判断 |
| 工作流 | 工作项如何流转、何时流转 | 由状态、条件和规则组成 | 规范流转路径与审批节点 |
区分清楚之后，配置时的选择也就明确了：需要跟踪进度，用状态；需要快速归类、允许随意打标，用标签；需要统一口径并参与统计，用自定义字段；需要规定流转路径，用工作流。四者可以组合使用，但各自承担不同职责，不宜互相替代。
一个具体例子与常见误解
下面是一个演示情景，用于说明字段如何承载业务规则，并非真实客户案例。某研发团队在缺陷处理中经常出现两类问题：一是缺陷发现得晚，修复成本高；二是客户反馈的问题和内部发现的问题混在一起统计，无法判断质量趋势。团队决定在缺陷工作项上新增两个字段：“发现阶段”，单选，取值为需求评审、开发自测、测试、上线后；“影响客户”，单选，取值为是、否。配置完成后，测试人员提交缺陷时必须选择发现阶段，客服转来的缺陷由对接人标记影响客户。运行一段时间后，团队可以按发现阶段统计缺陷分布，看到上线后发现的缺陷占比；也可以筛选出影响客户为是的缺陷，优先安排处理并单独复盘。字段在这里承担的是把“缺陷要区分发现时机和客户影响”这条管理要求变成可记录、可统计的数据结构。
实际使用中，有三条误解比较常见。
- 误解一：字段越多管理越细。字段数量增加会直接抬高填写成本，字段之间口径重叠还会造成统计混乱。合理的做法是先明确要回答的管理问题，再决定需要哪些字段，定期清理长期无人填写、无人查询的字段。
- 误解二：自定义字段可以随意改类型。字段类型变更往往涉及已有数据的转换，文本改成单选、单选改成多选，历史值可能无法直接映射，已经引用该字段的筛选、报表和流程判断也可能失效。调整类型前要评估存量数据和下游依赖。
- 误解三：字段建好就自动生效。字段创建后，还需要配置到对应的工作项类型，加入表单和详情页，必要时调整视图和报表，字段才会真正被使用。只建不配，字段会停留在配置列表里，无人填写。
把这三点放在一起看，自定义字段的价值来自“规则清晰、配置到位、口径统一”，字段数量本身并不构成管理精细度。团队在规划字段时，可以先列出要支撑的统计报表和流程判断，再反推需要哪些字段、每个字段的取值如何划分，最后检查字段是否已挂到正确的工作项类型和视图中。这样建出来的字段，才能稳定地承载业务规则，并在后续的分析和流转中持续发挥作用。
常见问题
团队应该先定业务规则还是先建字段？
先定规则。自定义字段是把业务规则落到平台数据结构上的手段，规则没想清楚就建字段，容易出现取值划分随意、字段之间口径重叠的情况。建议先写出要回答的管理问题，例如“上线后发现的缺陷占比多少”“客户反馈的问题是否被优先处理”，再反推需要哪些字段、每个字段的取值如何划分，最后配置字段并挂到对应工作项类型和视图。
字段建好之后发现取值不合理，能直接改吗？
需要先评估影响再改。调整枚举选项相对轻量，但删除已被使用的选项会让历史值失去归属；变更字段类型涉及存量数据转换，文本改单选、单选改多选时历史值可能无法直接映射，已经引用该字段的筛选、报表和流程判断也可能失效。稳妥的做法是先查清字段被哪些视图、报表和流程规则引用，再决定是修改原字段还是新建字段并逐步迁移。
自定义字段和标签都能用来分类，什么时候该用哪个？
看是否需要统一口径。标签自由创建、取值不受约束，适合粗粒度归类和快速检索，代价是同一含义可能出现多种写法；自定义字段有明确的类型和取值约束，适合需要参与筛选、统计和流程判断的场景。如果一类信息只是临时标记、不进入报表，用标签更轻；如果它要支撑质量趋势分析或流程分支，就应该建成自定义字段。
字段配置在ONES里如何进入统计和流程判断？
ONES 工单管理支持自定义处理流程与字段配置，并提供多维度数据统计与分析能力。团队把“影响客户”“发现阶段”这类字段配置到工单或相应工作项上之后，字段值可以进入统计口径，用于观察工单分布和处理情况。字段类型、适用对象范围和字段级权限的具体配置方式，以平台实际提供的功能为准。
字段长期没人填，应该删掉还是保留？
先判断是字段本身没价值，还是配置没到位。如果字段没有挂到对应工作项类型、没进表单和详情页，问题在配置，补齐后可能重新被使用；如果字段已正常展示但长期无人填写、无人查询，说明它对应的管理问题并不存在或已有其他字段覆盖，可以清理。定期做这类检查，能避免字段越积越多、填写负担持续上升。
