更新时间:2026-07-23 GMT+08:00
分享

点位批量导入与导出

用户可以使用点位批量导入功能,把提前准备好的excel格式的点位表导入到系统中,或是将系统中的点位配置导出为excel点位表,方便以后使用。

批量导入点位(同步导入)

基于OT数采提供点位的批量同步导入能力。

  1. 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。
  2. 在左侧导航栏选择边缘节点 > 节点管理,选择之前创建的边缘节点,单击对应节点名称进入详情页。
  3. 在左侧导航栏选择“数采配置 ”进入数采配置页面,在数采页签连接通道列表中选择对应的连接通道,单击 展开, 在点位映射列表页签单击“导入点位”

    图1 导入点位

  4. 在导入点位页面,单击“下载模板文件”并添加点位数据信息后,单击“添加文件”选择对应文件,返回后单击“确认”

    • 更新类型:可选择增量覆盖或全量覆盖导入,增量导入为更新已有点位,插入新点位,全量导入为删除原有点位,插入新点位。
    • 单次批量同步导入(一个excel文件)最多可以添加点位数为1000。
    图2 导入点位详情
    表1 点位模板文件说明

    参数名称

    说明

    common_config.point_id

    点位标识。

    common_config.name

    点位名称。

    common_config.device_id

    设备ID。

    common_config.property

    属性路径。

    common_config.data_type

    数据类型。

    common_config.active

    启用状态。

    collection_config.address

    点位地址。

    collection_config.data_type

    点位值的数据类型。

    collection_config.cycle

    点位的采集周期。

    stream_config.stream_ formula

    • 通过配置公式进行复杂映射,当前支持种公式:bit()和bool(),只支持整数类型。
    • bit拆分:如bit(0),表示只取采集的点位的第0位bit的值,拆出来的值作为int类型上报。例:点位的采集值为3,二进制表示为0000 0011,配置为bit(0),上报的值将为1。
    • bool()作为bit单位拆分的增强操作,将整数类型的值转换为布尔类型。如bit(0).bool()。例:点位的采集值为3,二进制表示为0000 0011,配置为bit(0).bool(),上报的值将为true。

    scaling_config.ratio

    缩放的倍率。

    scaling_config.base

    基准值。

    scaling_config.accuracy

    缩放后结果的精度,精确到小数点后几位,缺省值-1表示小数位全部保留,0表示只保留整数位,1表示保留小数点后一位等等,空值表示缺省值。

    clean_config.silent_window

    静默时间窗,在该时间窗口内,没有触发上报条件,点位将不会进行上报。

    clean_config.deviation

    震荡偏差,在该区间的值将被视为正常波动,不进行上报。

    validity_config.min

    点位上报值的最小值,小于该值则上报告警。

    validity_config.max

    点位上报值的最大值,大于该值则上报告警。

批量点位导入(异步导入)

基于OT数采提供点位的批量异步导入能力。

  1. 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。
  2. 在左侧导航栏选择边缘节点 > 节点管理,选择之前创建的边缘节点,单击对应节点名称进入详情页。
  3. 在左侧导航栏选择数采配置进入数采配置页面,在数采页签中单击“查看任务列表”,可以查看当前账号下的所有批量导入点位任务。

    图3 查看批量导入点位任务

  4. 数采页签连接通道列表中选择对应的连接通道,单击 展开, 进入批量添加页签单击“批量添加”

    图4 异步批量导入

  5. 在批量添加点位弹框中输入任务名称,单击“下载模板文件”并添加点位数据信息,单击“添加文件”选择对应文件,返回后单击“确认”

    更新类型:可选择增量覆盖或全量覆盖导入,增量导入为更新已有点位,插入新点位,全量导入为删除原有点位,插入新点位。

    图5 批量添加点位弹框
    表2 点位模板文件说明

    参数名称

    说明

    common_config.point_id

    点位标识。

    common_config.name

    点位名称。

    common_config.device_id

    设备ID。

    common_config.property

    属性路径。

    common_config.data_type

    数据类型。

    common_config.active

    启用状态

    collection_config.address

    点位地址。

    collection_config.data_type

    点位值的数据类型。

    collection_config.cycle

    点位的采集周期。

    stream_config.stream_ formula

    • 通过配置公式进行复杂映射,当前支持种公式:bit()和bool(),只支持整数类型。
    • bit拆分:如bit(0),表示只取采集的点位的第0位bit的值,拆出来的值作为int类型上报。例:点位的采集值为3,二进制表示为0000 0011,配置为bit(0),上报的值将为1。
    • bool()作为bit单位拆分的增强操作,将整数类型的值转换为布尔类型。如bit(0).bool()。例:点位的采集值为3,二进制表示为0000 0011,配置为bit(0).bool(),上报的值将为true。

    scaling_config.ratio

    缩放的倍率。

    scaling_config.base

    基准值。

    scaling_config.accuracy

    缩放后结果的精度,精确到小数点后几位,缺省值-1表示小数位全部保留,0表示只保留整数位,1表示保留小数点后一位等等,空值表示缺省值。

    clean_config.silent_window

    静默时间窗,在该时间窗口内,没有触发上报条件,点位将不会进行上报。

    clean_config.deviation

    震荡偏差,在该区间的值将被视为正常波动,不进行上报。

    validity_config.min

    点位上报值的最小值,小于该值则上报告警。

    validity_config.max

    点位上报值的最大值,大于该值则上报告警。

    1. 单个资源空间默认最多创建的批量点位任务数为20。
    2. 单个资源空间最多同时处理的批量点位任务数为10。
    3. 批量任务老化,已完成的批量任务在30天后自动老化删除,包含设备批量注册、批量删除等批量执行的任务,可配置老化时间和任务过期时间。
    4. 单个批量设备任务(一个excel文件)最多可以添加点位数为10000。
    5. 批量点位注册时,一个数据源下有等待中或正在执行时的任务时则无法创建新任务。
    6. 处于执行中的任务不能删除。

  6. 批量导入点位任务执行成功。

    图6 批量导入点位任务成功

点位导出

基于OT数采提供点位的导出能力,有两种点位导出形式可以提供给用户选择。

  • 导出至本地:用户选择导出至本地时,会在浏览器中直接下载包含点位配置的excel表格。
  • 导出至OBS:用户选择导出至OBS时,需要填写用户提前创建的OBS桶名称和OBS桶路径,这样就会保存一份包含点位配置的excel表格到指定的OBS桶路径下。
  1. 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。
  2. 在左侧导航栏选择边缘节点 > 节点管理,选择之前创建的边缘节点,单击对应节点名称进入详情页。
  3. 数采页签连接通道列表中选择对应的连接通道,单击 展开, 在点位映射列表页签单击“导出点位”

    • 选择“导出至本地”,查看导出内容,确认已经下载到本地。
      图7 导出点位到本地
    • 选择“导出至OBS”,在导出至OBS弹框中输入桶名称和对象路径,单击“确认”后可进入OBS对象存储服务控制台,找到已经创建的OBS桶,确认导出结果。

      桶名称需要用户提前在OBS创建,对象路径可以根据用户需要填写。

      图8 导出至OBS
      图9 导出OBS弹窗
      表3 导出至OBS弹框参数说明

      参数

      描述

      桶名称(bucket_name)

      OBS的桶名称,需填入提前在同region创建的OBS桶。

      对象路径(object_path)

      点位表文件会以数据源ID+时间戳的名称存入OBS桶中指定路径下,用户可以指定存入路径,例如输入dir1/dir2,最终会保存到dir1/dir2/点位表中。

相关文档