Appearance
构建语法
基本类型
类型 | 名称 | 示例 |
---|---|---|
常量 | 数字 | 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,...
中带有...
则代表了该位置参数可以输入任意个数。
针对该语法的配置如下所示:
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 项