From 0d02a78a85ab7e065c58b251adf6997414ce35dd Mon Sep 17 00:00:00 2001 From: V-LiuShuang Date: Mon, 28 Sep 2026 15:20:36 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E6=9B=B4=E6=96=B0=E9=A9=B1?= =?UTF-8?q?=E5=8A=A8=E6=8A=80=E8=83=BD=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../example/update_driver_request.json | 55 ++++----------- .../references/exec_task_stress_doc.md | 1 + .../references/exec_task_update_driver_doc.md | 70 +++++++++++++++++++ 3 files changed, 83 insertions(+), 43 deletions(-) diff --git a/se-task-exec-spec/example/update_driver_request.json b/se-task-exec-spec/example/update_driver_request.json index 4d96c62..94e8b8b 100644 --- a/se-task-exec-spec/example/update_driver_request.json +++ b/se-task-exec-spec/example/update_driver_request.json @@ -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}" } ] }, diff --git a/se-task-exec-spec/references/exec_task_stress_doc.md b/se-task-exec-spec/references/exec_task_stress_doc.md index 94c19ed..77b1a2c 100644 --- a/se-task-exec-spec/references/exec_task_stress_doc.md +++ b/se-task-exec-spec/references/exec_task_stress_doc.md @@ -19,5 +19,6 @@ JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换 |id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）| |projectName|调用工具获得的项目名称| |projectUuid|调用工具获得的项目ID| +|date|从**上下文变量**取今天的日期| |testUnitUuid|调用工具获得的测试机ID| |testUnitName|调用工具获得的测试机名称| \ No newline at end of file diff --git a/se-task-exec-spec/references/exec_task_update_driver_doc.md b/se-task-exec-spec/references/exec_task_update_driver_doc.md index bc2d87d..1fabf3f 100644 --- a/se-task-exec-spec/references/exec_task_update_driver_doc.md +++ b/se-task-exec-spec/references/exec_task_update_driver_doc.md @@ -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|调用工具获得的测试机名称| \ No newline at end of file