# 事件状态机
#### 使用说明
通常情况下，状态机会关联一个对象，并关联该对象的主键字段，目的一般用于标识具体某个设备。状态机根据接收的事件和配置的条件规则更新该设备的状态，并根据执行规则中的设定进行不同的动作。系统也支持非对象绑定的模式配置状态机，例如绑定事件中的一个变量来配置状态机，一般称为流程状态机，这种状态机只能访问来自事件中的变量，与对象无关。
#### 场景描述
某公司需要对该公司各个区域设置温度监测，每个区域都有温度监控设备。当温度高于20度时，需要触发高温报警，设备状态需要从"Normal"转为"High"状态。当温度小于等于20度时，设备状态需要从"High"转成"Normal"状态并更新温度监控设备存储的温度值。
#### 前提条件
- 已创建温度监控设备对象"Conditioner__CST"，对象中id字段用于标识具体某设备（用户也可自定义某字段用于标识具体某设备，该字段必须是unique，即能够唯一标识一条记录），"current"字段用于标识设备记录的温度。
- 已创建温度监测事件"temperature_obtain__e"，该事件中自定义参数为"dev_id"（该字段必须为"Is Required"，用于匹配对象记录，字段类型需要和设备对象"Conditioner__CST"中标识具体某设备的id字段类型相同）和Number类型"temperature"，分别表示该区域的温度监控设备id和温度，具体操作步骤请参考[如何自定义事件](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0082.html)。
- 已创建高温报警事件"fire_alarm__e"，该事件中自定义参数为String类型"positionalarm"和Number类型"temperaturealarm"，分别表示高温报警位置和温度，具体操作步骤请参考[如何自定义事件](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0082.html)。
 
#### 操作步骤
1. 参考[登录经典应用设计器](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_5025.html)中操作，登录经典版应用设计器。
2. 将鼠标放在应用的某个文件夹上（如Logic），单击"+"，选择"状态机"。 
   图1选择状态机   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932885572.png)
   
   
3. 选择"创建一个新状态机"，配置相关数据，单击"添加"。 
   图2新建状态机   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932885560.png "点击放大")
   - 标签：新建状态机的标签名，用于在界面展示。
   
   - 名称：新建状态机的名称，是状态机在系统中的唯一标识。
   
   - 关联的对象：状态机关联的对象，每个对象最多只能关联创建一个状态机。本示例配置为温度监控设备对象"Conditioner__CST"。
   
   - 关联字段：状态机关联的对象中的字段，本示例配置为"id"。
   
   - 描述：状态机的描述信息。
   
   - 事件
     - 名称：状态机接收的事件，本示例配置为"temperature_obtain__e"。单击"增加"，可设置多个接收事件。
     
     - 关联字段：接收事件中的参数，本示例配置为"dev_id"，用于匹配状态机关联的对象记录。
      
   
   
   
   
4. 单击"+"，添加状态节点。 
   在本节示例中创建两个节点，选择节点图标，设置名为"Normal"和"High"。
   图3添加状态节点   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932885588.png "点击放大")
   
   
5. 如下图所示，连线走向，连接两个状态节点。 
   系统默认会将第一个节点作为起始节点。若需要将其他节点作为起始节点，需要选择该节点并单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933044964.png)。
   图4连线   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932885576.png)
   
   
6. 选择从"Normal"到"High"的连线，在配置窗口设置该状态变化的入口条件和后续动作，单击"确定"。 
   当温度高于20度时，需要触发高温报警，设备状态需要从"Normal"转为"High"状态。若"当事件发生时"选择的事件发生并满足"条件表达式"中设定条件表达式，则状态机将执行相关动作。
   图5从"Normal"到"High"的连线配置   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960124285.png "点击放大")
   - 规则名称：新建规则的名称。
   
   - 当事件发生时：可以配置为该状态变化关联的事件，也可以配置为定时器。本示例配置为事件"temperature_obtain__e"。
   
   - 条件表达式：状态变化的入口条件。本示例配置为"{!temperature_obtain__e.temperature} \> 20"。
   
   - 增加窗口条件(与)：满足"条件表达式"入口条件，并且频率达到该参数设置（事件在设定时段内重复发生次数达到指定值）后，才可进行状态迁移。 例如，配置为"至少发生 2 次/ 1 天"，表示一天内有2次温度大于20度时，才执行后续动作。不配置表示满足"条件表达式"入口条件后，即可进行状态迁移。
     
   
   - 执行（按顺序）：满足入口条件后，执行的动作。
     - 赋值：给变量赋值。
     
     - 变量初始化：重置变量。
     
     - 发送事件：发送事件。
     
     - 新建：新增对象记录。
     
     - 更新：更新对象记录。
     
     - 删除：删除对象记录。
     
     - 查询并赋值：查询对象记录。
     
     
     本示例配置为"发送事件"，并选择高温报警事件"fire_alarm__e"。
     
   
   
   发送高温报警事件"fire_alarm__e"动作配置如[图6]所示，将报警的温度更新到温度监控设备记录中。
   图6配置发送事件"fire_alarm__e"的动作   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960124277.png "点击放大")
   
   
7. 选择从"High"到"Normal"的连线，在配置窗口设置该状态变化的入口条件和后续动作，单击"确定"。 
   当温度小于等于20度时，设备状态需要从"High"到"Normal"状态并更新温度监控设备存储的温度值。
   图7从"High"到"Normal"的连线配置   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933044976.png "点击放大")
   当事件发生时：本示例配置为事件"temperature_obtain__e"。
   - 条件表达式：状态变化的入口条件。本示例配置为"{!temperature_obtain__e.temperature}\<=20"。
   
   - 执行（按顺序）：满足入口条件后，执行的动作。本示例配置为"更新"。
    
   "更新"动作配置，如[图9]所示，将事件中的温度参数值传给"current"。请提前在状态机的"变量"页面，单击"新增变量"，创建"current"变量。
   图8创建"current"变量   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960284117.png "点击放大")
   图9配置发送事件"Record Update"的动作   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932885564.png "点击放大")
   
   
8. 单击页面上方的![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933044980.png)，保存设置。
9. 保存成功后，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960284089.png)，启用状态机。
 
#### 结果验证
1. 在状态机编辑页面，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960124297.png)，在右侧输入测试参数。
   
   图10测试   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960284113.png "点击放大")
   - 事件：状态机接收的事件，本示例配置为"temperature_obtain__e"。
   
   - 事件信息：事件的输入参数，示例如下：
     ```
     {
        "temperature": 35,
        "dev_id": "c01v000000JzvtESDJFw"
     }
     ```
     
   
   
   
   
2. 单击"发送"，如果高温报警事件"fire_alarm__e"，状态处于"High"，表示测试成功。