← 返回文档中心

PlgBigScreen 插件(自研)

PlgBigScreen 提供大屏编辑、模块管理、动态数据源与动态数据集能力,并通过 Web 菜单暴露统一入口。

自研扩展适用版本V6.1.0更新时间2026-04-29负责人ScadaV6WebPluginExt

PlgBigScreen 插件(自研)

功能描述

该插件用于扩展 Web 侧业务能力,支持页面交互、数据展示与集成接入。

PlgBigScreen 是基于 RapidSCADA Web 插件机制实现的大屏设计扩展,提供大屏工程管理、模块管理、动态数据源和动态数据集能力。插件加载后会在用户菜单中新增“大屏设计器”分组。

功能定位

  • 提供大屏可视化页面的编辑与发布能力。
  • 支持模块化复用,降低大屏页面重复配置成本。
  • 支持动态数据源与动态数据集,便于对接业务库与统计接口。

菜单与访问入口

插件注册后,会在 Web 菜单中增加以下入口:

  • ~/BigScreen/Index:大屏编辑
  • ~/BigScreen/Module:模块管理
  • ~/BigScreen/DynamicApiSource:动态数据源
  • ~/BigScreen/DynamicApiDataset:动态数据集

同时,后端接口统一采用 /api/bigscreen/[controller]/[action] 路由约定。

关键配置项

插件配置项由 PluginOptions 读取,主要包括:

配置键类型说明
RefreshRateint数据刷新周期(毫秒)
TableArchiveCodestring表格视图读取归档代码
TablePeriodint表格视图周期(分钟)
EventArchiveCodestring事件归档代码
EventCountint事件显示条数
EventDepthint事件追溯天数
MaxReportPeriodint最大报表周期(天)
CommandPasswordbool是否发送命令时要求密码
AllowCommandApibool是否允许命令 API
AllowAuthApibool是否允许认证 API

依赖与运行要求

  • 目标框架:net8.0
  • 依赖组件:ScadaCommon.dllScadaCommon.Log.dllScadaWebCommon.dll
  • 数据库相关包:Microsoft.EntityFrameworkCoreNpgsql.EntityFrameworkCore.PostgreSQLPomelo.EntityFrameworkCore.MySqlFreeSql.All
  • 可选配置:读取 appsettings.jsonAdminRepositoryOptions 节点。

部署说明

  1. 先完成插件工程编译并生成产物。
  2. 将插件程序集、Razor 页面、静态资源和语言文件部署到 Web 站点对应目录。
  3. 确认语言文件 lang/PlgBigScreen.zh-CN.xml 已就位。
  4. 重启 Web 站点后,检查菜单中是否出现“大屏设计器”。

排障建议

  • 若菜单未显示:检查插件是否正确加载、字典是否加载成功。
  • 若数据接口异常:优先检查 appsettings.json 中仓储配置和数据库连接。
  • 若页面资源加载失败:检查 wwwroot/plugins/BigScreen 静态资源是否完整部署。