上传服务

适用版本：DASS5（当前版本）
前提：已登录 DASSConsole；若使用驱动侧历史回补，需驱动本身支持

【说明】：数据上传是 DASS 软件的核心功能之一，用来配置从现场采集、并上传到指定服务器或应用的数据。采集与上传代表数据的流入和流出盒子两个方向，两种服务的操作步骤基本一致。

【入口】：数据上传 → 上传服务

本页分两部分：

• 上传服务管理：服务的新建、查询、编辑、删除、日志下载、历史回补、启停与重启
• 上传测点管理：服务下测点的查询、添加、删除、编辑、导入、导出、模板下载、清空与清洗

功能概述

上传服务是 DASS 的北向数据出口：把实时库中的数据按目标协议推送到中心数据库或第三方系统，同时承担协议转换。

它与采集服务结构一致（服务 → 通道 → 测点），但测点是对已有采集点 / 计算点的引用（以 ID 为准），因此上传点不重复定义采集属性，只配置上传侧的映射与量程。

核心价值：让"采上来的数据"能按对方系统的要求送出去，而不必为每个目标系统重建采集链路。

使用场景

• 需要把 DASS 数据接入上层平台 / 中心库 / 第三方系统；
• 更换或新增上级系统，需调整上传协议与映射；
• 同一批测点要同时上报多处（建多个上传服务复用同一批采集点）。

前置条件

• 源测点已存在：要先有采集点或计算点（上传点是对它们的引用）；
• 驱动已装：如 OP2_Modbus_Slave_TCP、OP2_MQTT_MagusIot 等；
• 授权余量：服务数与点数未超限；
• 命名约束：服务名 ≤ 11 字节且唯一，描述不能为空。

全部服务视图

【说明】：本页同样有「全部服务」视图，用于总览本网关的全部上传服务并按状态筛选、批量启停。

【操作】：进入「数据上传 → 上传服务」后，左侧服务树顶部是「全部服务」根节点并默认选中，右侧即为全部上传服务列表；列表的汇总条（共 N 个上传服务 / 运行中 / 已停止 / 链路异常）、查询区（服务名称 / 描述 + 状态 + 链路）、表格列（服务名称 + 驱动、服务描述、运行状态、链路状态、通道数、资源占用、操作）、分页与勾选后的批量启停（同样有列出受影响服务名与数量的二次确认框），说明与采集服务完全一致，见「采集服务 → 全部服务视图」，此处不再重复。

【说明】两个页面的差别只在服务类型：本页列的是上传服务，操作列进入的是上传服务的测点信息与实时日志页；链路状态同样按上行四态展示。

上传服务管理

左侧树列出全部上传服务，树上方按钮为【创建服务】。
选中一个服务后，右侧服务卡片上直接提供 6 个按钮：停止服务 ／ 重启服务 ／ 编辑 ／ 删除 ／ 下载日志 ／ 历史回补。
下方有两个页签：测点信息、实时日志。

新建上传服务

【说明】：用于新建上传服务。
【操作】：点击【数据上传】→【上传服务】菜单，再点击【创建服务】按钮。后续步骤与配置向导中创建上传服务一致，可参考上文。

查询上传服务

【说明】：用于查询上传服务。
【操作】：在搜索框内输入节点名称即可。

编辑上传服务

【说明】：用于修改服务配置。
【操作】：在左侧树中选中一个服务，点击服务卡片上的【编辑】，即可修改服务配置。

删除上传服务

【说明】：删除当前上传服务及其下测点数据。删除后服务对应的节点也会一并删除。

【警告】删除不可恢复。若只是要重配测点、保留服务配置，请改用【清空测点】。

【操作】：在左侧树中选中一个服务，点击【删除】，在二次确认弹框中点击【确定】即可。

下载日志

【说明】：按时间选取所需下载的日志文件。
【操作】：在左侧树中选中一个服务，点击【下载日志】，选择要下载的日志后点击【下载】即可。

历史回补

【说明】：用于将指定时间段内的历史数据全部重新发送，会消耗较大流量，请酌情使用。

上传服务中，在驱动支持的前提下，以下数据可自选时间段进行回补：

• 连接上传服务器前，保存在 DASS 中的历史数据；
• 由于通讯异常未成功上传的历史数据，一并发送到上传服务器。

【操作】：在左侧树中选中一个服务，点击【历史回补】，选择回补的时间段，点击【确认】即可。

启停控制

【说明】：用于控制服务启停。

• 开启服务：启用服务，与设备建立连接，正常请求测点数据；
• 停止服务：服务中止，与设备连接断开，测点无数据。

服务运行时卡片上显示【停止服务】，停止后显示【开启服务】。

停止服务

【操作】：在左侧树中选中一个服务，点击【停止服务】即可，点击后立即执行、无需二次确认；停止完成后卡片上的按钮变为【开启服务】。

启动服务

【操作】：在左侧树中选中一个服务，点击【开启服务】即可，点击后立即执行、无需二次确认；启动完成后按钮变回【停止服务】。

重启服务

【说明】：用于重启该服务，使配置变更生效。
【操作】：在左侧树中选中一个服务，点击【重启服务】即可，点击后立即执行、无需二次确认；重启过程中服务短暂不可用。

上传测点管理

在左侧树中选中一个服务，右侧切到【测点信息】页签。
工具栏按钮：添加测点 ／ 删除测点 ／ 清空测点 ／ 导入测点 ／ 导出测点 ／ 模板下载 ／ 清洗测点；
表格每行的【操作】列提供编辑 ／ 删除。

查询测点

【操作】：在左侧树中选中一个服务，在输入框中输入点名或描述，点击【查询】按钮即可。

添加测点

【操作】：在左侧树中选中一个服务，点击【添加测点】按钮即可。后续步骤与配置向导中创建上传测点一致，可参考上文。

删除测点

【操作】：在左侧树中选中一个服务，勾选该服务下要删除的测点，点击【删除测点】，在弹框中点击【确定】即可。

编辑测点

【操作】：

步骤1. 在左侧树中选中一个服务，勾选要编辑的测点，点击该行【操作】列中的【编辑】。

步骤2. 修改测点信息，点击【保存】即可。

导入测点

【说明】：当已通过模板或导出功能获得测点文件（.xlsx）时，可在此处上传。
【操作】：点击【导入测点】，选择相应的 .xlsx 文件，点击【上传】按钮即可。

导出测点

【说明】：导出该服务内的所有测点，可用于测点迁移 / 备份。
【操作】：点击【导出测点】，即可获取测点文件（服务名.xlsx），按需编辑后上传导入至其他服务。

下载测点模板

【说明】：由于单个添加测点效率较低，DASS 支持通过 .xlsx 文件批量创建测点。
【操作】：点击【模板下载】，即可获取测点模板文件（服务名.xlsx），按需编辑后上传导入至其他服务。

清洗测点

【说明】：用于清理该服务下所有测点的脏数据，包括缓存、无效、重复的数据，提高 DASS 系统的空间利用率。
【操作】：在左侧树中选中一个服务，点击【清洗测点】，弹框中点击【确定】即可。

清空测点

【说明】：清空该服务下所有测点信息。当希望保持服务配置且重配测点时使用。
【操作】：在左侧树中选中一个服务，点击【清空测点】，弹框中点击【确定】即可。

【警告】清空后该服务下的测点全部消失且不可恢复，操作前请先【导出测点】留一份备份。

参数说明

字段	取值 / 约束	说明
服务名称	≤ 11 字节，全局唯一	与采集服务同规则
选择应用	上传驱动（如 OP2_Modbus_Slave_TCP）	—
描述	不能为空	—
测点 ID	必填	指向源采集点 / 计算点的 ID，系统以 ID 为准同步核心属性
同步属性（UM）	必填：同步 / 变化	新增接口不含该字段，只能在更新或文件导入时设置
量程 / 系数 / 偏移	TV / BV / FK / FB	默认值与约束见「用户必读 → 默认参数」

注意事项

✅ 允许：上传服务 / 通道 / 上传点的增删改；下载日志；历史回补。

❌ 禁止 / 需谨慎：

• ⚠️ 警告 上传点是对源点的引用：源点被删除后上传点将失效，删除采集点前先检查上传关联；
• ⚠️ 警告 上传服务的停止/重启会造成上级系统数据断档；
• ⚠️ 注意 上传点的核心属性（点名 / 别名 / 描述 / 量纲 / 点类型）继承自源点，不可在上传侧单独修改；
• ⚠️ 注意 源点为系统点或计算点时，后端强制 FK=1、TV=100、BV=0。

示例

把已有采集点上传到上级 Modbus 主站：

1. 新建上传服务：应用 OP2_Modbus_Slave_TCP，服务名 qs_up，描述 快速入门示例；
2. 通信配置：按要求填写监听端口与设备地址；
3. 【添加测点】勾选要上传的测点 → 【确定】；
4. 如需 同步属性，进入该上传点的【编辑】或通过文件导入设置；
5. 验证：上级主站能读到数据；「数据上传 → 上传服务」树中可见该服务与测点。

常见问题及解决方法

现象	原因	处置
添加上传点后列表不显示	历史缺陷（列表刷新问题）	升级到 V5.4.0 及以上（已修复）
无法添加外部库上传点	外部库未连接或节点为空	先确认外部实时库连接与节点（见「数据镜像」）
上传点 ID 报错	ID 为空或非整数	上传点 ID 必填且必须指向已存在的源点
上级系统收不到数据	通道/端口未通、同步属性设置不当	先从服务端确认通道状态，再核对 UM 设置

相关命令/接口

见**《DASS5 接口与二次开发手册》** → 「4.6 上传服务与上传测点」。

安全声明

⚠️ 警告 上传服务连接的是外部系统：确认目标地址与控制权限归属，避免误写他人库表。

⚠️ 注意 上传点与源点是引用关系，删除源点前请先解除上传关联，否则上级系统会出现空值。