# 点位批量导入与导出 用户可以使用点位批量导入功能，把提前准备好的excel格式的点位表导入到系统中，或是将系统中的点位配置导出为excel点位表，方便以后使用。 #### 批量导入点位（同步导入） 基于OT数采提供点位的批量同步导入能力。 1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。 2. 在左侧导航栏选择"边缘节点 \> 节点管理"，选择之前创建的边缘节点，单击对应节点名称进入详情页。 3. 在左侧导航栏选择"数采配置 "进入数采配置页面，在"数采"页签连接通道列表中选择对应的连接通道，单击![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001695527572.png "点击放大") 展开， 在"点位映射列表"页签单击"导入点位" 。 图1导入点位 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001743157017.png "点击放大") 4. 在导入点位页面，单击"下载模板文件"并添加点位数据信息后，单击"添加文件"选择对应文件，返回后单击"确认"。 ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) - 更新类型：可选择增量覆盖或全量覆盖导入，增量导入为更新已有点位，插入新点位，全量导入为删除原有点位，插入新点位。 - 单次批量同步导入（一个excel文件）最多可以添加点位数为1000。 图2导入点位详情 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001695477662.png "点击放大") 表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边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。 2. 在左侧导航栏选择"边缘节点 \> 节点管理"，选择之前创建的边缘节点，单击对应节点名称进入详情页。 3. 在左侧导航栏选择"数采配置"进入数采配置页面，在"数采"页签中单击"查看任务列表"，可以查看当前账号下的所有批量导入点位任务。 图3查看批量导入点位任务 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001695368096.png "点击放大") 4. 在"数采"页签连接通道列表中选择对应的连接通道，单击![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000002670271735.png "点击放大") 展开， 进入"批量添加"页签单击"批量添加"。 图4异步批量导入 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001695498888.png "点击放大") 5. 在批量添加点位弹框中输入任务名称，单击"下载模板文件"并添加点位数据信息，单击"添加文件"选择对应文件，返回后单击"确认"。 ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) 更新类型：可选择增量覆盖或全量覆盖导入，增量导入为更新已有点位，插入新点位，全量导入为删除原有点位，插入新点位。 图5批量添加点位弹框 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001695343624.png "点击放大") 表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 | 点位上报值的最大值，大于该值则上报告警。 | ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) 1. 单个资源空间默认最多创建的批量点位任务数为20。 2. 单个资源空间最多同时处理的批量点位任务数为10。 3. 批量任务老化，已完成的批量任务在30天后自动老化删除，包含设备批量注册、批量删除等批量执行的任务，可配置老化时间和任务过期时间。 4. 单个批量设备任务（一个excel文件）最多可以添加点位数为10000。 5. 批量点位注册时，一个数据源下有等待中或正在执行时的任务时则无法创建新任务。 6. 处于执行中的任务不能删除。 6. 批量导入点位任务执行成功。 图6批量导入点位任务成功 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001743267341.png "点击放大") #### 点位导出 基于OT数采提供点位的导出能力，有两种点位导出形式可以提供给用户选择。 - 导出至本地：用户选择导出至本地时，会在浏览器中直接下载包含点位配置的excel表格。 - 导出至OBS：用户选择导出至OBS时，需要填写用户提前创建的OBS桶名称和OBS桶路径，这样就会保存一份包含点位配置的excel表格到指定的OBS桶路径下。 1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。 2. 在左侧导航栏选择"边缘节点 \> 节点管理"，选择之前创建的边缘节点，单击对应节点名称进入详情页。 3. 在"数采"页签连接通道列表中选择对应的连接通道，单击![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000002670111867.png "点击放大") 展开， 在"点位映射列表"页签单击"导出点位"。 - 选择"导出至本地"，查看导出内容，确认已经下载到本地。 图7导出点位到本地 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001743282461.png "点击放大") - 选择"导出至OBS"，在导出至OBS弹框中输入桶名称和对象路径，单击"确认"后可进入[OBS对象存储服务控制台](https://www.huaweicloud.com/product/obs.html)，找到已经创建的OBS桶，确认导出结果。 ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) 桶名称需要用户提前在OBS创建，对象路径可以根据用户需要填写。 图8导出至OBS ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000002640273162.png "点击放大") 图9导出OBS弹窗 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000002670273043.png "点击放大") 表3导出至OBS弹框参数说明 | 参数 | 描述 | |:---|:---| | 桶名称（bucket_name） | OBS的桶名称，需填入提前在同region创建的OBS桶。 | | 对象路径（object_path） | 点位表文件会以数据源ID+时间戳的名称存入OBS桶中指定路径下，用户可以指定存入路径，例如输入dir1/dir2，最终会保存到dir1/dir2/点位表中。 |