POST /rest/shdsd-Timesheet/3/worklog/search

接口说明

按条件查询工作日志数据。

媒体类型

  • application/json

请求样例

{
  "issueId": 10338,
  "startDate":"2024-07-08", 
  "endDate":"2024-07-08", 
  "userKey": "JIRAUSER10000,JIRAUSER10001",
  "projectId": 10032,
  "runAs": "bruce", 
  "startAt": 0,
  "maxResults": 10
}

请求BODY详情

参数

类型

描述

必填

默认值

startDateString工作日志的开始时间 yyyy-MM-dd必填
endDateString工作日志的结束时间 yyyy-MM-dd非必填<留空时与startDate相同>
issueIdNumber

工作日志的问题 ID，多个issueId以逗号分隔

非必填
issueKeyString工作日志的问题 Key，多个issueKey以逗号分隔非必填
userKeyString工作日志的用户 Key，多个用户以逗号分隔非必填
userNameString工作日志的用户名，多个用户以逗号分隔非必填
projectIdNumber工作日志的项目 ID非必填
projectKeyString工作日志的项目 Key非必填
runAsString单个用户名，以该用户的权限执行这次工时查询。留空时返回内容不受权限限制非必填
startAtNumber返回列表的数据开始位置非必填0
maxResultsNumber返回列表的最大记录数非必填10

返回示例

{
    "total": 2,    -- 工时数据总数
    "isLast": true,    -- 当前返回结果是否是分页的最后一页 
    "startAt": 0,    -- 返回列表的数据开始位置
    "maxResults": 10,    -- 返回列表的最大记录数 
    "values": [
        {
            "overTimeStr": "0h",    -- 加班时间
            "timeWorkedStr": "1h 30m", -- 记录时长
            "issueId": 10013,   -- Isuue ID
            "author": { -- 所属人相关信息
                "userKey": "admin",
                "avatar": "http://localhost:2990/jira/secure/useravatar?size=xsmall&avatarId=10346",
                "userName": "admin",
                "displayName": "admin",
                "emailAddress": "admin@admin.com",
                "isActive": true,
                "isDel": false
            },
            "overTime": null,   -- 加班时间（秒）
            "timeWorked": 5400,   -- 记录工时时长（秒）
            "memo": "13123",    -- 工时备注
            "projectKey": "TEST",   -- 项目key
            "createTime": "2024-06-27 18:08:28.435",    --工时创建时间
			"startDate":"2024-06-27",   --日志时间
            "auditTime": null,  -- 审核时间
            "approve": {    -- 审核人信息
                "userKey": "admin",
                "avatar": "http://localhost:2990/jira/secure/useravatar?size=xsmall&avatarId=10346",
                "userName": "admin",
                "displayName": "admin",
                "emailAddress": "admin@admin.com",
                "isActive": true,
                "isDel": false
            },
            "workLogTypeName": "需求设计",  -- 日志类型
            "workLogType": "10005", -- 日志类型id
            "create": { -- 创建人信息
                "userKey": "admin",
                "avatar": "http://localhost:2990/jira/secure/useravatar?size=xsmall&avatarId=10346",
                "userName": "admin",
                "displayName": "admin",
                "emailAddress": "admin@admin.com",
                "isActive": true,
                "isDel": false
            },
            "id": 10304,
            "projectId": 10000, -- 项目Id
            "unitSample": "h",  -- 工时单位
            "status": 0,    -- 日志状态
            "isAppendLog": false    -- 是否为补录日志记录
        }
    ]
}
  • 无标签