工单提报模板的填写说明，核心是让提报人不用猜也能一次填对。写法上跟随模板结构：先按工单类型划分字段组，再逐字段写清填什么、怎么填、填到什么程度算合格，必填项标注并说明原因，条件显示字段写清触发条件，最后用示例和检查项收口。本文给出可套用的结构、逐字段句式、角色分工与发布前核对清单。
要点总览（TL;DR）
- 填写说明按“工单类型—字段组—字段—填写要求”四层排布，字段顺序与表单一致，公共字段组在前、类型专属字段组在后。
- 每个字段用“字段名—填写要求—示例—常见错误”四句式，把“描述清楚”改写成可判断的标准，如操作步骤、期望结果、实际结果三要素。
- 必填项统一标注并说明为什么必填；条件显示字段写清触发条件、出现位置和不满足条件时的状态。
- 编写人、评审人、维护人分工明确，模板变更时同步更新说明并记录版本，避免说明与表单脱节。
- 发布前用字段覆盖、必填与条件显示一致性、表述可判断性、试填验证四项核对，形成修订闭环。
填写说明先定结构：字段、必填与条件显示怎么排
填写说明的结构应当与模板字段一一对应，字段顺序、名称与表单保持一致。读者打开说明时，能按表单从上到下的顺序找到对应解释，不需要在文档里来回跳转。整体骨架可以按“工单类型—字段组—字段—填写要求”四层排布。
按工单类型划分字段组
先列出模板支持的全部工单类型，例如故障报修、账号权限申请、数据查询、功能咨询。每个类型下再划分字段组：公共字段组（所有类型都出现，如提报人、联系方式、提报时间）和类型专属字段组（仅该类型出现，如故障类的“影响范围”、权限类的“申请系统与权限项”）。说明文档按“公共字段组在前、各类型专属字段组在后”的顺序组织，每个字段组给一个小标题。
必填项标注方式及理由
在字段名后统一加“（必填）”或“（选填）”标记，全篇只用一种标记方式。必填项旁边用一句话说明为什么必填，例如“影响范围（必填）：用于判断是否需要升级处理，留空会导致工单被退回补充”。说明理由能让提报人理解留空的代价，减少随意跳过。选填项也建议注明“选填，但填写后可加快处理”，给出填写动机。
条件显示字段的触发条件写法
条件显示字段要写清三件事：触发条件、出现位置、不满足条件时的状态。推荐句式：“当【某字段】选择【某值】时，表单在【某字段】下方出现【字段名】，用于填写【用途】；未选择该值时此字段不显示，无需填写。”触发条件要引用具体字段名和具体选项值，避免“根据情况填写”这类模糊表述。
说明与模板字段的排布顺序
说明文档的章节顺序建议为：适用范围与工单类型清单、公共字段组说明、各类型专属字段组说明、条件显示字段汇总、填写示例、常见退回原因。字段说明部分严格按表单展示顺序排列，条件显示字段既在所属字段组内说明，也在“条件显示字段汇总”中集中列一次，方便提报人快速查阅。
每个字段的说明怎么写：四句式与写法示例
单个字段的说明采用固定四句式，让每个字段的解释长度和结构一致，提报人读几段后就能形成预期。四句式是：字段名—填写要求—示例—常见错误。
四句式模板
| 句式成分 | 写什么 | 写法要点 |
|---|---|---|
| 字段名 | 与表单完全一致的字段名称，附必填/选填标记 | 不改写、不缩写，条件显示字段注明触发条件 |
| 填写要求 | 填什么内容、格式、粒度、判断合格的标准 | 用可判断的表述，给出数量、格式或范围 |
| 示例 | 一条合格填写值，必要时加一条不合格对照 | 示例贴近真实业务，不写“某某”“待定” |
| 常见错误 | 提报人最常出现的两三种错误写法 | 指出错误后说明正确做法，不只说“不要这样写” |
把“描述清楚”改写成可判断标准
“请描述清楚问题”无法判断是否合格。改写时给出可核验的要素，例如：“问题描述（必填）：写清操作步骤、期望结果、实际结果三部分，操作步骤按顺序编号，至少包含发生问题的页面或功能名称。示例：1. 在客户列表点击导出；2. 期望导出全部字段；3. 实际只导出当前页 20 条。常见错误：只写‘导出有问题’，缺少步骤和期望结果，处理人需退回询问。”这样提报人知道写到什么程度算完成，处理人也能据此判断信息是否足够。
分类字段与自由文本字段的说明差异
分类字段（下拉、单选、多选）的说明重点是选项含义和选择依据，要逐项解释容易混淆的选项，并说明选错的影响，例如“选择错误的类型会导致工单流转到错误处理组，请按影响对象选择”。自由文本字段的说明重点是内容要素、格式和长度范围，必要时给出填写模板或分点结构。两类字段都要给示例，但分类字段的示例是“选哪个选项及原因”，自由文本字段的示例是“一段合格的填写内容”。
条件显示字段的说明示例
以“故障报修”类型为例：“影响范围（必填，仅当工单类型选择‘故障报修’时出现）：选择受影响的用户范围，选项为‘仅本人’‘本部门’‘多个部门’‘全部用户’。示例：财务部全员无法登录，选择‘本部门’。常见错误：选择‘全部用户’但实际只影响一个部门，会造成不必要的升级处理。”说明中同时注明该字段在表单中的位置，方便提报人定位。
角色分工与交付物：谁写、谁审、谁维护
填写说明写完无人校对、上线后无人更新，是这类文档最常见的失效原因。编写前先定三个角色和各自的交付物，把责任落到具体岗位而非“相关同事”。
| 角色 | 职责 | 交付物 |
|---|---|---|
| 编写人（通常是工单受理或服务台运营岗） | 按模板结构起草说明，逐字段写四句式，整理条件显示字段清单 | 填写说明初稿、字段与说明对照表 |
| 评审人（模板配置人、主要处理组代表） | 核对说明与表单字段是否一致，检查表述是否可判断，确认必填理由成立 | 评审意见清单、修订后的定稿 |
| 维护人（模板负责人） | 模板字段增删改时同步更新说明，记录版本与变更点 | 版本变更记录、更新后的说明文档 |
评审要检查的要点
评审不是通读一遍，而是按清单核对：字段名称与表单是否逐字一致；必填标记是否与表单必填设置一致；条件显示字段的触发条件是否与配置一致；每个字段是否都有示例；常见错误是否来自真实退回记录；说明中是否残留“尽量”“适当”等无法判断的词。评审人对照表单逐项打勾，发现不一致直接标注在对照表上。
说明与模板版本同步的维护机制
把填写说明纳入模板变更流程：模板字段调整时，变更单中增加“说明是否已同步”一项，未同步不关闭变更。说明文档标注版本号和生效日期，与模板版本对应。每次更新在文末记录变更点，例如“新增‘影响范围’条件字段说明”“调整‘问题描述’合格标准”。定期（如每季度）用近期退回工单反查说明是否仍有缺口。
当工单模板在 ONES Desk 中配置时，字段与表单的调整可以直接在平台上完成。ONES Desk 支持自定义工单属性与工单内容，适配不同收集场景，也支持快速配置表单并一键分享填写链接，让提报人在门户提单。模板字段发生调整后，维护人可对照平台中的表单配置同步修订说明，减少说明与表单脱节的情况；具体字段类型与条件显示配置方式以实际产品配置为准。
完整示例：一张分类工单的填写说明片段
以下片段以“账号权限申请”类型为例，示范字段组划分、必填与条件显示描述、示例值如何组合在一起。可直接参照此结构改写为其他工单类型。
示例片段
一、适用范围：本说明适用于“账号权限申请”工单，提报前请确认所需系统与权限项已明确。
二、公共字段组
提报人（必填）：填写申请人姓名与工号。示例：张三，A1023。常见错误：只写英文名，导致无法匹配组织架构。
所属部门（必填）：选择申请人当前所属部门。示例：财务部。常见错误：填写项目组名称而非组织架构中的部门。
三、类型专属字段组
申请系统（必填）：从下拉列表选择需要开通权限的系统名称。示例：合同管理系统。常见错误：选择相近名称的系统，导致权限开通到错误系统。
权限项（必填）：写明具体功能权限，按“模块—操作”格式填写，多项用分号分隔。示例：合同查看；合同导出。常见错误：只写“全部权限”，处理人无法判断最小授权范围。
权限期限（必填，仅当权限项包含“导出”时出现）：选择权限有效期限，选项为“30 天”“90 天”“长期”。示例：90 天。常见错误：导出类权限默认选“长期”，未说明业务需要。
四、条件显示字段汇总：权限期限——当权限项包含“导出”时出现，位于权限项下方；未包含导出权限时不显示，无需填写。
从示例迁移到其他类型的规律
迁移时保持三层不变：公共字段组照搬，只替换类型专属字段组；每个字段仍用四句式；条件显示字段仍写“触发条件—出现位置—不显示时的状态”。变化的是字段内容和合格标准：故障类侧重现象与影响范围，咨询类侧重问题背景与期望答复，数据查询类侧重查询口径与用途。示例值要换成该类型的真实业务值，常见错误优先取自该类型的历史退回记录。
上线前检查：填写说明是否可用的核对项
发布前按清单逐项核对，全部通过再上线。检查由评审人执行，编写人配合修订，形成“核对—修订—复核”的闭环。
| 核对项 | 核对方法 | 通过标准 |
|---|---|---|
| 字段覆盖完整性 | 打开表单，逐个字段在说明中查找对应条目 | 每个字段都有说明，无遗漏、无多余条目 |
| 必填与条件显示一致性 | 对照表单必填设置和条件显示配置逐项比对 | 标记一致，触发条件与配置一致，出现位置描述准确 |
| 表述可判断性 | 搜索“尽量”“适当”“清楚”“相关”等模糊词，逐处改写 | 每项要求都能用是/否判断是否达标 |
| 示例有效性 | 检查每个字段是否至少有一个合格示例 | 示例为真实业务值，能直接照填 |
| 试填验证 | 找 2–3 名未参与编写的提报人，只给说明不给口头指导，完成一次试填 | 试填无退回补充，或退回原因均可在说明中找到对应提示 |
| 修订闭环 | 汇总试填中的疑问和退回原因，逐条判断是说明问题还是模板问题 | 说明问题已修订，模板问题已记录并转交模板负责人 |
试填验证是判断说明是否可用的关键动作。试填人卡住的位置，往往就是说明缺失或表述模糊的位置；试填产生的退回原因，可以直接补充到对应字段的“常见错误”中。核对完成后记录检查日期与检查人，说明文档随模板一同发布，后续模板变更时按同一清单复核。
常见问题
填写说明和工单模板的字段顺序必须完全一致吗？
建议保持一致。说明按表单从上到下的顺序排列，提报人打开说明就能按顺序找到对应解释，减少来回跳转。字段名称也要逐字一致，不改写、不缩写。如果模板字段较多，可以在说明开头加一个字段目录，但正文顺序仍跟随表单。
条件显示字段在说明里写一次还是写两次？
推荐写两次：一次在所属字段组内，随字段顺序说明填写要求；一次在“条件显示字段汇总”中集中列出触发条件、出现位置和不显示时的状态。前者方便顺序阅读，后者方便提报人快速查阅。两处内容要保持一致，模板配置调整时同步修改。
填写说明由谁维护，模板改了怎么保证说明同步？
通常由模板负责人担任维护人。把填写说明纳入模板变更流程：字段增删改时，变更单中增加“说明是否已同步”一项，未同步不关闭变更。说明文档标注版本号和生效日期，与模板版本对应，文末记录变更点。定期用近期退回工单反查说明是否仍有缺口。
试填验证找哪些人做比较合适？
找 2–3 名未参与编写的提报人，只给说明、不给口头指导，让他们完成一次试填。试填人卡住的位置往往就是说明缺失或表述模糊的位置；试填产生的退回原因，可以直接补充到对应字段的“常见错误”中。试填后汇总疑问，逐条判断是说明问题还是模板问题，分别修订或转交。
在 ONES Desk 中配置工单模板时，填写说明怎么和表单对应？
ONES Desk 支持自定义工单属性与工单内容，适配不同收集场景，也支持快速配置表单并一键分享填写链接。模板字段调整后，维护人可对照平台中的表单配置同步修订说明，减少说明与表单脱节。具体字段类型与条件显示配置方式以实际产品配置为准。
