本文记录我在公司实际项目中用智表SmartExcel 低代码平台配合 AJ-Report 制作业务数据大屏的完整流程。包含数据字典视图搭建、动态数据源配置、大屏组件使用以及我踩过的几个典型坑和解决办法。适合刚接触低代码 BI 的同学参考。一、背景我们要解决什么问题公司日常的业务数据采购、生产、库存、销售都躺在 SQL Server 里但业务部门想要一块实时可视化的数据大屏能随时看到业务动态而不是天天人工导 Excel。低代码方案的好处是不用写前端、不用写接口在平台上通过「配置数据源 拖拽组件」就能拼出大屏。本文用的两个工具工具角色说明智表SmartExcel低代码平台 / 数据源底座负责把业务数据库里的表结构、数据暴露成「数据源」AJ-Report开源 BI 大屏工具负责连接数据源、拖拽图表组件、生成可视化大屏⚠️ 说明AJ-Report 本身是开源项目非金蝶产品我们公司把它集成在智表环境里一起用所以文中会交替提到两者。二、环境准备前置条件开始前确认你有这些东西智表 Excel 客户端设计器能登录公司服务器AJ-Report 访问地址一般是http://你的服务器IP:端口/index.html#问公司要数据库账号通常是sa密码问管理员或者在「数据中心 - 数据源」里能翻到目标数据库本文示例库名TYX数据库是SQL Server端口默认 1433如果 AJ-Report 连数据库报「连接超时」基本是数据库服务器 1433 端口没对你开放直接找运维处理个人电脑上折腾不了。三、第一步在智表里搭「数据字典视图」大屏最终要展示的是业务数据但我们有几十张表、几百个字段先用智表把它们的结构整理成一张「数据字典视图」后续取数会方便很多。3.1 导出数据字典模板打开Excel 客户端进入「系统管理」右键点击公司的数据字典选择导出数据字典模板。3.2 建立内部数据源核心 SQL进入「系统管理 → 内部数据源 → 新增 → 通过 SQL 建立」把下面这段 SQL 粘贴进去。这段 SQL 的作用是从智表自己的系统表里把「每张表有哪些字段、每个字段是什么类型」查出来拼成一张数据字典。SELECTT2.tabIDAStabID,T2.tabNameAS表名,T2.sName2AS表别名,T1.fieldIDAS字段ID,T1.fieldNameAS字段名,T1.sName2AS字段别名,CONCAT(tabDIYTable,CAST(T2.tabIDASvarchar(50)))AS数据库表名,CONCAT(F,CAST(T1.fieldIDASvarchar(50)))AS数据库字段名,T3.TypeIDAS类型ID,T3.TypeNameAS数据类型,T3.OriginTypeAS数据库数据类型,T3.iLenAS数据长度FROMtabDIYTableAST2LEFTJOINtabDIYTableFieldAST1ONT1.tabIDT2.tabIDLEFTJOINtabDataTypeAST3ONT3.TypeIDT1.TypeID3.3 形成数据表保存后系统会生成一张内部数据表起名为数据字典视图。3.4 导入模板并检查相关性点击「系统管理 → 管理操作」下拉框选择导入模板点检查相关性。如果提示「未缺少」说明依赖关系都齐了没问题。3.5 关键一步设置返回值很多人卡在这如果你填了表名、公式也不报错但数据就是不出来八成是没设返回值。操作打开模板 →数据表管理 → …主表 → 右击设置返回值把id设置进去。再点「创建 SQL」复制出来后面 AJ-Report 里要用。我们可以发现这个SQL有问题from后面没有加表。我们可以检查一下公式。看数据库表名是否对照着。还有其他问题的话另一个公式也可看看是不是对应的。之后在生成这样就没问题。四、第二步登录 AJ-Report 创建大屏用公司给的地址登录http://你的服务器IP:端口/index.html#填入用户名和密码。进入后点击报表设计 → 报表管理 → 新增填写报表名称随意比如「生产数据大屏」报表编码必须唯一不能和已有的重复报表类型选大屏报表保存后点更多 → 设计进入大屏设计器。五、第三步配置动态数据源5.1 连接数据库在大屏设计器里点数据源新建连接。数据库一般选SQL Server账号sa密码问人要或在数据中心-数据源里找。点测试成功后点确定。测试通过的条件是AJ-Report 服务器能访问到数据库服务器的 1433 端口。如果超时见文末 FAQ。5.2 配置数据集点击数据集 → 新增选择SQL方式把第 3.5 步复制的 SQL 粘贴进去。数据源选刚才建的编码保持唯一即可名称随意。六、第四步使用大屏组件6.1 滚动表格最常用从文本栏拖一个表格组件到工作区右侧可以设置表头、表体样式。设置字段时宽度 100%表示把表格总宽按字段数平分后的单个宽度点「数据」绑定动态数据源刷新时间1 秒 1000 毫秒图里 30 秒即半分钟刷新一次绑定后如果数据框没出现去「配置」里编辑名字随便取但 Key 值必须和上面数据集返回的 Key 对应这样才能正确映射字段。6.2 大屏背景与图片点大屏空白处可以设置背景颜色也能插入图片。注意图片格式必须是 png其他格式可能不显示。整体刷新可以设 1800 秒30 分钟。6.3 其他组件平台还提供边框、地图、饼图、折线图等组件直接拖拽即可效果如下七、常见问题与排坑FAQ这部分是我实际踩过的坑建议重点看。Q1报SQL 执行结果的字段数量必须跟当前内部数据表的项目数量一致原因你的 SQL 查出来多少列对应的内部数据表就必须有多少个字段两边必须完全对齐。解决数一下内部数据表如「数据字典视图」的字段数把 SQL 的 SELECT 列数改到一致。Q2报列名 ‘tabID’ 无效原始出错信息来自某条取数公式原因公式里引用的字段名tabID但你的 SQL 里已经把它改名成表单ID或别的。解决SQL 返回的字段名 和 公式里引用的字段名必须完全一致。把公式里的tabID改成实际的列名即可。口诀SQL 列名 内部数据表字段名 公式引用名三者统一就不报错。Q3填了表名、不报错但数据不出来原因模板的「返回值」没设置导致上游查不到tabID/表单ID下游字段查询自然为空。解决见 3.5 节去「数据表管理 → 主表 → 设置返回值」把id设进去。Q4AJ-Report 连数据库超时原因数据库服务器 1433 端口没对 AJ-Report 服务器开放常见于内网隔离。解决个人无法处理把报错发给运维让他放行 1433 端口或确认真实端口号不一定是 1433。八、总结整个流程串起来就是业务数据库(SQL Server) ↓ 智表内部数据源(SQL) 暴露成「数据字典视图」 ↓ 导出/导入模板设置返回值 AJ-Report 动态数据源(连接SQL Server) ↓ 数据集(SQL) 大屏组件(表格/图表/地图) → 可视化大屏低代码做大屏的核心难点不在拖组件而在数据源和字段映射——只要 SQL 列名、内部表字段名、公式引用名三处对得上剩下的就是拖拽和美化了。希望这篇能帮你少走弯路。有问题欢迎评论区交流。附录完整数据字典 SQL可直接用SELECTT2.tabIDAStabID,T2.tabNameAS表名,T2.sName2AS表别名,T1.fieldIDAS字段ID,T1.fieldNameAS字段名,T1.sName2AS字段别名,CONCAT(tabDIYTable,CAST(T2.tabIDASvarchar(50)))AS数据库表名,CONCAT(F,CAST(T1.fieldIDASvarchar(50)))AS数据库字段名,T3.TypeIDAS类型ID,T3.TypeNameAS数据类型,T3.OriginTypeAS数据库数据类型,T3.iLenAS数据长度FROMtabDIYTableAST2LEFTJOINtabDIYTableFieldAST1ONT1.tabIDT2.tabIDLEFTJOINtabDataTypeAST3ONT3.TypeIDT1.TypeID