---
title: .rpt 报表元数据
description: .rpt 报表文件阅读入口，指向中国式报表、复杂报表、Excel 风格报表、打印和导出配置的 DTS 说明
navTitle: .rpt
---
# .rpt 报表元数据

报表重点应对中国式报表、复杂报表和 Excel 风格报表，面向固定版式输出、明细和汇总分析、打印、导出、多 sheet 和归档分发等场景。它通常用单元格、合并区域、表格、图表、参数、条件样式、页眉页脚和分页控制组织可查询、可打印、可分发的数据结果，强调版式精度和输出效果。

当输出需要满足中国式报表、复杂表头、交叉明细、合并单元格、套打/打印、Excel 导出、多 sheet 或归档审阅时，应优先考虑报表。如果目标是探索式分析和大屏展示，通常用仪表板（dash）；如果目标是任意低代码页面、业务办理或移动端交互，通常用 SuperPage（spg）；如果目标是周期填报、提交和审批，通常用报表填报应用（fapp）。

rpt 文件遵守 SuccApp Super JSON 规范，参数、数据集、表体、组件树、交互动作、页面设置和资源引用等共同结构由页面基础类型承接；具体组件、数据集、单元格和动作分支继续按对应 DTS 阅读。

## 示例文件{#examples}

- [字段过滤.rpt](https://demo.succbi.com/v5/DEMO/app/whats-new.app/SuccBI/Report/字段过滤.rpt) - 字段过滤报表示例
- [多sheet.rpt](https://demo.succbi.com/v5/DEMO/app/whats-new.app/SuccBI/Report/多sheet.rpt) - 多 sheet 报表示例
- [sum.rpt](https://demo.succbi.com/v5/DEMO/app/exp.app/expfunc/aggregate/sum.rpt) - 表达式函数报表示例

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/rpt.d.ts`](../../../../../dev-types/types/meta/file-types/rpt.d.ts)
- 页面基础结构：[`types/meta/visual-page/visualpage.d.ts`](../../../../../dev-types/types/meta/visual-page/visualpage.d.ts)
- 组件类型：[`types/meta/component/index.d.ts`](../../../../../dev-types/types/meta/component/index.d.ts)
- 数据集类型：[`types/meta/dataset/index.d.ts`](../../../../../dev-types/types/meta/dataset/index.d.ts)
- 动作节点：[`types/meta/actionComponent/index.d.ts`](../../../../../dev-types/types/meta/actionComponent/index.d.ts)
- 布局类型：[`types/meta/componentLayout/index.d.ts`](../../../../../dev-types/types/meta/componentLayout/index.d.ts)
- 单元格类型：[`types/meta/cellType/index.d.ts`](../../../../../dev-types/types/meta/cellType/index.d.ts)
- 原始 BO 类型：[`types/api/succ.bo.d.ts`](../../../../../dev-types/types/api/succ.bo.d.ts)