主题
产品参数模板：把产品结构一键铺成任务
更新日期：2026-08-28（基线 v1.229.0）
一、功能简介
如果你的产品树本身就是一份「要做哪些事」的清单（比如一台设备下挂着各个部件、一个户型下挂着各个房间），那每次开新项目都照着它手工建一遍任务，既慢又容易漏。
参数模板就是把这件事做成一次性配置：
- 选一个产品树根节点；
- 配好「它的子节点变成任务时，任务名/类型/执行人/工期这些字段各取什么值」——这份配置就是模板；
- 选一个目标项目，一键把这些子节点批量铺成任务。
配置存下来后可以反复用，下次开同类项目直接铺。
二、什么时候用它
- 产品结构稳定、每次开项目都要按同一套结构建一批任务；
- 想让任务名、执行人、工期直接从产品字段里取，而不是手敲；
- 铺完还希望系统按人自动排出先后时间。
三、开始之前（前置条件）
| 项 | 说明 |
|---|---|
| 功能权限 | 需要 product:param:template 功能权限，没有权限时产品顶栏不显示「参数模板」tab。 |
| 产品树里有内容 | 左侧树为空会显示「暂无产品」。 |
| 根节点要有子节点 | 选了没有子节点的节点会显示「该节点没有子节点」，也就无从铺设。 |
| 目标项目 | 铺设时要选一个已存在的项目。 |
四、操作步骤
进入路径：产品 → 顶栏「参数模板」tab。
页面分三块：左边产品树（选根节点）→ 中间子节点映射表（看配置结果）→ 底部选项目 + 批量铺设。
第 1 步 选根节点
在左侧树里点一个节点作为根节点。选中后中间表格会列出它的全部子节点，每行一个子节点，列是：
| 列 | 含义 |
|---|---|
| 节点名称 | 这个子节点叫什么 |
| 任务名映射 | 它变成任务后，任务名怎么来 |
| 类型 | 任务类型 |
| 模块 | 落到项目的哪个模块下 |
| 优先级 | 未设置时显示 — |
选错了点右上角「清除」重选。
第 2 步 配置字段映射
点中间上方的「配置字段映射」，打开映射弹窗。这里定义「产品字段 → 任务字段」的对应关系：
| 任务字段 | 说明 |
|---|---|
| 任务名称 | ⭐ 支持 装配-，铺出来就是「装配-左前门」这样 |
| 任务描述 | 同样可取产品字段 |
| 任务类型 | 从任务类型字典里选（走标准的 RWLX 字典） |
| 优先级 | —— |
| 计划开始 / 计划完成 | 留空则不设 |
| 工期(天) | —— |
| 计划工时(h) | —— |
| 执行人 | 可选具体人，也可留空（提示「无（手动输入）」）改到铺设时再填 |
| 验收人 / 验收模式 | —— |
⭐ 子节点没有单独配映射时，会继承根节点的配置。所以常规做法是：先在根节点上配一套通用的，只给个别特殊的子节点单独覆盖。
页面还提供一键的「已为所有未配置节点设置默认映射」，把还没配的行统一按默认铺一遍。
第 3 步 保存模板
⚠️ 这一步不能跳过。改动之后右上角会出现「保存模板」按钮，点它，提示「模板已保存」。
批量铺设前必须先保存模板拿到有效 ID，没保存直接去铺会失败。保存失败时会提示「保存失败：xxx」。
点「刷新」可以丢弃未保存的改动、重新读回已保存的版本。
第 4 步 选目标项目，批量铺设
页面底部：目标项目下拉里选项目（支持输入搜索）→ 点「批量铺设任务（N）」，N 就是子节点条数。没选项目时按钮是灰的，强行点会提示「请选择目标项目」。
弹出「批量铺设任务」窗口，里面是一张可编辑的预览表 —— 这是最后一次修改机会，每行列：
节点名称 / 任务名称 / 任务类型 / 模块 / 执行人 / 工期(天) / 计划开始 / 计划完成 / 操作（删除）。
批量工具（在表格上方）：
| 工具 | 作用 |
|---|---|
| 统一执行人 | 选一批人一次性铺到所有行，提示「已统一设置执行人（N 人）」 |
| 统一设置模块 / 类型 / 工期 / 开始时间 / 结束时间 | 一次改一列，提示「已统一设置 xxx」 |
| 自动排期 | 见下一步 |
| 删除 | 去掉不想铺的行 |
提交前的校验（不满足会直接拦下，先补齐再点确定）：
| 提示 | 什么意思 |
|---|---|
| 有 N 行任务名称为空，请填写 | 任务名必填 |
| 有 N 行缺少执行人或工期(天)，请先通过统一设置或行内编辑补全 | 两者都得有 |
| 有 N 行未配置执行人，请填写 | 同上 |
| 有 N 行未配置工期(天)，请填写 | 同上 |
点「确定」，提示「铺设完成」，任务就进目标项目了。
第 5 步（可选） 自动排期
点「自动排期」，系统按下面的规则把时间排出来：
- 以第一行有开始时间的那一行为基准往后排 —— 所以要先给至少一行填开始时间，否则提示「请先为至少一行设置计划开始时间」；
- 按执行人分组，同一个人的任务依次顺排（不重叠）；
- 跳过周末 —— 排到周末会顺延到下周一 08:00；
- 每天可用工时按 min(当天剩余, 8 小时) 估算。
完成提示「自动排期完成」。排完的时间仍然可以逐行手改。
五、常见问题与注意事项
- 看不到「参数模板」tab？ 你没有
product:param:template功能权限，找管理员在权限中心加。 - 点批量铺设报错？ 十有八九是模板没保存。先点「保存模板」再铺。
- 同一批任务能不能重复铺两次？ ⚠️ 后端的幂等/重复铺设行为尚未核实 —— 也就是说再铺一次会不会产生重复任务，目前没有确切结论。稳妥做法：铺完先去项目任务列表确认结果，别连点两次；真需要重铺，先把上一批删掉。
只能用在任务名上吗？ 任务名称字段的输入框上明确写着支持这个占位符；其它字段请按弹窗里的提示来。- 子节点很多、只想铺一部分？ 在铺设弹窗的预览表里把不要的行删掉再确定。
- 自动排期会考虑法定节假日吗？ 不会，只跳周末。遇到长假需要手工顺延。
- 和甘特图的「按执行人排期」是一回事吗？ 思路一样（同一人的任务依次顺排），但一个发生在铺设前的预览表里，一个发生在已建好的任务上。见《任务管理 - 甘特图》。
六、相关功能
- 产品字段本身怎么定义，见《产品管理 - 产品字段与配置》。
- 产品树怎么维护，见《产品管理 - 产品库》。
- 铺出来的任务怎么排期，见《任务管理 - 甘特图》。