mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 02:15:57 +00:00
77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
---
|
||
id: system-setting.column-template.howto
|
||
title: 列模板（创建项目预置列）
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 列模板
|
||
- 项目模板
|
||
- 默认看板列
|
||
- 预置列
|
||
- 新建项目选模板
|
||
- 项目预设
|
||
- 看板模板
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限（普通用户只能 get 读取）
|
||
negative:
|
||
- 模板只控制「初始列」，不能预置任务卡、流程、负责人等其他内容
|
||
- 不支持按部门 / 项目分类区分模板
|
||
- 修改模板不会影响已创建项目，仅影响后续新建
|
||
- 保存时空 list 或 list 中没有合法条目会报「参数错误」/「参数为空」
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 列模板（创建项目预置列）
|
||
|
||
## 入口
|
||
桌面端：左上角头像 →「系统设置」→「列模板」。
|
||
对应后端：`POST api/system/column/template`，`type=get` 读取，`type=save` 写入（限 admin）。
|
||
|
||
## 是什么
|
||
创建新项目时，用户可以从一组预置「列模板」里挑一个直接套用，省去手动建列。模板就是「模板名 + 列名清单」。
|
||
|
||
例如内置一个「研发任务」模板：
|
||
- 列：待办、进行中、待测试、已完成
|
||
|
||
新建项目时勾选这个模板，项目就自动有这 4 列。
|
||
|
||
## 字段结构
|
||
保存时上传 `list` 数组：
|
||
|
||
```json
|
||
[
|
||
{
|
||
"name": "研发任务",
|
||
"columns": "待办,进行中,待测试,已完成"
|
||
},
|
||
{
|
||
"name": "市场活动",
|
||
"columns": "策划,执行中,复盘"
|
||
}
|
||
]
|
||
```
|
||
|
||
- **name** — 模板名（必填）
|
||
- **columns** — 逗号分隔的列名字符串，服务端会按 `,` 切分 → 去重 → 去空，落库为数组
|
||
|
||
任何缺 `name` 或 `columns` 的条目会被服务端跳过；最终为空数组直接报「参数为空」。
|
||
|
||
## 操作步骤
|
||
1. 进入「列模板」页
|
||
2. 「新增模板」→ 填写模板名
|
||
3. 在列输入框输入列名（多个用逗号分隔）
|
||
4. 重复添加多个模板
|
||
5. 点击「保存」立即生效
|
||
|
||
## 与项目创建的关系
|
||
用户「新建项目」对话框 →「选择模板」下拉就是这里维护的列表。选某个模板后，项目创建时按列名顺序生成空列，无任务卡。
|
||
|
||
## 不支持
|
||
- 不能模板化「任务流程」、「负责人」、「成员」、「自定义字段」
|
||
- 不能跨终端导出/导入模板
|
||
- 修改模板不会回溯到已创建的项目（仅对新项目生效）
|