Skip to content

构建语法

基本类型

类型名称示例
常量数字100
布尔true
浮点数100.001
字符串'message'
变量资源['ctrl']
系统变量[$ USERID]
接收参数[@ 0]
sql语句[# SQL]
配置参数[% api/url]

操作符

构建语言支持多种类型运算符

类型运算符说明
赋值运算符=['ctrl-b'] = ['ctrl-a'] + [@ 0] + 100 将计算结果通过 = 赋值给控件ctrl-b
算术运算符+ - * /100 - (['ctrl'] * [@ 0]) 基本类型(除布尔类型)都可以用于表达式计算值。
关系运算符== != < > >= <=关系运算符用于判断条件中,判明两个值之间的大小关系
逻辑运算符&& ||&&:当两个子表达式都为 true 时,表达式才为 true;
||:两个子表达式有一个为 true 时,表达式就为 true;

换行符

使用 enter 键对数据换行。

rb
['ctrl-A']=苍穹数码科技
股份有限公司;
['ctrl-A']=苍穹数码科技
股份有限公司;

使用 *rn* 键连接。

rb
['ctrl-A']=`${['ctrl-B']}*rn*${['ctrl-C']}`;
['ctrl-A']=`${['ctrl-B']}*rn*${['ctrl-C']}`;

使用 \n 键连接。

rb
['ctrl-A']=`${['ctrl-B']}\n${['ctrl-C']}`;
['ctrl-A']=`${['ctrl-B']}\n${['ctrl-C']}`;

语句

每条完整语句以分号结束,以便于分辨不同语句,同时建议每条语句单独一行。

rb
['ctrl-A'] = 100;
['ctrl-B'] = 200;
['ctrl-A'] = 100;
['ctrl-B'] = 200;

注释

不是所有的构建语句都是"命令"。双斜杠 '//' 后的内容将会被服务忽略。

rb
// 我不会执行
// 我不会执行

条件语句

通常在写配置事件时,您总是需要为不同的决定来执行不同的动作。您可以使用条件语句来完成该任务。

只有当指定条件为 '真' 时,该语句才会执行。

rb
if (条件) {
  当条件为真时执行的代码;
}
if (条件) {
  当条件为真时执行的代码;
}

例,当控件 'ctrl' 的值大于 100 时,将其控件值设置为 50。

rb
if (['ctrl'] > 100) {
  ['ctrl'] = 50;
}
if (['ctrl'] > 100) {
  ['ctrl'] = 50;
}

指令

指令是由平台提供的可重复执行的功能模块,查看 全部指令

调用指令时,服务会执行相应逻辑,并且调用指令不会产生返回值,所以指令通常是作为一条完整语句。

rb
['ctrl'] = SaveForm(['受理号']); // 错误, 指令没有产生值用于计算赋值

SaveForm(['受理号']);            // 正确
['ctrl'] = SaveForm(['受理号']); // 错误, 指令没有产生值用于计算赋值

SaveForm(['受理号']);            // 正确

在调用指令时,可以向其传递值,这些值被称为 '参数' 。

定义一个新语法用作示例

HelloWorld['名称'](主键)(参数1,参数2,...)

在该指令中,存在三处参数,分别是 '名称' , '主键'参数1,参数2,...

  1. 首先观察参数中命名是否被引号包裹,如 '名称' ,这意味着它只能作为普通字符串处理,在使用时此处可直接输入对应字符串,其余未被引号包裹的参数则可以输入任意基本类型。

  2. 参数1,参数2,... 中带有 ... 则代表了该位置参数可以输入任意个数。

针对该语法的配置如下所示:

rb
HelloWorld['ctrl-A'](100)(['ctrl-B'], 200, true, [@ 0]);
HelloWorld['ctrl-A'](100)(['ctrl-B'], 200, true, [@ 0]);

最后,对于小括号 () 及内部的参数都是可以省略的,而 [] 中参数是必须的。

rb
HelloWorld['ctrl-A']()(['ctrl-B']);
HelloWorld['ctrl-A']()();
HelloWorld['ctrl-A'];
HelloWorld['ctrl-A']()(['ctrl-B']);
HelloWorld['ctrl-A']()();
HelloWorld['ctrl-A'];

以上写法都是正确的,根据实际情况省略参数可有效简化语句长度。

大小写

平台对指令大小写不敏感,如 'SaveForm''saveform' 是等价的,但是推荐指令用大驼峰风格,即词组中每个单词首字母大写,以便于与基本类型进行区分。

基本类型中对大小写则是敏感的, ['A']['a'] 则是代表了两个不同的控件。

显示值

在平台操作中,某些控件同时拥有显示值和存储的实际值,如日期控件想获取其显示值则可以使用 _text 获取。

rb
['ctrl']      // 控件实际存储值
['ctrl_text'] // 控件显示值
['ctrl']      // 控件实际存储值
['ctrl_text'] // 控件显示值

字典

字典项不能超过 100 项

Powerd by Vitepress.