孪生规则用来动态计算孪生节点的物模型属性。本文介绍配置孪生规则的具体操作。
前提条件
已在孪生工作台为孪生节点配置功能属性。具体操作,请参见配置功能属性。
背景信息
孪生规则分为自身规则和父子规则,由输入参数、表达式和输出属性组成。输入参数对应孪生节点的物模型属性,属性运行时数据变更,会触发孪生规则更新输出属性。若输出属性是其他孪生规则的输入参数,会递归触发孪生规则执行,实现孪生节点间的运行时数据联动。
背景信息
自身规则的输出属性不可以触发另一个自身规则。
例如:在一个工厂孪生体中,依次逐级添加孪生节点设备中控、风机和温度传感器,孪生规则配置及触发流程如下图。
规则使用限制的详细内容,请参见使用限制。
编辑孪生规则
在孪生工作台中,单击孪生节点,然后在右侧的孪生节点面板,单击编辑孪生规则。
在孪生规则面板,参照以下步骤,单个或批量添加孪生规则。
单个添加孪生规则
单击添加孪生规则,在弹出的对话框中,配置以下参数。
参数
说明
规则名称
自定义名称。支持中文、英文字母、日文、数字、短划线(-)、下划线(_)、正斜线(/)和半角句号(.),必须以中文、英文字母或数字开头,长度不超过30个字符。
属性引用类型
可选:
父子规则:输入参数的属性来源为当前孪生节点的子节点。
自身规则:输入参数的属性来源为当前孪生节点。
输入参数
自定义参数名称,然后选择对应的属性来源(孪生节点)及其属性。
参数名称支持数字和英文字母,必须以英文字母开头,长度不超过20个字符。
单击添加参数,可添加多个输入参数,最多不超过5个。
表达式
在输入框内编辑运算表达式。支持的运算符和函数,请参见规则表达式。
表达式中变量的字段名称必须使用输入参数中的参数名称字段。
表达式中包含多个入参时,任何一个属性值变更,都会触发规则。执行规则时,其他入参的值,取对应节点属性的最新快照值。
例如:定义父子规则
room1_temp+room2_temp=floor_temp
,同时上报room1_temp
和room2_temp
时,会触发两次表达式的执行:room1_temp变更值+room2_temp的快照
。room1_temp的快照+room2_temp变更值
。
重要入参快照值为空时,表达式会计算异常。您可使用条件函数,设置入参为空时,返回默认值。函数说明,请参见Value条件函数。
输出属性
选择当前节点的功能属性,输出表达式计算结果。
若属性引用类型为自身规则,则输入参数中已添加属性,不再可选。
每个功能属性,仅作为一个孪生规则的输出属性。
重要表达式输出的数据类型,都会转为输出属性的数据类型。
例如,表达式输出数据为Double类型,输出属性为整型,会截取Double数据的整数部分。
单击确定。
批量添加孪生规则
单击批量添加,在批量添加孪生规则对话框,单击下载.xls模板,获取以当前节点名称命名的
.xls
规则文件。重要对于每个孪生节点,都必须下载对应的规则文件,进行配置。
在规则文件中编辑规则内容,并保存。
如下图所示,规则文件中会根据对应孪生节点的配置,提供参数配置选项。参数配置说明,请参见上文“单个添加孪生规则”。
在批量添加孪生规则对话框,单击选择文件,选择已保存的
.xls
文件,单击打开。如果页面提示解析失败,请单击下载不合法列表,然后根据不合法列表文件中的错误提示信息,修正规则文件后,重新上传。
上传成功后,单击确定。