配置孪生规则

孪生规则用来动态计算孪生节点的物模型属性。本文介绍配置孪生规则的具体操作。

前提条件

已在孪生工作台为孪生节点配置功能属性。具体操作,请参见配置功能属性

背景信息

孪生规则分为自身规则和父子规则,由输入参数、表达式和输出属性组成。输入参数对应孪生节点的物模型属性,属性运行时数据变更,会触发孪生规则更新输出属性。若输出属性是其他孪生规则的输入参数,会递归触发孪生规则执行,实现孪生节点间的运行时数据联动。

背景信息

重要

自身规则的输出属性不可以触发另一个自身规则。

例如:在一个工厂孪生体中,依次逐级添加孪生节点设备中控风机温度传感器,孪生规则配置及触发流程如下图。

规则示例

规则使用限制的详细内容,请参见使用限制

编辑孪生规则

在孪生工作台中,单击孪生节点,然后在右侧的孪生节点面板,单击编辑孪生规则

编辑孪生规则

孪生规则面板,参照以下步骤,单个或批量添加孪生规则。

单个添加孪生规则

  1. 单击添加孪生规则,在弹出的对话框中,配置以下参数。

    参数

    说明

    规则名称

    自定义名称。支持中文、英文字母、日文、数字、短划线(-)、下划线(_)、正斜线(/)和半角句号(.),必须以中文、英文字母或数字开头,长度不超过30个字符。

    属性引用类型

    可选:

    • 父子规则输入参数属性来源为当前孪生节点的子节点。

    • 自身规则输入参数属性来源为当前孪生节点。

    输入参数

    自定义参数名称,然后选择对应的属性来源(孪生节点)及其属性

    参数名称支持数字和英文字母,必须以英文字母开头,长度不超过20个字符。

    单击添加参数,可添加多个输入参数,最多不超过5个。

    表达式

    在输入框内编辑运算表达式。支持的运算符和函数,请参见规则表达式

    表达式中变量的字段名称必须使用输入参数中的参数名称字段。

    表达式中包含多个入参时,任何一个属性值变更,都会触发规则。执行规则时,其他入参的值,取对应节点属性的最新快照值。

    例如:定义父子规则room1_temp+room2_temp=floor_temp,同时上报room1_temproom2_temp时,会触发两次表达式的执行:

    • room1_temp变更值+room2_temp的快照

    • room1_temp的快照+room2_temp变更值

    重要

    入参快照值为空时,表达式会计算异常。您可使用条件函数,设置入参为空时,返回默认值。函数说明,请参见Value条件函数

    输出属性

    选择当前节点的功能属性,输出表达式计算结果。

    属性引用类型自身规则,则输入参数中已添加属性,不再可选。

    每个功能属性,仅作为一个孪生规则的输出属性。

    重要

    表达式输出的数据类型,都会转为输出属性的数据类型。

    例如,表达式输出数据为Double类型,输出属性为整型,会截取Double数据的整数部分。

  2. 单击确定

批量添加孪生规则

  1. 单击批量添加,在批量添加孪生规则对话框,单击下载.xls模板,获取以当前节点名称命名的.xls规则文件。

    重要

    对于每个孪生节点,都必须下载对应的规则文件,进行配置。

    image
  2. 在规则文件中编辑规则内容,并保存。

    如下图所示,规则文件中会根据对应孪生节点的配置,提供参数配置选项。参数配置说明,请参见上文“单个添加孪生规则”。规则文件

  3. 批量添加孪生规则对话框,单击选择文件,选择已保存的.xls文件,单击打开

    如果页面提示解析失败,请单击下载不合法列表,然后根据不合法列表文件中的错误提示信息,修正规则文件后,重新上传。

  4. 上传成功后,单击确定

后续操作