
# 查询任务/子任务执行阶段扩展属性（API名称：queryTaskExtendFields）
#### 功能介绍
查询任务/子任务执行阶段的扩展属性信息。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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。   |
   
#### 请求示例
```
"videoList":{"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"
    }
}
```
