附录A：统计计算脚本规范

统计脚本规范

统计脚本示例

{
 "name": "读数转用量", 
  "func": "accumulate",  
  "key": "L2",   
  "schedule": {      
    "spec": "0 0 1 *\/1 * *" 
    },  
 "result": {      
     "precision": 2  
    }, 
  "filter": "FILTER1043991947816", 
 "condition": "",  
   "object_list": ["OBJ20211104001"]
}

• name:指定统计项目名称

• func:指定统计方法，就是对设备的某个fv要进行何种统计,支持的统计函数有

  • accumulate:读数转用量
  • avg:平均（算术平均）
  • count:计数
  • distinct:去重后数量(枚举值个数)
  • first:最旧值(周期内最早一个值)
  • hour:耗时统计
  • integral:数值积分
  • last:最新值(周期内最后一个值)
  • max:最大
  • median:中位数
  • min:最小
  • spread:极差(最大 - 最小)
  • sum:求和
  • stddev:标准差

• object_list:要统计的设备列表

• key:指定要统计的设备的FV

• schedule

  • spec:统计周期，指定多久生成一次结果，周期不可小于一分钟
    

• result

  • precision:指定结果输出的精度
  • var_name:指定结果的key，不填写则Statistics Block 自动生成~~

• filter:指定统计项目引用的过滤模型

• condition:指定统计项目引用的条件模型

• func_params:函数参数设置

  • hour函数参数设置

计算脚本规范

• name:指定计算项目的名称
• expr:指定计算项目使用的表达式
  • 支持使用的+ - * / ()
  • 指定的变量必须在statis_var_list或者obj_var_list指定
• triggert:结果由统计脚本触发,这里填写统计项目的UID,支持填写多个
• statis_var_list:指定用于给expr引用的统计结果的var_name列表
• obj_var_list:指定用于给logic_expr引用的对象FV列表
• result
  • precision:指定结果输出的精度
  • var_name:指定结果的key，不填写则Statistics Block 自动生成

条件模型

• logic_expr:必须填写逻辑表达式
  • 支持使用的+ - * / () && || & | == !=
  • 指定的变量必须在obj_var_list指定
• obj_var_list:指定用于给logic_expr引用的对象FV列表
• default:指定默认值（若logic_expr计算错误，使用default的值。true为保留，false为不保留）

过滤模型

过滤模型目前仅在函数 accumulate 会使用

• first_min:阈值过滤最小值
• first_max:阈值过滤最大值
• sigma:过滤系数
• mean_factor:规划阈值过滤

变量规则约束

1. 变量名只能是字母（A-Z,a-z）、数字(0-9)或下划线

2. 第一个字母不能是数字，例如2Lerver这不是一个合法的变量

3. 区分大小写，例如iA和ia是两个不同的变量

4. 不能是golang关键字，例如不能用go这个单词来命名一个变量

5. golang保留关键字参考