Skip to content

conch-report 接入文档把报表嵌进你们自己的系统

一个 iframe,一条链接。不引包、不改构建、宿主是什么语言都行。

conch-report

它是什么

conch-report 是独立部署的报表服务:业务人员用对话把报表做出来、发布,宿主系统把发布好的报表嵌进自己的页面给人看。

这份文档只讲后半截——怎么嵌。做报表本身在报表服务自己的界面里完成,不需要宿主参与。

查看态和设计器的区别

同一套渲染,两个入口。宿主要嵌的永远是查看态。

设计器 ?id=xxx查看态 ?id=xxx&view=1
给谁用做报表的人看报表的人
界面对话面板、属性面板、草稿与发布按钮只有筛选栏和画布
内容当前草稿,边改边看已发布的版本
改报表不能
筛选、穿透明细、导出

接入要准备什么

  1. 报表服务的地址,例如 https://report.example.com
  2. 要嵌的报表 id:在报表列表页每行点「嵌入」就能拿到整条链接和一段 iframe 代码。
  3. 这张报表已经发布过。没发布的报表嵌出去只会显示一句「还没有发布」。

剩下的看五分钟接入

现在还不支持什么

说在前面,免得你们按错误的预期去设计:

  • 查看页没有自己的登录页。这一版靠部署位置控访问(放在内网,或由宿主反向代理并在代理上鉴权)。按 JWT 换票把宿主登录态带进来的能力在路线上,还没上线。
  • 不支持让数据请求绕道宿主网关。报表服务直连数据库取数,浏览器只跟报表服务说话。
  • 数据源只支持 SQL Server、MySQL、PostgreSQL
  • 小程序 web-view 只能用链接参数,收不到也发不了 postMessage,详见常见问题

给 AI 用的纯文本索引在 /llms.txt,每篇原文在 /md/ 下。