- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 需求管理(CodeArts Req)使用流程
- 购买并授权使用CodeArts Req
- 访问CodeArts Req服务首页
- 管理项目群
- 创建CodeArts项目
- 管理Scrum类型项目需求
- 管理IPD系统设备类型项目需求
- 管理IPD独立软件类型项目需求
- 管理IPD自运营/云服务类型项目需求
- 管理看板类型项目需求
- 查看审计日志（可选）
- 知识库用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
-
API
- 用户信息
- 项目成员
- 项目信息
- 项目指标
- 项目统计
- Scrum项目的迭代
-
Scrum项目的工作项
- 创建工作项类型自定义字段
- 上传图片
- 获取工作项完成率
- 获取指定工作项的评论列表
- 按用户查询工时（单项目）
- 按用户查询工时（多项目）
- 添加指定工作项工时
- 查询项目下的工时类型
- 获取工作项历史记录
- 创建工作项
- 查询项目的工作项
- 高级查询工作项
- 批量删除工作项
- 查询工作项详情
- 更新工作项
- 删除工作项
- 获取子工作项
- 查询项目下所有工作项的历史记录
- 查询Scrum项目的工作项流转配置
- 细粒度权限用户创建工作项
- 查询当前工作项已经关联的工作项
- 查询当前工作项已经关联的关联Wiki
- 查询当前工作项已经关联的代码提交记录 / 分支创建记录
- 查询关联用例
- 查询Scrum工作项自定义字段
- 下载图片
- 上传工作项附件
- 下载工作项附件
- 删除附件
- 查询迭代下工作项状态的统计数据（处理人维度）
- 获取指定工作项停留时间
- 高级查询我的待办工作项
- Scrum项目的模块
- Scrum项目的领域
- Scrum项目的状态
- 看板项目的工作项
- IPD项目计划管理
- IPD工作项管理
- IPD统计概览
- IPD模块管理
- IPD配置管理
- IPD评审单管理
- IPD标签管理
- OpenAPI管理
- 应用示例
- 附录
- 文档修订记录
- 场景代码示例
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
创建工时
功能介绍
创建工时
调用方法
请参见如何调用API。
URI
POST /v1/ipdprojectservice/projects/{project_id}/work-items/{workitem_id}/work-hour
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制： 正则表达式，[A-Za-z0-9]{32} 取值范围： 不涉及 默认取值： 不涉及 |
|
workitem_id |
是 |
String |
工作项id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
work_hour_category |
否 |
String |
工时类型唯一标识取值为value，页面展示取值为display_value |
|
work_date_begin |
是 |
String |
工时开始日期 |
|
work_date_end |
是 |
String |
工时结束日期 |
|
work_hours |
是 |
String |
工时数值 |
|
work_hour_type |
是 |
String |
工时类型：1：总数 2：每天 |
|
include_weekend |
是 |
Boolean |
是否包含周末 |
|
description |
否 |
String |
描述 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
状态 |
|
message |
String |
消息 |
|
result |
WorkHourTotalVO object |
工时信息及工时总数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
Array of WorkHourVO objects |
工时信息列表 |
|
work_hours_total |
String |
实际工时总数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
工时id |
|
title |
String |
工时名称 |
|
operation_id |
String |
操作ID |
|
description |
String |
描述 |
|
workitem_id |
String |
工作项id |
|
work_date |
String |
工时日期 |
|
created_by |
UserEntity object |
创建人信息 |
|
modified_by |
UserEntity object |
修改人信息 |
|
work_hour_category |
String |
工时类型唯一标识取值为value，页面展示取值为display_value |
|
work_hours |
String |
花费工时(人天) |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释： 用户id，可通过[获取当前用户信息]接口获取，响应消息体中的id字段的值就是用户id。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
name |
String |
参数解释： 用户名称。 约束限制： 最小长度：2，最大长度：64。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
nick_name |
String |
参数解释： 用户昵称。 约束限制： 最小长度：2，最大长度：30。 取值范围： 不涉及。 默认取值： 不涉及。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
请求示例
创建总数为100，开始时间从2024/02/01至2024/02/06，工时类型为研发设计，包含周末的工时数据
POST https://{endpoint}/v1/ipdprojectservice/projects/05c7d8bcf3db4829bc841e4ba93aaea5/work-items/976857692367659008/work-hour?_=1708329665577
{
"work_hour_category" : "研发设计",
"work_date_begin" : "2024/02/01",
"work_date_end" : "2024/02/02",
"work_hours" : "12",
"work_hour_type" : 1,
"include_weekend" : true,
"description" : "工作内容工作内容工作内容"
}响应示例
状态码：200
创建工时返回体
{
"status" : "success",
"message" : null,
"result" : {
"data" : [ {
"work_date" : "1745337600000",
"modified_by" : "testuser",
"work_hour_category" : {
"id" : "1",
"display_value" : "后端开发",
"value" : "后端开发",
"value_py" : "hdkf",
"sequence" : 2,
"level" : 1,
"domain_id" : "1",
"created_by" : "testuser",
"created_date" : 1744750470000,
"modified_by" : "testuser",
"modified_date" : 1744750470000,
"belong_definition_type" : "5"
},
"description" : null,
"operation_id" : "1",
"id" : "1",
"work_hours" : 0.5,
"title" : null,
"created_by" : "testuser"
} ],
"work_hours_total" : 1
}
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
创建工时返回体 |
|
400 |
失败返回体 |
错误码
请参见错误码。
