1. Mapping映射表规范

• 1. Mapping映射表规范
  • 1.1. 修订记录
  • 1.2. 概述
  • 1.3. 文档说明
  • 1.4. 适用对象
  • 1.5. 术语和缩略词
  • 1.6. Mapping Template规范
  • 1.7. Mapping Script规范
    • 1.7.1. Mapping格式示例
    • 1.7.2. 标准类型
    • 1.7.3. 队列类型
    • 1.7.4. 矩阵类型
    • 1.7.5. 扩展类型（$）
    • 1.7.6. 函数类型（@）
      • 1.7.6.1. 常量支持
      • 1.7.6.2. 函数支持
        • 1.7.6.2.1. 单参数函数
        • 1.7.6.2.2. 双参数函数
    • 1.7.7. 离线数据类型（&）

1.1. 修订记录

1.2. 概述

1.3. 文档说明

Mapping表中关于Template、script字段的规则说明。

1.4. 适用对象

本文档的目的读者是智物联物联网体系下所有开发人员。

1.5. 术语和缩略词

1.6. Mapping Template规范

Mapping Template脚本主要作用于设备信息的扩展字段，在设备信息信息中需要显示哪些设备字段在此配置即可。

上图显示扩展字段代码模板如下：

[{
    "title": "锅炉信息",
    "data": [
        ["燃料类型", "天然气"],
        ["锅炉重量", "2吨"],
        ["出厂日期", "2018-03-03"]
    ]
}, {
    "title": "能效指标信息",
    "data": [
        ["热效率", 0.8],
        ["燃料热值", 7000],
        ["*吨汽燃料指标*", 0.21]
    ]
}]

• Title：为段落标题，名称可自定义，即代码中“锅炉信息”、“能效指标信息”可更改。
• Data：为段落中字段内容，字段名和字段值可自定义。

1.7. Mapping Script规范

Mapping Script脚本主要将适配器上报的 key 映射为系统可识别的变量，并将适配器和设备的关系进行关联对应。。

1.7.1. Mapping格式示例

[
    ["v1", "english_label", "中文标签", "Aprus1", "L1_1_123", "STA"],
    ["v2", "english_label", "中文标签", "$AprusID-1", "L1_2_456", "STA"],
    ["v3", "english_label", "中文标签", "$AprusID-2", "L1_2_789", "STA"],
    ["v4", "english_label ", "中文标签", "", "", "VEC", ["v1", "v2", "v3", 4]],
    ["v5", "english_label ", "中文标签", "", "", "MAT", [["v1", "v2"],["v3", 44]]],
    ["v6", "english_label", "中文标签", "$AprusID-1", "L1_2_456", "@Expr",
        {
            "expr": "max((v1),(v2))+sin(v3/180*Pi)",
            "args": [
                ["v1>=300 && v1<=800", 1],
                ["v1<300 || v1>800", 0]
            ]
        }
    ],
    ["v7","english_label","中文标签","a3","L99","&Collectos",
        {
            "equipment_id": "2",
            "collect_id": "234",
            "reply": "float64"
        }
    ]
]

说明：标点符号为英文，是可以解析的json串。所有mapping规则都将添加至中括号[]中，每一条mapping规则用逗号,隔开。

1.7.2. 标准类型

标准类型的格式如下：

["v1", "english_label", "中文标签", "Aprus1", "L1_1_123", "STA"]

1. 第一个参数为设备FV,用于拼接mosaic的key和页面展示所绑定的key。该值不能为空，且只能由字母数字下划线组成，大小写区分，并且由字母开头。
2. 第二个参数为设备FV的英文标签
3. 第三个参数为设备FV的中文标签
4. 第四个参数为设备FV所对应的适配器
5. 第五个参数为设备FV所对应的适配器的KEY
6. 第六个参数为设备FV的分类共有 STA, EVNT, FLT, ALT,SET这5种

1.7.3. 队列类型

队列类型的格式如下：

["v1", "english_label", "中文标签", "", "", "VEC", ["S01", "S02", "S03", 4]]

1. 第一个参数为设备FV,用于拼接mosaic的key和页面展示所绑定的key。该值不能为空，且只能由字母数字下划线组成，大小写区分，并且由字母开头。
2. 第二个参数为设备FV的英文标签
3. 第三个参数为设备FV的中文标签
4. 第四, 五个参数置空做兼容
5. 第六个参数为‘VEC’
6. 第七个参数为一维数组，可以填其他单值fv或直接填值

1.7.4. 矩阵类型

矩阵类型的格式如下：

["v1", "english_label", "中文标签", "", "", "MAT",[["S01", "S02"],["S03", 444]]]

1. 第一个参数为设备FV,用于拼接mosaic的key和页面展示所绑定的key。该值不能为空，且只能由字母数字下划线组成，大小写区分，并且由字母开头。
2. 第二个参数为设备FV的英文标签
3. 第三个参数为设备FV的中文标签
4. 第四, 五个参数置空做兼容
5. 第六个参数为MAT’
6. 第七个参数为二维数组，可以填其他单值fv或直接填值

1.7.5. 扩展类型（$）

扩展类型的格式如下：

["v1", "english_label", "中文标签", "$AprusID-1", "L1_1_123", "STA"]

1. 第四个参数为设备FV所对应的适配器，使用“$AprusID-n”来替代固定适配器，n代表设备的apruslist中的第n个适配器。例如apruslist为[“aprus100”,”aprus200”],则“$AprusID-1”转化为“aprus100“。若n大于apruslist中的个数，则忽略该条mapping规则
2. 其余参数和标准类型一致

1.7.6. 函数类型（@）

函数类型的格式如下：

["v4", "english_label", "中文标签", "$AprusID-1", "L1_2_456", "@Expr",
    {
        "expr": "max((v1),(v2))+sin(v3/180*Pi)",
        "args": [
            ["v1>=300 && v1<=800", 1],
            ["v1<300 || v1>800", 0]
        ],
        "digit": 3,
        "default": 0,
        "v1": 1
    }
]

1. 前五个参数和扩展类型一致，适配器以及适配器key作为触发使用，无实际匹配值
2. 具体使用例子：

例子1：

["v4", "english_label", "中文标签", "$AprusID-1", "L1_2_456", "@Expr",
    {
        "expr": "max((v1),(v2))+sin(v3/180*Pi)",
        "digit": 3,
        "default": 0,
        "v1": 1
    }
]

当函数这样写时，代表着v1,v2,v3若更新，则将计算max((v1),(v2))+sin(v3/180 Pi)的结果保存到FVv4中，最后一致保存至mosaic。若v1,v2,v3没有值，则使用配置的值，也就是v1=1，否则默认使用default的值，也就是v2=0,v3=0。*若存在没匹配的值，则不计算。例如在未配置default的情况下，mosaic中没有v2或v3的值，则不计算v4的值。

例子2：

["v4", "english_label", "中文标签", "$AprusID-1", "L1_2_456", "@Compare", {
    "args": [
        ["v1 >=300 && v1 <=800", 1],
        ["v1 <300 || v1 >800", 0]
    ],
    "digit": 3,
    "default": 0,
    "v1": 1
}]

当v1大于等于300并且v1小于等于800时，v4=1，不继续执行后续判断；否则按照顺序往下执行，判断v1是否小于300或者大于800，如果是，则v4=0。若v1没有值，则使用v1=1该值。若存在没匹配的值，则不计算。

1. 第七个参数为调用函数的表达式。键expr,args,digit不可修改，键对应值可修改。键值内容为数值或FV，支持部分常量，支持四则运算，支持部分函数，digit为返回值位数。
2. 运算符优先级（数字越大越优先）：

1.7.6.1. 常量支持

1.7.6.2. 函数支持

1.7.6.2.1. 单参数函数

1.7.6.2.2. 双参数函数

1.7.7. 离线数据类型（&）

离线数据类型的格式如下：

["v7", "english_label", "中文标签", "a3", "L99", "&Collectos", {
    "equipment_id": "$2",
    "collect_id": "234",
    "reply": "float64"
}]

1. 前五个参数和扩展类型一致，适配器以及适配器key作为触发使用，无实际匹配值，key的含义可参考具体定义的文档
2. 第六个参数为所查询的数据库表名，表名前添加&符号。不用加’admin_’前缀。
3. 数据库表中一定要含有equipment_id字段，data字段，created字段。
4. 第七个参数为所查询的参数，格式为json。
5. json中必有reply，作为返回值类型。其余key为字段名，作为查询条件，对应的value为字段值。
6. 若该离线数据是针对设备组的，则参数中的equipment_id可以设置为$n,n为设备组中自设备的排序号。例如：子设备为1001，1002。则["v7","english_label","中文标签","a3","L99","&Collectos",{"equipment_id":"$2","collect_id":"234","reply":"float64"}]，中的equipment_id会替换为1002，设备中不会生效。
7. reply代表返回值类型，目前仅支持float64，string两种格式
8. 上述mapping对应的sql：select data from admin_collectos where equipment_id = ‘2’ and collect_id = ‘234’ order by created desc limit 1
9. 数据表

1. 可选参数