查询任务/子任务执行阶段扩展属性(API名称:queryTaskExtendFields)
功能介绍
查询任务/子任务执行阶段的扩展属性信息。
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/openSceneTask/queryTaskExtendFields | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| sceneTaskId | Long | 是 | 父任务ID。 |
| subTaskIdList | Object | 否 | 子任务ID集合。 |
subTaskList中Object对象字段说明:
| 参数 | 类型 | 描述 |
|---|---|---|
| sceneTaskId | Long | 子任务ID。 |
| taskName | String | 子任务名称。 |
| actualBeginTime | Long | 子任务实际开始时间。 |
| actualEndTime | Long | 子任务实际完成时间。 |
| signSiteId | Long | 子任务作业对象ID。 |
| signSiteCode | String | 子任务作业对象编码。 |
| signSiteName | String | 子任务作业对象名称。 |
| taskExtend | List | 任务/子任务扩展属性。 |
| sceneModeCode | String | 任务场景子任务关联标识。 |
taskExtend字段说明:
| 参数 | 类型 | 描述 |
|---|---|---|
| sceneTaskId | Long | 任务/子任务id。 |
| extendName | String | 子任务扩展属性名称。 |
| stage | Integer | 子任务扩展属性所属阶段1:创建;2:执行。 |
| unitName | String | 单位。 |
| maxValue | String | 最大值(示例:“99”表示最大值允许为99)。 |
| minValue | String | 最小值(示例:“1”表示最小值允许为1)。 |
| precision | String | 精度(示例:“2”表示小数点后保留几位有效数据)。 |
| fieldOrder | Integer | 子任务扩展属性顺序。 |
| extendValue | String | 扩展属性值。 |
| udfName | String | 扩展属性编码。 |
| extendType | Integer | 扩展属性类型(1:长文本;2:枚举;3:多枚举;4:日期;5:时间;6:整数;7:小数;20:短文本)。 |
| isNecessary | Integer | 扩展属性是否必填(1:必填;2:不必填)。 |
备注:最大值maxValue、最小值minValue、精度precision是只有在extendType是6/7(整数或小数类型)中使用。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| stateCode | String | 响应状态码:0-成功;其他-失败。 |
| errorMessage | String | 响应描述,错误提示。 |
| result | Object | 响应数据,任务、子任务执行阶段的扩展属性信息。 |
result字段说明:
| 参数 | 类型 | 描述 |
|---|---|---|
| sceneTaskId | Long | 任务ID。 |
| taskName | String | 任务名称。 |
| signSiteId | Long | 任务作业对象ID。 |
| signSiteCode | String | 任务作业对象编码。 |
| signSiteName | String | 任务作业对象名称。 |
| taskExtend | List | 任务扩展属性。 |
| adminOrganizationName | String | 组织单元名称。 |
| adminOrganization | String | 组织单元ID。 |
请求示例
{"sceneTaskId":5064801, "subTaskIdList":[5010371]} 响应示例
{
"stateCode": "0",
"errorMessage": null,
"result": {
"subTaskList": [
{
"sceneTaskId": 5010371,
"taskName": "1_20230202_114945",
"taskId": 5064801,
"signSiteId": null,
"signSiteCode": "",
"signSiteName": "",
"sceneModeCode": "5000995",
"actualBeginTime": 1675310951240,
"actualEndTime": null,
"taskExtend": [
{
"sceneTaskId": 5010371,
"minValue": "1",
"extendName": "子任务测试属性4",
"stage": "2",
"unitName": null,
"maxValue": "50",
"precision": null,
"extendValue": null,
"fieldOrder": "13",
"udfName": "UDF13",
"extendType": "7",
"isNecessary": "2"
},
{
"sceneTaskId": 5010371,
"minValue": "1",
"extendName": "子任务测试属性4",
"stage": "2",
"unitName": null,
"maxValue": "50",
"precision": null,
"extendValue": null,
"fieldOrder": "13",
"udfName": "UDF13",
"extendType": "7",
"isNecessary": "2"
}
]
}
],
"sceneTaskId": 5064801,
"signSiteCode": null,
"adminOrganizationName": "1508098844233300",
"sceneId": 5001917,
"taskExtend": [],
"signSiteName": null,
"taskName": "测试父子任务执行扩展属性_20230202_114945",
"adminOrganization": "1543"
}
}