云服务器内容精选

  • 新建子工作项 新建好的子工作项显示在“子工作项”页签中。 Task和Bug是最末层次,Task和Bug没有子工作项。 增加子工作项有两种方法: 操作方法一 进入工作项详情,切换到“子工作项”页签。 单击“快速新建子工作项”可以快速完成子工作项创建。适合于快速场景的创建。 单击“新建子工作项”,可以设置更多参数信息,适合于完整创建子工作项。 操作方法二 在工作项列表中,分为快速创建和完整创建: 单击工作项所在行,只需输入关键信息快速完成创建。 单击工作项所在行,创建完整信息的子工作项。
  • 关联工作项/代码提交记录/代码分支/用例/Wiki 项目为工作项提供了多种对象的管理:关联其他工作项、关联测试用例、关联代码提交记录、关联代码分支和关联Wiki词条。 进入工作项详情页面,选择“关联”页签。 完成关联操作。 关联工作项 展开关联工作项,单击“关联工作项”,在关联工作项页面可以勾选需要关联的工作项。 关联好的工作项显示“关联工作项”按钮下方。 关联测试用例 展开关联用例,单击“关联用例”,在关联测试页面可以勾选需要关联的用例。 关联好的测试用例显示“关联用例”按钮下方。 代码提交记录 展开代码提交记录,根据需要可以关联代码提交记录。 支持工作项关联代码提交记录。 在代码托管中提交附加工作项信息,关联分配的且非已关闭状态的工作项(与git命令行提交一样生效,详情见代码托管git命令中提交信息规范设置)。 插入工作项后,输入描述信息,单击“确定”。 关联成功后,在工作项详情中显示关联的提交信息。 关联代码分支 展开关联代码分支,显示已关联的代码分支。 工作项关联代码分支。 在代码托管中新建分支,同时关联工作项。 分支创建成功后,在工作项的关联页面可以查看工作项关联的分支信息。 关联Wiki:可以关联其他Wiki词条。
  • 使用仪表盘 仪表盘即项目过程中的可视化管理,支持基于数据的迭代回顾,包括:需求、缺陷、路标日历、进度、燃尽图、团队成员等,还支持自定义报表卡片。可以直观了解工作动态、迭代的质量、进度、工作量的情况,基于真实数据进行改进。 进入项目详情页面,选择“仪表盘”。 默认显示当前迭代(迭代1)的需求、缺陷、路标日历、进度、燃尽图和团队成员。 选择不同迭代了解各个迭代的统计数据,如工作执行情况、质量、工作量等。 单击右下角还可以添加自定义报表卡片,深入了解项目情况。 自定义卡片包括任务、工作完成度、个人工时、吞吐量、工作饱和度、项目Bug统计和项目Story统计,更多详细操作,请参见 仪表盘。
  • 响应示例 状态码: 200 OK { "issue_list" : [ { "id" : 7220820, "subject" : "aaa", "project" : { "name" : "Scrum-ljx-0320", "id" : 30387805, "identifier" : "", "type" : "scrum" }, "done_ratio" : 0, "expected_work_hours" : 0.0, "actual_work_hours" : 0.0, "tracker" : { "id" : 7, "name" : "Story" }, "order" : { "id" : 1, "name" : "1.0" }, "severity" : { "id" : 12, "name" : "一般" }, "priority" : { "id" : 2, "name" : "中" }, "domain" : { }, "position" : 7220820.0, "module" : { }, "assigned_to" : { "id" : 4091, "name" : "" }, "author" : { "id" : 4091, "name" : "" }, "developer" : { }, "closeder" : { }, "status" : { "id" : 1, "name" : "新建" }, "is_watcher" : false, "closed_flag" : 0, "deleted" : false, "created_on" : "1681783846000", "updated_on" : "1681783846000", "due_date" : "1684252800000" } ], "total" : 1 }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 issue_list Array of issue_list objects 工作项信息列表 total Integer 工作项总数 表4 issue_list 参数 参数类型 描述 id Integer 工作项id subject String 工作项标题 parent_issue_id Integer 父工作项id parent_issue parent_issue object 父工作项信息 project project object 项目信息 release_dev String 发布版本 find_release_dev String 发现发布版本 done_ratio Integer 工作项完成度 expected_work_hours Double 预计工时 actual_work_hours Double 实际工时 tracker tracker object 工作项类型信息 order order object 优先级顺序信息 severity severity object 重要程度信息 priority priority object 工作项优先级信息 domain domain object 领域信息 position Double 排序数值 module module object 模块信息 assigned_to SimpleUserIn object author SimpleUserIn object developer SimpleUserIn object closeder SimpleUserIn object status status object 工作项状态信息 deleted Boolean 是否删除工作项 is_watcher Boolean 是否关注工作项 closed_flag Integer 关闭标志 created_on String 工作项新建时间戳 updated_on String 工作项更新时间戳 due_date String 工作项预计结束时间戳 表5 parent_issue 参数 参数类型 描述 id Integer 父工作项id subject String 父工作项标题 表6 project 参数 参数类型 描述 id Integer 项目id identifier String 项目uuid name String 项目名称 type String 项目类型 表7 tracker 参数 参数类型 描述 id Integer 工作项类型id name String 工作项类型名称 表8 order 参数 参数类型 描述 id Integer 优先级顺序id name String 优先级顺序名称 表9 severity 参数 参数类型 描述 id Integer 重要程度id name String 重要程度名称 表10 priority 参数 参数类型 描述 id Integer 工作项优先级id name String 工作项优先级名称 表11 domain 参数 参数类型 描述 id Integer 领域id name String 领域名称 表12 module 参数 参数类型 描述 id Integer 模块id name String 模块名称 path_name String 模块路径名称 表13 SimpleUserIn 参数 参数类型 描述 id Integer 用户id identifier String 用户uuid name String 用户名称 表14 status 参数 参数类型 描述 id Integer 工作项状态id name String 工作项优先级名称 状态码: 400 表15 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表16 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表2 请求Body参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量,offset是limit的整数倍,limit=10,offset=0,10,20... limit 否 Integer 每页显示数量 最小值:1 最大值:100 subject 否 String 搜索关键词 created_on 否 String 工作项创建时间区间 updated_on 否 String 工作项更新时间区间 closed_on 否 String 工作项结束时间区间 start_date 否 String 工作项预计开始日期区间 due_date 否 String 工作项预计结束日期区间 tracker_id 否 String 工作项类型 status_id 否 String 工作项状态 author_id 否 String 工作项创建人id developer_id 否 String 工作项开发人员id priority_id 否 String 工作项优先级id
  • 响应示例 状态码: 200 OK { "description" : "module demo", "module_name" : "demo", "module_id" : 46691, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "模块demo" }}
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 description String 模块描述 module_name String 模块名称 module_id Integer 模块id owner ModuleOwner object 表6 ModuleOwner 参数 参数类型 描述 user_id String 用户32位字符串id user_num_id Integer 用户数字id user_name String 用户名称 nick_name String 用户昵称 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 请求示例 Post https://{endpoint}/v4/projects/0792b7d26cb74bd799cbae80063dc74a/modules{ "description" : "module demo", "module_name" : "demo", "parent_module_id" : 1, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2" }}
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 模块描述 module_name 是 String 模块名称 parent_module_id 否 Integer 父模块id owner 是 UserRequest object 表4 UserRequest 参数 是否必选 参数类型 描述 user_id 是 String 用户32位字符串id
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 字段名称 type 是 String 自定义字段类型 可选类型 textArea|select|radio|text|checkbox|date|time_date|number options 是 String 字段选项 memo 是 String 描述 scrum_type 是 String 工作项类型
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 options String 字段选项 region String 系统字段 id Integer 字段ID identifier String 字段ID project_id Integer 项目ID tracker_id Integer 工作项类型id 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story custom_field String 系统字段名 type String 字段类型 name String 字段名称 sort Integer 系统字段 memo String 字段描述 created String 创建时间 modified String 修改时间 is_delete Boolean 是否被删除 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 请求示例 Post https://{endpoint}/v3/0792b7d26cb74bd799cbae80063dc74a/custom-fields{ "name" : "test", "type" : "text", "memo" : "描述", "options" : "0792b7d26cb74bd799cbae80063dc74a", "scrum_type" : "Story"}
  • 响应示例 状态码: 200 OK { "options" : "select1,select2", "region" : "southchina", "id" : 1, "identifier" : "81abca040032407bb62d52536d69ce2d", "project_id" : 2282492, "tracker_id" : 3, "custom_field" : "custom_field34", "type" : "select", "name" : "test", "sort" : 1, "memo" : "description", "created" : "2020-06-02T10:45:09Z", "modified" : 1, "is_delete" : false}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 domain_name String 领域名称 domain_id String 领域id 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码