68 lines
2.9 KiB
Markdown
68 lines
2.9 KiB
Markdown
# TSL 客户端远程调用
|
||
|
||
这一篇只处理 `RDo` / `RDo2` 调用客户端本地函数的语法外形、等待行为、系统参数后缀和超时后缀。
|
||
|
||
## 本篇职责
|
||
|
||
<!-- section-id: syntax-24-001 -->
|
||
|
||
回答“怎样从平台调用客户端本地函数、`RDo` 与 `RDo2` 有什么区别、`With` 与 `TimeOut` 写在哪里，以及为什么不能写成 `RDo(...)` / `RDo2(...)`”。
|
||
|
||
## 核心规则
|
||
|
||
<!-- section-id: syntax-24-002 -->
|
||
|
||
<!-- tags: 客户端远程调用 本地函数 不等待 等待返回 rdo rdo2 -->
|
||
|
||
- `RDo` 和 `RDo2` 是客户端远程调用关键字，不是普通函数。
|
||
- 两者都写在被调用的本地函数之前；圆括号属于本地函数调用，不属于 `RDo` / `RDo2`。
|
||
- `RDo` 只提交任务，不等待本地函数执行完成，也不取得函数返回值。
|
||
- `RDo2` 等待本地函数执行完成，并把该函数的结果作为整个表达式的值。
|
||
- 本地函数需要系统参数时，在调用后追加 `With SysParams`。
|
||
- `RDo2` 默认超时为 300 秒；需要自定义时，在末尾追加 `TimeOut Seconds`。文档定义的后缀顺序是先 `With`、后 `TimeOut`。
|
||
- `RDo2` 在客户机执行时需要用户权限许可；依赖客户端资源的函数不能在无 GUI 的命令行解释器中验证其交互结果。
|
||
- 被调用函数的精确签名、参数写回、返回值及运行时 scope 必须使用 `tsl-api-reference` skill 单独查询；本页只拥有 `RDo` / `RDo2` 的语法形态。
|
||
|
||
## `RDo` / `RDo2` 语法与示例
|
||
|
||
<!-- section-id: syntax-24-003 -->
|
||
|
||
<!-- tags: RDo写法 RDo2写法 InputQuery 客户端输入 对话框 远程调用超时 With系统参数 -->
|
||
|
||
原文定义使用下面的元语法；方括号表示可选部分，不是需要写进 TSL 源码的字符：
|
||
|
||
代码块身份：配置片段 / 概念骨架
|
||
|
||
```text
|
||
RDo LocalFunctionName(P1; P2; …) [With SysParams];
|
||
RDo2 LocalFunctionName(P1; P2; …) [With SysParams] [TimeOut Seconds]: Any;
|
||
```
|
||
|
||
`RDo2` 调用客户端 `InputQuery` 的原文范例可整理为：
|
||
|
||
代码块身份：可直接照写示例
|
||
代码块说明：需要平台客户端交互环境、用户权限许可，并要求目标环境提供 `InputQuery`；无 GUI 的命令行解释器不能验证弹窗结果。
|
||
|
||
```tsl
|
||
value := "";
|
||
if rdo2 InputQuery("Input", "Hint", value) then
|
||
return value;
|
||
else
|
||
return "Canceled";
|
||
```
|
||
|
||
结果说明：
|
||
|
||
- 用户确认时，`InputQuery` 返回真，输入内容写回 `value`，脚本返回该字符串。
|
||
- 用户取消时，`InputQuery` 返回假，脚本返回 `Canceled`。
|
||
- 这段代码证明的是前缀形态 `rdo2 InputQuery(...)`；`InputQuery` 的 API 事实仍需按目标 scope 单独查询。
|
||
|
||
## 禁止项
|
||
|
||
<!-- section-id: syntax-24-004 -->
|
||
|
||
- 把关键字建模成 `RDo()` 或 `RDo2(...)` 普通函数。
|
||
- 把被调用本地函数的参数误写成 `RDo2` 自身的参数表。
|
||
- 声称 `RDo` 会返回客户端函数结果。
|
||
- 忽略 `RDo2` 的客户端权限与交互环境要求。
|