add

se-task-exec-spec/references/exec_task_preload_doc.md

@@ -1 +1,57 @@
-# 执行Preload测试文档
+# 执行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|调用工具获得的测试机名称|