PlgBigScreen 插件(自研)
功能描述
该插件用于扩展 Web 侧业务能力,支持页面交互、数据展示与集成接入。
PlgBigScreen 是基于 RapidSCADA Web 插件机制实现的大屏设计扩展,提供大屏工程管理、模块管理、动态数据源和动态数据集能力。插件加载后会在用户菜单中新增“大屏设计器”分组。
功能定位
- 提供大屏可视化页面的编辑与发布能力。
- 支持模块化复用,降低大屏页面重复配置成本。
- 支持动态数据源与动态数据集,便于对接业务库与统计接口。
菜单与访问入口
插件注册后,会在 Web 菜单中增加以下入口:
~/BigScreen/Index:大屏编辑~/BigScreen/Module:模块管理~/BigScreen/DynamicApiSource:动态数据源~/BigScreen/DynamicApiDataset:动态数据集
同时,后端接口统一采用 /api/bigscreen/[controller]/[action] 路由约定。
关键配置项
插件配置项由 PluginOptions 读取,主要包括:
| 配置键 | 类型 | 说明 |
|---|---|---|
| RefreshRate | int | 数据刷新周期(毫秒) |
| TableArchiveCode | string | 表格视图读取归档代码 |
| TablePeriod | int | 表格视图周期(分钟) |
| EventArchiveCode | string | 事件归档代码 |
| EventCount | int | 事件显示条数 |
| EventDepth | int | 事件追溯天数 |
| MaxReportPeriod | int | 最大报表周期(天) |
| CommandPassword | bool | 是否发送命令时要求密码 |
| AllowCommandApi | bool | 是否允许命令 API |
| AllowAuthApi | bool | 是否允许认证 API |
依赖与运行要求
- 目标框架:
net8.0 - 依赖组件:
ScadaCommon.dll、ScadaCommon.Log.dll、ScadaWebCommon.dll - 数据库相关包:
Microsoft.EntityFrameworkCore、Npgsql.EntityFrameworkCore.PostgreSQL、Pomelo.EntityFrameworkCore.MySql、FreeSql.All - 可选配置:读取
appsettings.json中AdminRepositoryOptions节点。
部署说明
- 先完成插件工程编译并生成产物。
- 将插件程序集、Razor 页面、静态资源和语言文件部署到 Web 站点对应目录。
- 确认语言文件
lang/PlgBigScreen.zh-CN.xml已就位。 - 重启 Web 站点后,检查菜单中是否出现“大屏设计器”。
排障建议
- 若菜单未显示:检查插件是否正确加载、字典是否加载成功。
- 若数据接口异常:优先检查
appsettings.json中仓储配置和数据库连接。 - 若页面资源加载失败:检查
wwwroot/plugins/BigScreen静态资源是否完整部署。