提交更新驱动技能文档

This commit is contained in:
V-LiuShuang committed 2026-09-28 15:20:36 +08:00
1 parent 2d0f6f52d3
commit 0d02a78a85
3 files changed
+83 -43

No files matched your search

@@ -6,7 +6,6 @@
"testModelUuid": "46a7b0303a23df1ef6240b95b67d1b83",
"testModelVersionUuid": "07a7afe541314e8dba335681584369e3",
"parentTestModelNodeUuid": "0",
"testCaseSectionDescription": null,
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
@@ -18,25 +17,14 @@
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"comments": null,
"ownerCode": null,
"delayTime": "0",
"creatorCode": null,
"modifierCode": null,
"gmtCreate": "2021-09-29 00:00:00",
"gmtModified": null,
"topTestModelUuid": "46a7b0303a23df1ef6240b95b67d1b83",
"topTestModelVersionUuid": "07a7afe541314e8dba335681584369e3",
"documentVersionUuid": null,
"stage": null,
"documentVersionCode": null,
"documentName": "",
"children": [],
"recordNode": [],
"testModelLevelKey": 1,
"softwareToolParam": null,
"softwareToolParamExplain": null,
"parameterDescription": null,
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
@@ -47,14 +35,6 @@
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "Device Driver Installation Tool.",
"isShoot": null,
"isComments": null,
"debugObjectUuid": null,
"debugGuideUuid": null,
"debugAction": null,
"debugObjectType": null,
"debugActionType": null,
"modelRunType": null,
"testSoftwareToolName": "DriverInstallTool",
"testSoftwareToolUuid": "3bde357b79f00187736bc2480fbe9a3d",
"testSoftwareToolVersionNo": "1.0.0.0",
@@ -62,43 +42,32 @@
"configFileRequiredFlag": 0,
"documentCopyDTOList": [
{
"documentName": "mis-debugging.sql",
"fileExtensionKey": "0",
"documentName": "{fileName}",
"fileExtensionKey": "{fileExtensionKey}",
"documentVersionNo": "",
"documentVersionUuid": "",
"fileType": "sql",
"fileType": "{fileExtName}",
"controller": {},
"progressPercent": 100,
"fileUrl": "http://10.159.41.130:8080/mbvClient/downloadFile?objectName=20260923/16/06/27/mis-debugging.sql&bucketName=document",
"fileUuid": "5af265d8c9354aa185063fa9c60e4af3"
"fileUrl": "{fileUrl}",
"fileUuid": "{fileUuid}"
}
],
"forbiddenStatus": null,
"duplicateFlag": 0,
"functionTypeOne": null,
"functionTypeTwo": null,
"functionTypeThree": null,
"functionTypeFour": null,
"hasModify": null,
"testCaseAssociationVersionUuid": null,
"sort": null,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"testModelVersionVO": null,
"lastTestModelVersionUuid": null,
"testCaseType": null,
"id": "2550e21",
"id": "{id}",
"level": 0,
"isCheck": true,
"documentValue": "5af265d8c9354aa185063fa9c60e4af3",
"fileUrl": "http://10.159.41.130:8080/mbvClient/downloadFile?objectName=20260923/16/06/27/mis-debugging.sql&bucketName=document",
"documentValue": "{fileUuid}",
"fileUrl": "{fileUrl}",
"isConfig": false
}
]
},
"base": {
"functionTypeOne": 3,
"testTaskName": "DriverInstallTool_Driver2026923 ",
"testTaskName": "DriverInstallTool_Driver{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 237,
@@ -119,7 +88,7 @@
"testCaseName": []
},
"functionTypeOne": 3,
"testTaskName": "DriverInstallTool_Driver2026923 ",
"testTaskName": "DriverInstallTool_Driver{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 237,
@@ -141,8 +110,8 @@
"bindingRulePriority": 1,
"entityPrimaryKeyList": [
{
"key": "3015e27563524435a19963c42ad7455e",
"value": "500e Gen4s-EOP-SKU1-1"
"key": "{testUnitUuid}",
"value": "{testUnitName}"
}
]
},
@@ -19,5 +19,6 @@ JSON字符串中变量的格式示例:{id},根据取值规则查找并替换
|id|随机生成1个由小写字母、数字组成的7位长度字符串(示例:2b43cb39)|
|projectName|调用工具获得的项目名称|
|projectUuid|调用工具获得的项目ID|
|date|从**上下文变量**取今天的日期|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|
@@ -1 +1,71 @@
# 更新驱动文档
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/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|调用工具获得的测试机名称|