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

前提条件

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

背景信息

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

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

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

触发规则示例

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

编辑孪生规则

  1. 在数字孪生工作台中,单击孪生节点,然后在数字孪生节点面板,单击编辑孪生规则
    选中节点
  2. 孪生规则面板,单个或批量添加孪生规则。
    孪生规则
    参照以下步骤,单个配置孪生规则。
    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规则文件。
      注意 对于每个孪生节点,都必须下载对应的规则文件,进行配置。
    2. 在规则文件中编辑规则内容,并保存。
      如下图所示,规则文件中会根据对应孪生节点的配置,提供参数配置选项。参数配置说明,请参见上文单个配置孪生规则规则文件
    3. 批量添加孪生规则对话框,单击选择文件,选择已保存的.xls文件,单击打开
      如果页面提示解析失败,请单击下载不合法列表,然后根据不合法列表文件中的错误提示信息,修正规则文件后,重新上传。
    4. 上传成功后,单击确定

后续步骤