在看板项目中管理工作项

快速创建工作项

在“卡片”视图中，支持快速创建单个或多个工作项

• 快速创建单个工作项

  在卡片（默认）视图中，单击卡片下方的“新建工作项”按钮可以快速新建工作项。

• 快速创建多个工作项

  单击“新建工作项”后，在设置名称输入框中，可以设置完一个名称后进行换行（Shift键 + Enter键），多个名称设置多行。

  例如：设置了3个工作项名称，单击“新建3个工作项”可以一次完成多个工作项新建。

  按下Enter键则只会创建1个工作项。

操作成员需拥有工作项的“新建(复制)”权限。

批量创建工作项

在“列表”视图中，支持批量创建工作项。

1. 在看板卡片视图中单击“显示”进行切换到“列表”视图。
2. （可选）快速创建工作项。

   单击表头下第一行左侧“快速新建”可在行内快速创建工作项。

3. 批量创建工作项。

   单击表头下第一行左侧“批量创建”可批量创建工作项。

操作成员需拥有工作项的“新建(复制)”权限。

修改工作项

在“卡片”视图中，支持快速修改工作项，如工作项拖拽、列拖拽、工作项卡片编辑详情。

• 工作项拖拽
  说明：

  是否能拖拽，跟起始状态能否流转到目标状态有关，详情见状态配置中的状态配置工作项层级状态流转方向配置。当工作项不可拖拽到指定位置时，蓝色虚线框与“拖动到此处”提示不会出现。

  鼠标左键单击卡片不放，拖拽到其他列上，当显示蓝色虚线框与“拖动到此处”的文字提示时，松开鼠标左键即可将工作项移动到指定位置。

• 列拖拽

  标左键单击列名称附近位置不放，左右拖拽到其他位置上，当显示蓝色虚线框时，松开鼠标左键即可将列移动到指定位置（待启动状态列不能进行拖拽）。

• 编辑工作项详情

  工作项在“卡片”视图模式，可快速编辑处理人和结束日期信息。

操作成员需拥有工作项的“编辑”权限。

工作项视图管理

看板项目提供了“卡片”视图、“列表”视图和“树”视图三种视图模式，默认以“卡片”视图展示看板。请根据实际需要切换看板视图模式。

• 卡片视图

  卡片视图将状态以列的方式进行展示。单击，可以对状态进行管理。

  卡片视图将工作项以卡片的方式进行展示，支持工作项拖拽以及状态的设置等，卡片视图一共有四种缩放等级，每一个缩放等级会显示相应的工作项信息。

• 列表视图

  “显示方式”选择“列表”视图模式，工作项将以列表形式进行展示。

  在看板页面单击“显示”，选择“列表”，可以切换到“列表”视图方式。

• 树视图

  在“显示方式”下选择“树”，切换到“树”视图模式。将工作项以树结构形式进行展示，与列表视图类似，以父子结构展示。

项目下全体成员均可进行此操作。

表头功能

在列表视图中，可以根据需要做如下操作：

选择型字段支持过滤、字段支持排序。将鼠标移动至表头，则自动显示过滤和排序按钮。

支持“设置显示字段”以及“自动换行”，单击表头右侧按钮进入设置。

项目下全体成员均可进行此操作。

工作项分组

每个视图都可以将工作项进行分组显示，默认不分组，操作入口可在右上方单击“分组”进入。

• 卡片视图分组
  • “默认”：默认不进行分组。
  • “按处理人”：按照工作项的处理人进行分组显示，每一行为处理人相同的工作项，每一列为状态相同的工作项，单击图标继续新增工作项，工作项支持跨行和跨列进行拖放。
• 列表视图分组
  • “默认”：默认不进行分组。
  • “按列”：按列分组后，列表视图呈现各个状态的“行”，每一“行”展开后显示当前状态下的工作项。
  • “按处理人”：按处理人分组后，列表视图呈现各个成员的“行”，每一“行”展开后显示处理人为当前成员的工作项。
• 树视图分组
  • “默认”：默认不进行分组。
  • “按列”：按列分组后，呈现按照状态分类的树。
  • “按处理人”：按处理人分组后，呈现按照成员分类的树。

项目下全体成员均可进行此操作。

查询工作项

工作项支持过滤，过滤方式包括快捷键过滤、标题或编号快捷过滤、系统默认过滤器过滤和个人过滤。

• 快捷键过滤：按Q进行快速过滤“处理人”为自己的工作项、按S进行快速输入标题或编号进行过滤、按X进行清除过滤条件。
• 标题或编号快速过滤
  • 视图左上方“搜索框”，输入框可输入标题或编号进行快速过滤。
  • 视图右上方“过滤”，滑窗上方输入框可输入标题或编号进行快速过滤。
• 系统默认过滤器过滤：单击“过滤”后，选择默认过滤条件过滤：
  图2 系统默认过滤器
  
• 个人过滤器过滤：可供当前用户长期使用。
  创建个人过滤器

  1. 单击视图右上方“过滤”后，单击个人过滤器处的“创建”，显示“创建过滤器”。
  2. 设置过滤器参数并保存过滤器，即个人过滤器。
  临时过滤

  1. 在过滤器页面可单击“临时过滤”进行临时过滤，不会进行过滤信息存储。

项目下全体成员均可进行此操作。

导入工作项

支持根据模板文件“批量导入新建”或“批量导入更新”工作项。界面“导入前准备”和“文件导入”事项务必仔细阅读。

在“工作项”页面，单击“更多 > 工作项导入”进入工作项导入页面。“批量导入新建”和“批量导入更新”两种导入方式操作相同。

• 批量导入新建

  单击“下载导入模板”，填入信息后，添加文件单击“下一步”，完成校验后单击“确定导入”即可。

• 批量导入更新

  单击“下载导入模板”，填入信息（信息中“编号”需要填写工作项的ID，ID可以通过导出工作项获取）后，添加文件单击“下一步”，完成校验后单击“确定导入”即可。

操作成员需拥有工作项的“导入”权限。

导出工作项

支持设置不同字段条件，将工作项导出到本地。

在“工作项”页面，单击“更多 > 工作项导出”，在“设置导出字段”窗口选择要导出的字段即可进行导出。

操作成员需拥有工作项的“导出”权限。

查看已归档工作项

项目的管理员可以根据实际任务开发情况（即，工作项任务已关闭），对工作项进行归档。归档后的工作项，所有成员对工作项为只读，不能对工作项进行增删改操作。

项目下全体成员均可进行此操作。

编辑工作项

1. 在工作项详情页中单击需要修改的字段取值框，在输入框中输入目标值或在下拉框中选择目标值。
2. 单击右上角“保存”，可将修改内容进行保存。

操作成员需拥有工作项的“编辑”权限。

添加评论

1. 进入工作项详情页面。
2. 在“详情”页签，单击“评论”输入框。
   图4 添加评论
   
3. 输入评论内容。
4. 单击“保存”，评论成功。

   发表后的评论支持编辑、删除操作。

项目下全部成员均可以进行此操作。

添加附件

支持工作项关联附件，包括文档管理中已有文档和本地上传文档。附件总容量不得超过50MB。

• 本地上传

  单击“本地上传”，可直接上传本地文件进行关联。

• 关联文件
  1. 单击“关联文件”。
  2. 选择“文档”中已存在的文件，选择目标文件即可关联。

操作成员需拥有工作项的“上传文件”权限。

添加并查看关联项

工作项可以与项目内的其它类型工作项建立关联关系。

1. 进入工作项详情页面，选择“关联项”页签。
2. 完成关联操作。
   • 关联工作项：与本项目中其他类型的工作项，直接建立关联关系。
   • Wiki：工作项对应的Wiki。

     选择与工作项相关联的Wiki，支持新建Wiki。

   • 关联用例：支持工作项关联用例。
     说明：

     只支持“需求”或“缺陷”类型的工作项关联用例。

     进入工作项详情页面，选择“关联项 > 关联用例”，单击“关联用例”，弹出用例选择弹窗，选择用例进行关联。

   • 关联代码分支：支持工作项关联代码分支。
     1. 在代码托管中新建分支，同时关联工作项。

     图5 在代码托管中新建分支
     

     2. 分支创建成功后，可在工作项页面查看工作项关联的分支信息。

   • 关联代码提交记录：支持工作项关联代码提交记录。
     1. 在代码托管中提交附加工作项信息，关联认领的且非已完成、已结束状态的工作项（与git命令行提交一样生效，详情见代码托管git命令中提交信息规范设置）。

     图6 在代码托管中提交附加工作项信息
     

     2. 插入工作项后，输入描述信息，单击“确定”。

     3. 关联成功后，在工作项详情中显示关联的提交信息。

     图7 代码提交记录
     

操作成员需拥有工作项的“编辑”权限。

添加详细工时

支持对工作项设置详细工时，方便项目的管理员掌握工作项开发情况。

1. 进入工作项详情页面，选择“详细工时”页签，单击“填写工时”，设置详细工时。
   图8 填写工时弹框
   
2. 单击“确定”完成工时添加。
   添加后可进行编辑或删除。

   图9 详细工时页签
   

   说明：

   详细工时会同时生效于字段“实际工时”。实际工时大小为所有子工作项工时大小总和或当前工作项工时（无子工作项时）。

操作成员需拥有工作项的“编辑”权限。

查看操作历史

支持查看工作项的操作历史，方便项目的管理员对工作项的编辑进行跟踪。进入工作项详情页面，选择“操作历史”页签，可以查看各操作的操作人、操作内容和操作时间。

1. 进入工作项详情页面。
2. 选择“操作历史”页签，查看工作项所有的修改操作。

项目下全部成员均可以进行此操作。

给工作项打标签

操作成员需拥有工作项的“编辑”权限。