事件状态机

使用说明

通常情况下，状态机会关联一个对象，并关联该对象的主键字段，目的一般用于标识具体某个设备。状态机根据接收的事件和配置的条件规则更新该设备的状态，并根据执行规则中的设定进行不同的动作。系统也支持非对象绑定的模式配置状态机，例如绑定事件中的一个变量来配置状态机，一般称为流程状态机，这种状态机只能访问来自事件中的变量，与对象无关。

场景描述

某公司需要对该公司各个区域设置温度监测，每个区域都有温度监控设备。当温度高于20度时，需要触发高温报警，设备状态需要从“Normal”转为“High”状态。当温度小于等于20度时，设备状态需要从“High”转成“Normal”状态并更新温度监控设备存储的温度值。

前提条件

• 已创建温度监控设备对象“Conditioner__CST”，对象中id字段用于标识具体某设备（用户也可自定义某字段用于标识具体某设备，该字段必须是unique，即能够唯一标识一条记录），“current”字段用于标识设备记录的温度。
• 已创建温度监测事件“temperature_obtain__e”，该事件中自定义参数为“dev_id”（该字段必须为“Is Required”，用于匹配对象记录，字段类型需要和设备对象“Conditioner__CST”中标识具体某设备的id字段类型相同）和Number类型“temperature”，分别表示该区域的温度监控设备id和温度，具体操作步骤请参考如何自定义事件。
• 已创建高温报警事件“fire_alarm__e”，该事件中自定义参数为String类型“positionalarm”和Number类型“temperaturealarm”，分别表示高温报警位置和温度，具体操作步骤请参考如何自定义事件。

操作步骤

1. 参考登录经典应用设计器中操作，登录经典版应用设计器。
2. 将鼠标放在应用的某个文件夹上（如Logic），单击“+”，选择“状态机”。
   图1 选择状态机
   

3. 选择“创建一个新状态机”，配置相关数据，单击“添加”。
   图2 新建状态机
   
   • 标签：新建状态机的标签名，用于在界面展示。
   • 名称：新建状态机的名称，是状态机在系统中的唯一标识。
   • 关联的对象：状态机关联的对象，每个对象最多只能关联创建一个状态机。本示例配置为温度监控设备对象“Conditioner__CST”。
   • 关联字段：状态机关联的对象中的字段，本示例配置为“id”。
   • 描述：状态机的描述信息。
   • 事件
     • 名称：状态机接收的事件，本示例配置为“temperature_obtain__e”。单击“增加”，可设置多个接收事件。
     • 关联字段：接收事件中的参数，本示例配置为“dev_id”，用于匹配状态机关联的对象记录。

4. 单击“+”，添加状态节点。
   在本节示例中创建两个节点，选择节点图标，设置名为“Normal”和“High”。

   图3 添加状态节点
   

5. 如下图所示，连线走向，连接两个状态节点。
   系统默认会将第一个节点作为起始节点。若需要将其他节点作为起始节点，需要选择该节点并单击。

   图4 连线
   

6. 选择从“Normal”到“High”的连线，在配置窗口设置该状态变化的入口条件和后续动作，单击“确定”。

   当温度高于20度时，需要触发高温报警，设备状态需要从“Normal”转为“High”状态。若“当事件发生时”选择的事件发生并满足“条件表达式”中设定条件表达式，则状态机将执行相关动作。

   图5 从“Normal”到“High”的连线配置
   
   • 规则名称：新建规则的名称。
   • 当事件发生时：可以配置为该状态变化关联的事件，也可以配置为定时器。本示例配置为事件“temperature_obtain__e”。
   • 条件表达式：状态变化的入口条件。本示例配置为“{!temperature_obtain__e.temperature} > 20”。
   • 增加窗口条件(与)：满足“条件表达式”入口条件，并且频率达到该参数设置（事件在设定时段内重复发生次数达到指定值）后，才可进行状态迁移。

     例如，配置为“至少发生 2 次/ 1 天”，表示一天内有2次温度大于20度时，才执行后续动作。不配置表示满足“条件表达式”入口条件后，即可进行状态迁移。

   • 执行（按顺序）：满足入口条件后，执行的动作。
     • 赋值：给变量赋值。
     • 变量初始化：重置变量。
     • 发送事件：发送事件。
     • 新建：新增对象记录。
     • 更新：更新对象记录。
     • 删除：删除对象记录。
     • 查询并赋值：查询对象记录。

     本示例配置为“发送事件”，并选择高温报警事件“fire_alarm__e”。

   发送高温报警事件“fire_alarm__e”动作配置如图6所示，将报警的温度更新到温度监控设备记录中。

   图6 配置发送事件“fire_alarm__e”的动作
   

7. 选择从“High”到“Normal”的连线，在配置窗口设置该状态变化的入口条件和后续动作，单击“确定”。
   当温度小于等于20度时，设备状态需要从“High”到“Normal”状态并更新温度监控设备存储的温度值。

   图7 从“High”到“Normal”的连线配置
   
   当事件发生时：本示例配置为事件“temperature_obtain__e”。

   • 条件表达式：状态变化的入口条件。本示例配置为“{!temperature_obtain__e.temperature}<=20”。
   • 执行（按顺序）：满足入口条件后，执行的动作。本示例配置为“更新”。

   “更新”动作配置，如图9所示，将事件中的温度参数值传给“current”。请提前在状态机的“变量”页面，单击“新增变量”，创建“current”变量。

   图8 创建“current”变量
   
   图9 配置发送事件“Record Update”的动作
   

8. 单击页面上方的，保存设置。
9. 保存成功后，单击，启用状态机。

结果验证

1. 在状态机编辑页面，单击，在右侧输入测试参数。
   图10 测试
   
   • 事件：状态机接收的事件，本示例配置为“temperature_obtain__e”。
   • 事件信息：事件的输入参数，示例如下：

     {
        "temperature": 35,
        "dev_id": "c01v000000JzvtESDJFw"
     }

2. 单击“发送”，如果高温报警事件“fire_alarm__e”，状态处于“High”，表示测试成功。