文档首页/ ISDP/ API参考/ API接口/ 数据分析/ 查询作业对象筛选的任务平均时长(API名称:queryJobTaskAverageTime)
更新时间:2024-07-22 GMT+08:00
分享

查询作业对象筛选的任务平均时长(API名称:queryJobTaskAverageTime)

功能介绍

按照任务类型、作业对象名称、作业对象编码、作业类型名称统计某一时间段内(已完成)的任务平均时长。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。

调用流程

图1 查询作业对象筛选的任务平均时长流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/dataOpen/queryJobTaskAverageTime

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

Authorization

bearer ${access_token}

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

taskType

Int

任务类型:

  • 1:父任务
  • 2:子任务
  • 3:工序

默认1

signSiteName

String

作业对象名称

signSiteCode

String

作业对象编码

signSiteType

String

作业对象类型

dateList

List<Object>

时间区间列表

说明:

最多传6组,超过6组只返回前6组。

startDate

String

开始时间,格式yyyy-MM-dd

endDate

String

结束时间,格式yyyy-MM-dd

响应参数

参数

类型

描述

stateCode

String

响应状态码:

  • 0-成功
  • 其他-失败

errorMessage

String

响应描述

result

Object

响应结果内容data、分页数据

result出参:

参数

类型

描述

pos

int

当前页,从0开始

total_count

int

总数量

data

List<Object>

响应结果内容data

data出参:

参数

类型

描述

startDate

String

起始时间

endDate

String

结束时间

taskCount

Int

总任务数量

taskTimeCount

Float

总工作时长(小时,保留一位小数)

∑(实际结束时间-实际开始时间)

taskAverageTime

Float

任务平均时长(小时,保留一位小数)

(总工作时长/总任务数量)

请求示例

{
    "taskType": 1,
    "signSiteName": "极I低端换流变8212B换流变B相",
    "dateList": [
        {
            "startDate": "2022-09-26",
            "endDate": "2022-10-02"
        },
        {
            "startDate": "2022-10-03",
            "endDate": "2022-10-09"
        },
        {
            "startDate": "2022-10-10",
            "endDate": "2022-10-16"
        }
    ]
}

响应示例

{
    "stateCode": "0",
    "errorMessage": "成功",
    "result": {
        "pos": 0,
        "totalCount": 3,
        "data": [
            {
                "startDate": "2022-09-26",
                "endDate": "2022-10-02",
                "taskCount": 0,
                "ifnull(taskTimeCount, '0.0')": "0.0",
                "taskAverageTime": "0.0"
            },
            {
                "startDate": "2022-10-03",
                "endDate": "2022-10-09",
                "taskCount": 1,
                "ifnull(taskTimeCount, '0.0')": "0.8",
                "taskAverageTime": "0.8"
            },
            {
                "startDate": "2022-10-10",
                "endDate": "2022-10-16",
                "taskCount": 1,
                "ifnull(taskTimeCount, '0.0')": "0.0",
                "taskAverageTime": "0.0"
            }
        ],
        "header": null
    }
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档