旗正规则引擎规则编辑指南

看到有人问，旗正规则引擎定位就是规则逻辑实现简易，业务员也可以执行，可是试用的时候，突然发现还是有些凌乱，规则编辑感觉还是有点繁琐啊。那我说，方法还是没对路，接下来，我来献上指南。

规则包开发

通过“开始-- 程序-- 旗正商业规则定制平台— 规则配置器”启动规则配置器。启动后， 关闭欢迎首页， 进入到缺省的开发工作空间。

通过规则配置器的测试步骤包括创建工程、创建规则包、定义对象库、定义规则、发布规则包、测试规则包、创建web页面、web方式测试规则包

以下分别讲述这些步骤具体的操作方法：

1、创建工程

点击规则编辑器中的新建工程按钮：

输入“体验开发”作为工程名，如果不需要改变工程存储路径，则直接点击确定即可：

点击确定后，规则编辑器中就会出现“体验开发”的规则工程，如下：

通过windows的资源浏览器，也可以看到已经新建的规则工程的存储位置：

如下所示，可以看到在VisualRules的安装目录下的Samples目录下面，新建了一个“体验开发”的目录，在此目录下面有一个default.prj文件，以及两个目录分别为data和bak目录。其中data目录，将存放在此工程下新建的规则包。而bak目录将存放此工作下所有自动保存的规则包，以及每次备份产生的规则包备份文件。

其中，以 .auto结尾的文件，都是定时自动保存的规则包，当编辑器异常退出后，会提示是否恢复自动保存的规则包。

以.rpk~1~这种类型结尾的规则包，都是每次备份产生的规则包备份文件。当选择了恢复规则包历史时，会读取这些规则包备份文件，并且根据所选的进行恢复。
如果通过编辑器恢复失败，可以手工做恢复操作。只需根据文件的修改日期，找到需要恢复的文件，将其后缀改成.rpk之后，然后覆盖data下面对应的文件即可完成恢复工作。

2、创建规则包

右键点击“体验开发”规则工程，在弹出的菜单中选择“新建规则包”：

点击新建规则包后，在体验开发工程下面就会新建一个“规则包”的规则包，可以将其直接改名为hello：

 ![6](https://yqfile.alicdn.com/7d2a2dec2e6c5d2599a23207cd3cb61d290612f9.jpeg)

3、定义对象库

然后展开hello规则包，点击规则包下面的“对象库”，在中间的编辑窗口中，点击添加按钮，并且输入需要添加的变量名、类型和显示名称，如下所示：

同理添加另一个变量，名称为welcome，类型为string，显示名称为欢迎辞：

4、定义规则

右键点击规则包，然后在弹出的菜单中，选择“新建规则”：

点击后，会在规则包下面新建新建一个“规则”，将其名称修改为“返回欢迎辞”：

点击“返回欢迎辞”规则后，在中间的规则编辑窗体，设置条件和动作。首先添加“添加条件”按钮：

之后，点击“请选择”，在弹出的菜单中，选择传入数据— 姓名：

然后，点击条件的判断符上，在弹出的菜单中选择“不为空”：

条件设置完后，设置动作。点击“添加动作”按钮，如下：

然后，在那么动作中，点击“请点击选择”，在弹出菜单中，选择“变量赋值”：

然后，点击“选择变量”，在弹出菜单中选择传入数据→欢迎辞：

在之后生成的赋值语句中，点击“请点击选择”，在弹出菜单中选择“输入常量值”：

然后点击“空”，在弹出的文本框中，录入“Hello”，并点击确定。

添加完“Hello”之后，点击其后面的[]，在弹出菜单中选择“+”：

之后，点击“请点击选择”，在弹出的菜单中，选择“选择值”：

然后点击“请选择”，选择传入数据— 姓名：

设置完，满足条件的动作之后，在设置不满足条件的动作。首先将该规则的属性设置为“支持否则”，在规则的属性窗口中，在否则动作后面的选择框中打上勾：

之后，规则的编辑窗口，会增加否则动作。可以按照上面设置那么动作的方式来设置欢迎辞赋值为“Hello World”语句，也可以通过复制那么中的动作到否则中，然后进行修改。以下演示，怎么复制操作，首先通过鼠标拖动来选择那么中的赋值行，然后鼠标右键点击在赋值行上，选择弹出菜单中的“复制”：

复制后，右键点击否则动作中的“添加动作”按钮，然后选择“粘贴”：

然后在粘贴后的赋值行中，点击“+”，选择“[]”：

然后，点击“Hello”，在弹出的输入框中，输入“Hello World”，点击确定：

到此，就完整了规则的设置：

5、发布规则包

规则包发布时，需要根据该规则包生成对应的java代码，然后将该代码编译，生成.rsc文件。将此文件输出到调用该规则包的应用程序的路径目录中，就完成了发布操作。

VisualRules可以采用自动发布和手动发布两种方式，自动发布可以设置缺省的发布路径，并且设置成在保存的时候，同时发布规则包。手动发布是在发布时，指定输出路径：

自动发布设置

首先点击工程菜单下的“设置”：

选中“规则包保存后自动编译选项”，并且设置缺省的输出路径。缺省情况下为“Tomcat\webapps\ROOT\WEB-INF\classes”，此路径是一个相对路径，相对于VisualRules的安装目录下。

因此如果VisualRules安装目录是C:\visualRules，缺省情况下，点击保存后，会自动将规则包编译后的rsc文件保存到 C:\visualRules\ Tomcat\webapps\ROOT\WEB-INF\classes中。

自动发布

在规则配置器中，点击保存后，会将当前规则包以rpk文件的方式，并且将编译后的规则包以rsc文件的方式保存。查看规则工程目录的data下面的文件：

可以看到，在规则工程的data目录下，生成了hello.rpk的文件。其中hello就是规则包的可调用执行名。

查看规则配置器中设置的自动发布路径下，已经生成了hello.rsc文件：

此目录是VisualRules自带的Tomcat的缺省工程路径，当规则包发布到此目录后，就可以通过tomcat的 http://localhost:8880/下面的jsp文件来访问这些规则包。

手工发布：

为了能够通过规则服务来访问规则包，需要将规则包发布到VisualRules的规则服务路径中，此路径在VisualRules安装目录的rules目录下。

在规则包上点击右键，选择弹出菜单中的导出— 导出规则包编译文件：

然后选择VisualRules安装目录的rules目录，点击确定：

出现以下弹出窗体后，表示发布成功：

然后查看VisualRules安装目录的rules目录下：

已经生成hello.rsc文件，说明发布成功。

6、测试规则包

可以直接在规则配置器中，测试规则包的执行情况。点击规则包后，在中间的编辑窗体的测试窗体中，可以输入传入值，点击执行后可以显示传出值：

在姓名对应的“初始初始值”位置，双击鼠标后，可以输入初始值，假设输入为旗正，然后点击执行按钮。可以看到执行结果：

欢迎辞对应的“实际结果值”位置中，就显示了执行后的结果：“Hello 旗正”。

规则集成
Java类调用规则包

除了规则配置器嵌入的页面配置器生成的jsp页面，调用规则包之外，其他的java工程如果要调用此规则包，可以通过规则引擎类类进行调用。以下演示eclipse中java工程如何调用规则包。

设置java工程路径

首先在eclipse的java工程中，点击属性设置其路径。在其属性窗口的Java Build Path中设置Libraries，通过Add External JARs…加入VisualRules安装目录的lib下的engine.jar，在通过Add External Class Folder…加入VisualRules安装目录下的rules目录。如下所示：

添加Java测试类

在java工程中添加一个java类，名为TestHello.java，其内容编辑如下：

import com.flagleader.engine.RuleEngine;
import com.flagleader.engine.RuleEngineFactory;
public class TestHello {

public static void main(String[] args) {

 try {

 RuleEngine engine = RuleEngineFactory.newInstance().getRuleEngine();

 engine.put("name", "访问测试");

 engine.excute("hello");

 System.out.println(engine.getString("welcome"));

 } catch (Exception e) {

 e.printStackTrace() ;

}

}
执行java测试类

点击执行后，可以看到如下结果：

说明已经调用了hello规则包，并且根据传入的name值“访问测试”，返回处理结果是 hello+“访问测试”。

同理，任何的其他java类，只需加入上述的代码，即可完成调用规则包的工作。

数据集成模块中如何配置脚本模式输入组件 脚本模式组件采用的是配置json的方式配置同步任务。当表单模式透出的配置参数无法支持同步场景诉求时或配置项比较复杂，目前dataphin自定义组件UI不支持时，可采用脚本模式输入组件进行配置。本文将介绍如何同步Mysql 多表join的结果数据作为示例，其余场景均可参照此例的配置。
数据集成模块流程组件之条件分发介绍 在数据集成的过程中，在一些场景下，需要对上游数据进行分发操作，条件分发组件可对上游数据根据配置条件进行分发，本文将介绍如何进行条件分发组件的配置。
Sentinel 规则的种类 在前面的文章中，我们已经简单地介绍了如何在 Sentinel 中如何定义资源，本文将介绍 Sentinel 中所包含的各种类型的规则
如何控制工作流中的流程流转？工作流流程元素之顺序流和网关的详细解析 本文详细说明了工作流中实现流程流转的两种实现方式，分别是顺序流和网关。顺序流包括条件顺序流和默认使用的顺序流。网关包括排他网关，并行网关，包含网关以及基于事件的网关。通过对顺序流和网关的学习，可以熟练的掌握了工作流Activiti框架中最核心的点，也就是流程的流转。