diff --git a/se-task-exec-spec/SKILL.md b/se-task-exec-spec/SKILL.md deleted file mode 100644 index ba4cd1d..0000000 --- a/se-task-exec-spec/SKILL.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -name: se-task-exec-spec -description: 该技能仅用于下发测试任务，比如执行Stress测试、Driver更新、Preload测试时使用。 ---- - -# se-task-exec-spec - -请先记住**上下文变量**，出现在``里的每一个标签，示例： - -```xml - - -我的用户名 -zhangsan - - -我的用户ID -123456 - - -今天的日期 -2026-09-25 - - -我的工号 -ABC000 - - -我的邮箱 -zhangsan@lcfuturecenter.com - - -``` - -变量名就是标签名，例如``，变量的含义在``中阐释，变量的数值位于``标签。 -在[能力索引](#能力索引)的文档里一般会通过以下表述**读取变量**："上下文变量中我的用户名"、"上下文变量中今天的日期"。 - -## 能力索引 - -- [Stress测试](./references/exec_task_stress_doc.md) -- [Driver更新](./references/exec_task_update_driver_doc.md) -- [Preload测试](./references/exec_task_preload_doc.md) \ No newline at end of file diff --git a/se-task-exec-spec/example/task_preload_request.json b/se-task-exec-spec/example/task_preload_request.json deleted file mode 100644 index b638dbd..0000000 --- a/se-task-exec-spec/example/task_preload_request.json +++ /dev/null @@ -1,86 +0,0 @@ -{ - "model":{ - "children":[ - { - "testModelNodeUuid":"d9ebb007dfb9b9c43645811a76d669a1", - "testModelUuid":"efa4eb0d153492ab162c4066f4ed4741", - "testModelVersionUuid":"e9b2735e91214103bc3c39f54fe9c99e", - "parentTestModelNodeUuid":"0", - "nodeCycle":1, - "nodeIgnore":"0", - "nodeSequenceTypeKey":1, - "nodeSequenceNumber":1, - "nodeTimeoutTime":0, - "nodeFailureActionKey":3, - "triggerRetryTimes":0, - "testModelName":"AutoPreload", - "triggerRetryOnePass":"0", - "deviceConfigAcquisition":"0", - "activityStatusKey":1, - "delayTime":"0", - "gmtCreate":"2022-02-25 00:00:00", - "topTestModelUuid":"efa4eb0d153492ab162c4066f4ed4741", - "topTestModelVersionUuid":"e9b2735e91214103bc3c39f54fe9c99e", - "testModelLevelKey":1, - "softwareToolParam":"{downloadUrl}", - "inputLock":0, - "resultCheckMode":0, - "outputRedirect":1, - "testModelVersionCode":"0.0.1.1", - "lastTestModelVersionCode":"0.0.1.1", - "updateFlag":false, - "testSoftwareToolTypeKey":"[[10]]", - "performEntity":1, - "deviceTypeKey":"1", - "testModelDescription":"MBV Auto Preload", - "testSoftwareToolName":"AutoPreload", - "testSoftwareToolUuid":"1419909026921086977", - "testSoftwareToolVersionNo":"1.0.0.14", - "testModelTypeKey":1, - "configFileRequiredFlag":0, - "duplicateFlag":0, - "porlistAssociatedFlag":0, - "graphicShowFlag":0, - "id":"{id}", - "level":0, - "isCheck":true, - "isConfig":false - } - ] - }, - "base":{ - "functionTypeOne":3, - "testTaskName":"AutoPreload{date}", - "testTaskTypeKey":1, - "functionTypeTwo":106, - "functionTypeThree":237, - "projectUuid":"", - "cascaderValue":[3,106,237,1066], - "functionTypeFour":1066, - "extend":{ - "testCaseForm":{ - "mbPn":"", - "modelName":"", - "bu":"", - "projectPhaseCode":"" - }, - "functionTypeOne":3, - "testTaskName":"AutoPreload{date}", - "testTaskTypeKey":1, - "functionTypeTwo":106, - "functionTypeThree":237, - "projectUuid":"", - "cascaderValue":[3,106,237,1066], - "functionTypeFour":1066, - "projectName":"" - }, - "testTaskIssueTypeCode":1 - }, - "rule":{ - "testTaskUnitBindingRuleKey":6, - "bindingRulePriority":1, - "entityPrimaryKeyList":[{"key":"{testUnitUuid}","value":"{testUnitName}"}] - }, - "testTaskIssueTypeCode":1, - "other":{"isClear":false,"type":2} -} \ No newline at end of file diff --git a/se-task-exec-spec/example/task_stress_non_project_request.json b/se-task-exec-spec/example/task_stress_non_project_request.json deleted file mode 100644 index ed5ca88..0000000 --- a/se-task-exec-spec/example/task_stress_non_project_request.json +++ /dev/null @@ -1,169 +0,0 @@ -{ - "model": { - "children": [ - { - "testModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "testModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "testModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "parentTestModelNodeUuid": "0", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 1, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "Stress_BurnIn_480Min", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "children": [ - { - "testModelNodeUuid": "203f4128668aec0264376db4fa24a450", - "testModelUuid": "5850c5278463420bb5a6e219771c1bff", - "testModelVersionUuid": "6686d7c339614c1a8a1c00e8bb0f40d1", - "parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 1, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "BurnInInstaller", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "testModelLevelKey": 1, - "softwareToolParam": "/V 9.1.1007.0", - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.4", - "lastTestModelVersionCode": "0.0.0.6", - "updateFlag": false, - "testSoftwareToolTypeKey": "[[4,42]]", - "performEntity": 1, - "deviceTypeKey": "1", - "testModelDescription": "安装BurnIn并注册", - "testSoftwareToolName": "BurnInInstaller", - "testSoftwareToolUuid": "66c3206aee894c469769861f8f5577dc", - "testSoftwareToolVersionNo": "1.0.0.1", - "testModelTypeKey": 1, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "level": 1, - "isCheck": false, - "isConfig": false - }, - { - "testModelNodeUuid": "93bae141c211641b02e47e5b8eb4b636", - "testModelUuid": "af57d8e7cc544f5491e282817479525b", - "testModelVersionUuid": "5824552e38f84074ac69bd08d85eea0a", - "parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 2, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "BurnInTestAutoStress", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "testModelLevelKey": 1, - "softwareToolParam": "TestTime=\"480\"", - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.5", - "lastTestModelVersionCode": "0.0.0.5", - "updateFlag": false, - "testSoftwareToolTypeKey": "[[1,12]]", - "performEntity": 1, - "deviceTypeKey": "1", - "testModelDescription": "BurnIn Test For Stress", - "testSoftwareToolName": "BurnInTestStress", - "testSoftwareToolUuid": "d02a1171ae50477a9a13913bfca6c0d8", - "testSoftwareToolVersionNo": "1.20.0.6", - "testModelTypeKey": 1, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "level": 1, - "isCheck": false, - "isConfig": false - } - ], - "testModelLevelKey": 3, - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.4", - "lastTestModelVersionCode": "0.0.0.4", - "updateFlag": false, - "performEntity": 0, - "deviceTypeKey": "1", - "testModelDescription": "Stress Burnin 8H Test for PA", - "testModelTypeKey": 2, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "id": "{id}", - "level": 0, - "isCheck": true - } - ] - }, - "base": { - "functionTypeOne": 3, - "testTaskName": "Stress_BurnIn_480Min{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 238, - "projectUuid": "", - "cascaderValue": [3,106,238], - "extend": { - "testCaseForm": { - "mbPn": "", - "modelName": "", - "bu": "", - "projectPhaseCode": "", - "testCaseName": [] - }, - "functionTypeOne": 3, - "testTaskName": "Stress_BurnIn_480Min{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 238, - "projectUuid": "", - "cascaderValue": [3,106,238], - "projectName": "" - }, - "testTaskIssueTypeCode": 1 - }, - "rule": { - "testTaskUnitBindingRuleKey": 6, - "bindingRulePriority": 1, - "entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}] - }, - "testTaskIssueTypeCode": 1, - "other": {"isClear": false,"type": 2} -} \ No newline at end of file diff --git a/se-task-exec-spec/example/task_stress_use_project_request.json b/se-task-exec-spec/example/task_stress_use_project_request.json deleted file mode 100644 index 6180741..0000000 --- a/se-task-exec-spec/example/task_stress_use_project_request.json +++ /dev/null @@ -1,170 +0,0 @@ -{ - "model": { - "children": [ - { - "testModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "testModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "testModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "parentTestModelNodeUuid": "0", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 1, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "Stress_BurnIn_480Min", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "children": [ - { - "testModelNodeUuid": "203f4128668aec0264376db4fa24a450", - "testModelUuid": "5850c5278463420bb5a6e219771c1bff", - "testModelVersionUuid": "6686d7c339614c1a8a1c00e8bb0f40d1", - "parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 1, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "BurnInInstaller", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "testModelLevelKey": 1, - "softwareToolParam": "/V 9.1.1007.0", - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.4", - "lastTestModelVersionCode": "0.0.0.6", - "updateFlag": false, - "testSoftwareToolTypeKey": "[[4,42]]", - "performEntity": 1, - "deviceTypeKey": "1", - "testModelDescription": "安装BurnIn并注册", - "testSoftwareToolName": "BurnInInstaller", - "testSoftwareToolUuid": "66c3206aee894c469769861f8f5577dc", - "testSoftwareToolVersionNo": "1.0.0.1", - "testModelTypeKey": 1, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "level": 1, - "isCheck": false, - "isConfig": false - }, - { - "testModelNodeUuid": "93bae141c211641b02e47e5b8eb4b636", - "testModelUuid": "af57d8e7cc544f5491e282817479525b", - "testModelVersionUuid": "5824552e38f84074ac69bd08d85eea0a", - "parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 2, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "BurnInTestAutoStress", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2022-09-14 00:00:00", - "topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81", - "topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b", - "testModelLevelKey": 1, - "softwareToolParam": "TestTime=\"480\"", - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.5", - "lastTestModelVersionCode": "0.0.0.5", - "updateFlag": false, - "testSoftwareToolTypeKey": "[[1,12]]", - "performEntity": 1, - "deviceTypeKey": "1", - "testModelDescription": "BurnIn Test For Stress", - "testSoftwareToolName": "BurnInTestStress", - "testSoftwareToolUuid": "d02a1171ae50477a9a13913bfca6c0d8", - "testSoftwareToolVersionNo": "1.20.0.6", - "testModelTypeKey": 1, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "level": 1, - "isCheck": false, - "isConfig": false - } - ], - "testModelLevelKey": 3, - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.4", - "lastTestModelVersionCode": "0.0.0.4", - "updateFlag": false, - "performEntity": 0, - "deviceTypeKey": "1", - "testModelDescription": "Stress Burnin 8H Test for PA", - "testModelTypeKey": 2, - "configFileRequiredFlag": 0, - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "id": "{id}", - "level": 0, - "isCheck": true - } - ] - }, - "base": { - "functionTypeOne": 3, - "testTaskName": "Stress_BurnIn_480Min{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 238, - "projectUuid": "000c798c09d537f4f25f5b29046aebd1", - "cascaderValue": [3,106,238], - "extend": { - "testCaseForm": { - "mbPn": "", - "modelName": "", - "bu": "", - "projectPhaseCode": "", - "testCaseName": [] - }, - "functionTypeOne": 3, - "testTaskName": "Stress_BurnIn_480Min{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 238, - "projectUuid": "{projectUuid}", - "cascaderValue": [3,106,238], - "projectName": "{projectName}" - }, - "testTaskIssueTypeCode": 1 - }, - "rule": { - "testTaskUnitBindingRuleKey": 6, - "bindingRulePriority": 1, - "entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}] - }, - "testTaskIssueTypeCode": 1, - "testCaseAssociationVersionUuidList": [], - "other": {"isClear": false,"type": 2} -} \ No newline at end of file diff --git a/se-task-exec-spec/example/task_update_driver_request.json b/se-task-exec-spec/example/task_update_driver_request.json deleted file mode 100644 index 06e245e..0000000 --- a/se-task-exec-spec/example/task_update_driver_request.json +++ /dev/null @@ -1,106 +0,0 @@ -{ - "model": { - "children": [ - { - "testModelNodeUuid": "fdafe63e6fe1a390fb30bd9f437328b1", - "testModelUuid": "46a7b0303a23df1ef6240b95b67d1b83", - "testModelVersionUuid": "07a7afe541314e8dba335681584369e3", - "parentTestModelNodeUuid": "0", - "nodeCycle": 1, - "nodeIgnore": "0", - "nodeSequenceTypeKey": 1, - "nodeSequenceNumber": 1, - "nodeTimeoutTime": 0, - "nodeFailureActionKey": 3, - "triggerRetryTimes": 0, - "testModelName": "DriverInstallTool_Driver", - "triggerRetryOnePass": "0", - "deviceConfigAcquisition": "0", - "activityStatusKey": 1, - "delayTime": "0", - "gmtCreate": "2021-09-29 00:00:00", - "topTestModelUuid": "46a7b0303a23df1ef6240b95b67d1b83", - "topTestModelVersionUuid": "07a7afe541314e8dba335681584369e3", - "documentName": "", - "children": [], - "recordNode": [], - "testModelLevelKey": 1, - "inputLock": 0, - "resultCheckMode": 0, - "outputRedirect": 1, - "testModelVersionCode": "0.0.0.2", - "lastTestModelVersionCode": "0.0.0.2", - "updateFlag": false, - "testSoftwareToolTypeKey": "[[4,42]]", - "performEntity": 1, - "deviceTypeKey": "1", - "testModelDescription": "Device Driver Installation Tool.", - "testSoftwareToolName": "DriverInstallTool", - "testSoftwareToolUuid": "3bde357b79f00187736bc2480fbe9a3d", - "testSoftwareToolVersionNo": "1.0.0.0", - "testModelTypeKey": 1, - "configFileRequiredFlag": 0, - "documentCopyDTOList": [ - { - "documentName": "{fileName}", - "fileExtensionKey": "{fileExtensionKey}", - "documentVersionNo": "", - "documentVersionUuid": "", - "fileType": "{fileExtName}", - "controller": {}, - "progressPercent": 100, - "fileUrl": "{fileUrl}", - "fileUuid": "{fileUuid}" - } - ], - "duplicateFlag": 0, - "porlistAssociatedFlag": 0, - "graphicShowFlag": 0, - "id": "{id}", - "level": 0, - "isCheck": true, - "documentValue": "{fileUuid}", - "fileUrl": "{fileUrl}", - "isConfig": false - } - ] - }, - "base": { - "functionTypeOne": 3, - "testTaskName": "DriverInstallTool_Driver{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 237, - "projectUuid": "", - "cascaderValue": [3,106,237,1066], - "functionTypeFour": 1066, - "extend": { - "testCaseForm": { - "mbPn": "", - "modelName": "", - "bu": "", - "projectPhaseCode": "", - "testCaseName": [] - }, - "functionTypeOne": 3, - "testTaskName": "DriverInstallTool_Driver{date}", - "testTaskTypeKey": 1, - "functionTypeTwo": 106, - "functionTypeThree": 237, - "projectUuid": "", - "cascaderValue": [3,106,237,1066], - "functionTypeFour": 1066, - "projectName": "", - "testCaseData": [] - }, - "testTaskIssueTypeCode": 1 - }, - "rule": { - "testTaskUnitBindingRuleKey": 6, - "bindingRulePriority": 1, - "entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}] - }, - "testTaskIssueTypeCode": 1, - "testCaseAssociationVersionUuidList": [], - "other": {"isClear": false,"type": 2} -} \ No newline at end of file diff --git a/se-task-exec-spec/references/create_task_doc.md b/se-task-exec-spec/references/create_task_doc.md deleted file mode 100644 index 5b48105..0000000 --- a/se-task-exec-spec/references/create_task_doc.md +++ /dev/null @@ -1,40 +0,0 @@ -# 下发任务的工具使用说明 - -调用`creatOrSendTask`工具下发任务，请求参数取值规则： - -- `requestBodyJson`：由调用侧提供。 -- `misUserName`：取**上下文变量**中**我的用户名**。 -- `fs`：没有特殊要求使用默认值false即可。 - -工具调用结果的处理： - -- 调用成功，把响应结果展示给用户，用户需要记住`testTaskUuid`和`testTaskCode`。 -- 调用失败，把响应结果展示给用户，友好的告知用户，下发任务工具调用失败，请您稍后再试。 - -**特别重要的事项：调用失败了，请不要重试，主动重试可能会带来糟糕的结果，除非用户主动要求。** - -## 成功示例 - -```json -{ - "code": "0", - "msg": "任务下发已提交，正在生成中", - "data": { - "testTaskUuid": "1234567890", - "offLineTestUnit": "", - "unWorkingTestUnit": "", - "testTaskCode": "TT20260923000001" - }, - "ok": true -} -``` - -## 失败示例 - -```json -{ - "code": "500", - "msg": "系统异常", - "ok": false -} -``` \ No newline at end of file diff --git a/se-task-exec-spec/references/exec_task_preload_doc.md b/se-task-exec-spec/references/exec_task_preload_doc.md deleted file mode 100644 index 9a972a9..0000000 --- a/se-task-exec-spec/references/exec_task_preload_doc.md +++ /dev/null @@ -1,58 +0,0 @@ -# 执行Preload测试文档 - -按照步骤一步一步的执行： - -1. 如果用户没有提供项目信息，询问用户项目名称，不支持五码或者别名，建议输入项目完整名称。 - -2. 将用户提供的项目名称，作为`generatePreloadUpdateLink`工具的`project`参数发起调用，若遇到失败，则告诉用户失败原因并终止流程。 - -成功示例： - -```json -{ - "downloadUrl": "string", - "project": "string", - "osVer": "string", - "os": "string", - "preloadVersion": "string", - "locationName": "string" -} -``` - -失败示例： - -```json -{ - "success": false, - "msg": "string" -} -``` - -参数说明： - -| 参数名称 | 含义 | -| --- | --- | -| `downloadUrl` | 生成的 preload 更新下载链接 | -| `project` | 项目名称 | -| `osVer` | OS版本 | -| `os` | OS目录名 | -| `preloadVersion` | 实际使用的 Preload VER | -| `locationName` | 实际使用的 Location | -| `success` | 当值为false的时候，意味着失败，成功时不返回`success`字段 | -| `msg` | 当`success`字段值为fasle时，该字段作为失败原因 | - -3. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。 - -4. 使用[请求模板文件](../example/task_preload_request.json)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。 - -## 变量表 - -JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。 - -|变量名称|取值规则| -|---|---| -|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）| -|date|从**上下文变量**取今天的日期| -|testUnitUuid|调用工具获得的测试机ID| -|testUnitName|调用工具获得的测试机名称| -|downloadUrl|调用工具获得的`downloadUrl`| diff --git a/se-task-exec-spec/references/exec_task_stress_doc.md b/se-task-exec-spec/references/exec_task_stress_doc.md deleted file mode 100644 index 09977dd..0000000 --- a/se-task-exec-spec/references/exec_task_stress_doc.md +++ /dev/null @@ -1,29 +0,0 @@ -# 执行Stress任务文档 - -按照步骤一步一步的执行： - -1. 如果用户没有提供项目信息，从第2步开始执行。如果用户提供了项目信息，阅读[查项目信息文档](./query_project_info_doc.md)，一步一步地获取`projectName`和`projectUuid`。 - -2. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。 - -3. 根据相应的[请求模板文件](#请求模板文件)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。 - -4. 阅读[下发任务文档](./create_task_doc.md)，上一步生成的JSON字符串就是`requestBodyJson`参数。 - -## 请求模板文件 - -- [无项目下发](../example/task_stress_non_project_request.json) -- [根据项目下发](../example/task_stress_use_project_request.json) - -## 变量表 - -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 deleted file mode 100644 index afa5922..0000000 --- a/se-task-exec-spec/references/exec_task_update_driver_doc.md +++ /dev/null @@ -1,73 +0,0 @@ -# 更新驱动文档 - -按照步骤一步一步的执行： - -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|调用工具获得的测试机名称| \ No newline at end of file diff --git a/se-task-exec-spec/references/query_project_info_doc.md b/se-task-exec-spec/references/query_project_info_doc.md deleted file mode 100644 index 3d0e380..0000000 --- a/se-task-exec-spec/references/query_project_info_doc.md +++ /dev/null @@ -1,47 +0,0 @@ -# 查项目信息文档 - -请先思考**上下文中是否包含项目信息？如果没有的话，请向用户询问项目名称/五码/项目别名**。 - -## 口语和变量的映射关系 - -|口语|变量名称| -|---|---| -|项目名称|projectName| -|五码|modelCode| -|项目别名|projectAlias| -|项目ID|projectUuid| - -## 工作流程 - -1. 先[查项目基础信息](#查项目基础信息)，收集**项目名称**。 -2. 再用项目名称[查项目名称和项目ID](#查项目名称和项目ID)。 - -## 查项目基础信息 - -调用`debuggingProjectQuery`根据**项目名称**检索，查不到根据**五码**检索，仍然查不到根据**项目别名**检索。根据返回结果中的`rows`判定查询结果，有3种情况： - -- 返回1条，查询成功。 -- 返回0条或多条，**向用户询问更具体的项目信息，重新查询。** -- 返回错误信息，参考[错误信息处理](#错误信息处理)。 - -## 查项目名称和项目ID - -调用`queryProjectNameList`工具，使用**项目名称**检索，响应结果是一个JSON数组，有4种情况： - -- 返回1条结果，查询成功。 -- 返回多条，把查询结果展示给用户，让用户选1条。 -- 返回0条结果，视为查询失败，告知用户查不到项目名称和项目ID。 -- 返回错误信息，参考[错误信息处理](#错误信息处理)。 - -## 错误信息处理 - -调用`debuggingProjectQuery`或`queryProjectNameList`工具遇到错误的响应示例： - -```json -{ - "code": 500, - "msg": "系统异常" -} -``` - -应对策略：友好的告知用户，因工具调用失败，请您稍后再试。**不要自行主动重试，除非用户主动要求。** \ No newline at end of file diff --git a/se-task-exec-spec/references/query_test_device_doc.md b/se-task-exec-spec/references/query_test_device_doc.md deleted file mode 100644 index fd343d1..0000000 --- a/se-task-exec-spec/references/query_test_device_doc.md +++ /dev/null @@ -1,130 +0,0 @@ -# 查测试机的文档 - -调用`queryTestUnitListByProjectName`工具，按照[请求参数说明](#请求参数说明)，并结合[工具调用的4种情况](#工具调用的4种情况)处理查询。 - -## 请求参数说明 - -|参数名称|是否必传|取值规则| -|---|---|---| -|`misUserName`|是|取**上下文变量**中**我的用户名**| -|`size`|是|固定数值，传20| -|`workingStatusKey`|是|固定传1，只查空闲的| -|`onlineStatusKey`|是|固定传2，只查在线的| -|`lockStatus`|是|固定传2，只查未锁定的| - -工具中的其他参数，**调用侧没有要求，一律不传。** - -## 工具调用的4种情况 - -- 返回了1条，根据[展示给用户的格式](#展示给用户的格式)，让用户确认是否要用这台测试机，得到用户的肯定答复后，调用测再继续执行，若用户拒绝，调用测的流程到此结束。 -- 返回了多条，根据[展示给用户的格式](#展示给用户的格式)，让用户选1台测试机，调用侧继续执行。 -- 返回了0条，告知用户您当前没有可以测试机使用，请先申请测试机，调用测的流程到此结束。 -- 查询异常，把错误信息展示给用户，友好的告诉用户，查询测试机失败了，调用侧的流程到此结束。 - -## 展示给用户的格式 - -|序号|机器ID|机器名称|在线状态|闲忙状态|锁定状态| -|---|---|---|---|---|---| -|1|123|测试机123|在线|使用中|已锁定| -|2|456|测试机456|离线|闲置中|未锁定| - -## 响应参数说明 - -|参数名称|参数描述| -|---|---| -|testUnitGroupUuid|机器分组ID| -|testUnitUuid|机器ID| -|testUnitName|机器名称| -|onlineStatus|在线状态（枚举值：1=离线，2=在线）| -|workingStatusKey|闲忙状态（枚举值：1=闲置中，2=使用中）| -|lockStatus|锁定状态（枚举值：1=已锁定，2=未锁定）| -|ipAddress|IP地址| -|projectCode|项目编号| -|projectName|项目名称| -|projectPhase|项目阶段| -|programName|项目集名称| -|modelName|五码| -|groupName|分组名称| -|mo|工单| -|fgPn|SKU| -|skuShortName|SKU别名| -|skuExtensionNo|SKU编号| -|testUnitTypeKey|测试机类型键或物料组| -|matterDescription|物料描述| -|userCode|当前使用人用户ID| -|userName|当前使用人用户名称| -|ownerCode|机器管理员用户ID| -|ownerName|机器管理员用户名称| -|shippingSn|出货流水号或机器SSN| -|mbPn|主板料号| -|mbSn|主板流水号| -|fgSn|整机流水号| -|gerberVersion|主板Gerber版本| - -## 响应参数示例 - -### 查询成功 - -```json -{ - "records": [ - { - "projectCode": "PRJ2024001", - "projectName": "Project Alpha", - "projectPhase": "EVT", - "programName": "Alpha Program", - "modelName": "LM12345", - "groupName": "Group-A", - "mo": "MO2024010001", - "fgPn": "FG-SKU-001", - "skuShortName": "SKU-A", - "skuExtensionNo": "EXT001", - "testUnitTypeKey": 1, - "matterDescription": "主板物料", - "workingStatusKey": 2, - "tokenStatus": 1, - "lockStatus": 1, - "isStore": 0, - "gmtCreate": "2024-09-20 10:30:00", - "userCode": 10086, - "userName": "张三", - "borrowStatus": 1, - "ownerCode": "ADMIN001", - "ownerName": "李四", - "shippingSn": "SN20240920001", - "mbPn": "MB-PN-001", - "gerberVersion": "V1.2", - "testUnitUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", - "testUnitSource": "1", - "onlineStatus": 2, - "mbSn": "MBSN20240001", - "fgSn": "FGSN20240001", - "comments": "测试机备注", - "testUnitGroupUuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901", - "testUnitName": "测试机-01", - "groupLeaderName": "王五", - "groupLeaderCode": "GL001", - "ipAddress": "192.168.1.100", - "ipAddressBridge": "10.0.0.100", - "vncParam": "vnc://192.168.1.100:5900", - "lcfcUuid": "lcfc-uuid-001", - "mbUuid": "mb-uuid-001" - } - ], - "total": 50, - "size": 10, - "current": 1, - "optimizeCountSql": true, - "searchCount": true, - "pages": 5 -} -``` - -### 查询异常 - -```json -{ - "code": 500, - "msg": "系统异常" -} -``` \ No newline at end of file