# 更新驱动文档

按照步骤一步一步的执行：

1. 阅读[查项目信息文档](./query_project_info_doc.md)，一步一步地获取`projectName`和`projectUuid`。

2. 根据上一步获取到的`projectUuid`，调用`queryDriverListNamesByProject`工具查询项目下的驱动列表。

成功示例：

```json
[
  {
    "driverListVersionUuid": "string",
    "driverListName": "string"
  }
]
```

- 参数`driverListVersionUuid`是驱动的版本号ID。
- 参数`driverListName`是驱动名称。

使用markdown表格输出给用户，让用户选择驱动，示例格式：

| 序号 | 驱动名称 | 版本号ID |
| --- | --- | --- |
| 1 | BIOS | 1234567890 |
| 2 | CPU | 456678098 |

失败示例：

```json
[]
```

代表没有数据，告知用户未查询到驱动列表，流程终止。

3. 根据用户选择的`driverListVersionUuid`，调用`queryDriverListVersion`查询驱动下载地址，记住返回值里面的`internalVersion`和`packageFileUrl`参数。如果没有获取到数据，告诉用户获取驱动下载地址失败，流程终止。

4. 用上一步获取到的`packageFileUrl`填充`prepareTaskFile`工具的`fileUrl`参数发起调用。**该工具是一个文件上传的工具，可能耗时较长**。

成功示例：

```json
{
  "fileUuid": "8f2a1c9e4b7d4a1f9c3e5b6a7d8e9f01",
  "fileUrl": "http://10.159.41.130:8080/mbvClient/downloadFile?objectName=document/20260922/xxx.zip&bucketName=document",
  "fileName": "xxx.zip",
  "fileExtensionKey": 3
}
```

5. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。

6. 使用[请求模板文件](../example/task_update_driver_request.json)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。

7. 阅读[下发任务文档](./create_task_doc.md)，上一步生成的JSON字符串就是`requestBodyJson`参数。

## 变量表

JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。

|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）|
|date|从**上下文变量**取今天的日期|
|fileName|调用`prepareTaskFile`工具返回的`fileName`|
|fileExtName|使用`fileName`的文件扩展名，例如："txt"|
|fileExtensionKey|调用`prepareTaskFile`工具返回的`fileExtensionKey`|
|fileUrl|调用`prepareTaskFile`工具返回的`fileUrl`|
|fileUuid|调用`prepareTaskFile`工具返回的`fileUuid`|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|