云服务器内容精选

  • 响应示例 状态码: 200 OK { "total" : 1, "histories" : [ { "iteration_id" : 123454, "project_id" : "19274e1adffb4cc0b866ef6dd3ad0100", "operator" : { "user_id" : "0a938608ac00f2271f2ec01cccb94c19", "user_name" : "Banna", "nick_name" : "红海", "domain_id" : "9b33eb1d219140fea54d3b5ac689b073", "domain_name" : "devcloud_test" }, "operate" : "NEW", "operate_time" : "1665473746000", "details" : [ { "operate_field_name" : "name", "old_value" : null, "new_value" : "test" }, { "operate_field_name" : "description", "old_value" : null, "new_value" : null }, { "operate_field_name" : "end_time", "old_value" : null, "new_value" : "1664380800000" }, { "operate_field_name" : "status", "old_value" : null, "new_value" : "0" }, { "operate_field_name" : "begin_time", "old_value" : null, "new_value" : "1663776000000" }, { "operate_field_name" : "program_version_id", "old_value" : null, "new_value" : "-1" } ] } ] }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 histories Array of IterationHistory objects 历史记录 表5 IterationHistory 参数 参数类型 描述 iteration_id String 迭代ID project_id String 项目ID operator operator object 变更操作人 operate String 操作类型 operate_time String 操作时间 details Array of details objects 操作详情 表6 operator 参数 参数类型 描述 user_id String 用户uuid user_name String 用户名 nick_name String 昵称 domain_id String 租户uuid domain_name String 租户名 表7 details 参数 参数类型 描述 operate_field_name String 变更的字段 new_value String 操作后的值 old_value String 操作前的值 状态码: 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • URI GET /v4/iterations/{iteration_id}/histories 表1 路径参数 参数 是否必选 参数类型 描述 iteration_id 是 Integer 迭代id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 最小值:0 缺省值:0 limit 否 Integer 每页数量,最大为100 最小值:1 最大值:100 缺省值:10
  • 请求示例 Post https://{endpoint}/v4/projects/work-hours { "limit" : 1, "offset" : 0, "end_time" : "2020-08-14", "project_ids" : [ "e2da96a5d2c845e284f0ad47f8ca8cb2", "a2da96a5d2c845e284f0ad47f8ca8cef" ] }
  • 响应示例 状态码: 200 ok { "work_hours" : [ { "project_name" : "项目名称", "nick_name" : "用户昵称", "user_id" : "09d75cdd9a00d44d2f17c01875483f26", "user_name" : "用户名", "work_date" : "2020-02-19", "work_hours_num" : "2.0", "summary" : "做了XXXXX", "work_hours_type_name" : "后端开发", "issue_id" : 123456, "issue_type" : "Story", "subject" : "工作项标题", "created_time" : "2019-12-17", "closed_time" : "2019-12-20", "work_hours_created_time" : "2019-12-17 09:00:00", "work_hours_updated_time" : "2019-12-20 15:00:00" } ], "total" : 1 }
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:10 最大长度:32768 表2 请求Body参数 参数 是否必选 参数类型 描述 project_ids 否 Array of strings 查询的项目id列表 user_ids 否 Array of strings 查询的用户id列表 work_hours_types 否 String 工时类型,以逗号分隔,21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App),26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假 work_hours_dates 否 String 工时日期,以逗号分隔,年-月-日 begin_time 否 String 工时开始日期,年-月-日 end_time 否 String 工时结束日期,年-月-日 offset 是 Integer 偏移量,offset是limit的整数倍,limit=10,offset=0,10,20... 最小值:0 limit 是 Integer 每页显示数量,每页最多显示100条 最小值:1 最大值:100
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 work_hours Array of work_hours objects 工时列表 total Integer 总数 表4 work_hours 参数 参数类型 描述 project_name String 项目名称 nick_name String 用户昵称 user_id String 用户id user_name String 用户名 work_date String 工时日期 work_hours_num String 工时花费 summary String 工时内容 work_hours_type_name String 工时类型 issue_id Integer 工作项id issue_type String 工作项类型 subject String 工作项标题 created_time String 工作项创建时间 closed_time String 工作项结束时间 work_hours_created_time String 工时创建时间 work_hours_updated_time String 工时更新时间 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 新建子工作项 新建好的子工作项显示在“子工作项”页签中。 Task和Bug是最末层次,Task和Bug没有子工作项。 增加子工作项有两种方法: 操作方法一 进入工作项详情,切换到“子工作项”页签。 单击“快速新建子工作项”可以快速完成子工作项创建。适合于快速场景的创建。 单击“新建子工作项”,可以设置更多参数信息,适合于完整创建子工作项。 操作方法二 在工作项列表中,分为快速创建和完整创建: 单击工作项所在行,只需输入关键信息快速完成创建。 单击工作项所在行,创建完整信息的子工作项。
  • 关联工作项/代码提交记录/代码分支/用例/Wiki 项目为工作项提供了多种对象的管理:关联其他工作项、关联测试用例、关联代码提交记录、关联代码分支和关联Wiki词条。 进入工作项详情页面,选择“关联”页签。 完成关联操作。 关联工作项 展开关联工作项,单击“关联工作项”,在关联工作项页面可以勾选需要关联的工作项。 关联好的工作项显示“关联工作项”按钮下方。 关联测试用例 展开关联用例,单击“关联用例”,在关联测试页面可以勾选需要关联的用例。 关联好的测试用例显示“关联用例”按钮下方。 代码提交记录 展开代码提交记录,根据需要可以关联代码提交记录。 支持工作项关联代码提交记录。 在代码托管中提交附加工作项信息,关联分配的且非已关闭状态的工作项(与git命令行提交一样生效,详情见代码托管git命令中提交信息规范设置)。 插入工作项后,输入描述信息,单击“确定”。 关联成功后,在工作项详情中显示关联的提交信息。 关联代码分支 展开关联代码分支,显示已关联的代码分支。 工作项关联代码分支。 在代码托管中新建分支,同时关联工作项。 分支创建成功后,在工作项的关联页面可以查看工作项关联的分支信息。 关联Wiki:可以关联其他Wiki词条。
  • 使用仪表盘 仪表盘即项目过程中的可视化管理,支持基于数据的迭代回顾,包括:需求、缺陷、路标日历、进度、燃尽图、团队成员等,还支持自定义报表卡片。可以直观了解工作动态、迭代的质量、进度、工作量的情况,基于真实数据进行改进。 进入项目详情页面,选择“仪表盘”。 默认显示当前迭代(迭代1)的需求、缺陷、路标日历、进度、燃尽图和团队成员。 选择不同迭代了解各个迭代的统计数据,如工作执行情况、质量、工作量等。 单击右下角还可以添加自定义报表卡片,深入了解项目情况。 自定义卡片包括任务、工作完成度、个人工时、吞吐量、工作饱和度、项目Bug统计和项目Story统计,更多详细操作,请参见 仪表盘。