用途:编写、校验、发布并测试 Power BI 分页报表(.rdl 格式)。分页报表是打印忠实、多页的固定格式文档(发票、对账单、运营清单、监管申报),由单个可手工编辑的 XML 定义,数据源、数据集、参数、页面设置、布局与表达式全部内含。Power BI Report Builder 是同一 XML 的 Windows 图形界面,因此可由编码代理直接编辑该文件。若用户想要交互式屏幕优先报表(PBIR),应改用 reports:create-pbi-report。
主要能力:提供 RDL 格式及其约定规则、数据连接方式、渲染特性与开发循环;附三份起步模板(enter-data-starter.rdl、semantic-model-starter.rdl、sql-starter.rdl)与 .platform 边车模板;校验脚本 validate_rdl.py(仅标准库,跨平台,检查 XML 良构性、2016 根命名空间、ReportID GUID、顶层元素顺序、Name 唯一性、tablix 不变量、引用与单位后缀);发布脚本 publish_rdl.sh / .ps1(经 Power BI Imports API 上传并轮询,自动判断 Abort/Overwrite);导出脚本 export_rdl.sh / .ps1(触发导出 PDF/XLSX 等、轮询并下载,可经 PBI_PARAMS 传参数)。
使用方式:先按 references/questionnaire.md 做需求访谈,确定目的、数据源、目标工作区与容量;再选模板,在离线 Enter Data 数据集上迭代布局;每处结构编辑后运行 python3 scripts/validate_rdl.py report.rdl;接入真实数据源后再次校验;用脚本发布到工作区;最后必须导出并打开 PDF 确认内容非空且正确。校验通过不是完成标准——它不检查表达式、字段引用与 DAX,只有真实渲染才是硬门槛。
适用场景:需要打印忠实、分页、可导出 PDF/Excel 的固定格式报表。
限制:属于 Power BI 服务/Fabric,不是经典 SSRS(格式相同但环境不同);发布与渲染需要 Premium/Embedded/Fabric 容量上的工作区;服务不支持共享 .rds/.rsd;预览经 HTML 渲染器,与 PDF 结果不同;语义模型列返回原生类型、度量返回 System.String;TREATAS 单值参数较稳健,多选需 RSCustomDaxFilter;参考文件中的 SSRS 差异、渲染器、数据结构等细节需查阅对应文档。