---
title: 做报表
navTitle: 做报表
---
# 做报表

“做报表”通常指创建或修改统计表、明细表、打印报表、导出报表或报表参数。AI 可以辅助生成结构和检查引用，但报表效果必须在产品中预览和验证。

## 阅读顺序{#reading-order}

1. 先读 [SuccApp 官方文档 Skill](../../../../SKILL.md) 中的 AI 低代码开发说明和[工作区中的 AI 协作文件](../basics/workspace.md#ai-files)，确认目标、环境、范围、禁区和验收方式。
2. 再读[元数据系统](../../meta/README.md)、[报表文件类型](../../meta/file-types/ana/rpt.md)和 [SuccApp Super JSON](../../meta/rules/super-json.md)。
3. 涉及取数时补充阅读[数据模型](../../meta/file-types/data/tbl.md)和[查询](../../meta/file-types/data/query.md)，并参考当前项目同类报表、参数和单元格配置。
4. 修改后检查报表预览、打印、导出、参数切换和引用关系，必要时按[产品验证](../quality/product-verification.md)和[Diff 审查](../quality/diff-review.md)验证。

## 常见文件{#files}

| 文件 | 用途 |
| --- | --- |
| `.rpt` | 报表。 |
| `.tbl` | 数据模型。 |
| `.query` | 查询或数据准备。 |
| `.spg` | 报表入口页或嵌入页面。 |
| `.ts`、`.action.ts` | 报表相关脚本。 |

## AI 修改前{#before}

明确告诉 AI：

1. 报表用途，是展示、打印还是导出。
2. 数据来源、统计口径、字段排序和分组方式。
3. 参数、过滤条件和默认值。
4. 是否允许修改模型或查询。
5. 需要验证的输出方式，例如网页预览、打印或 Excel 导出。

## 推荐流程{#workflow}

1. 让 AI 查找同类报表和数据模型。
2. 确认字段、参数、单元格区域和引用关系。
3. 小步修改 `.rpt`、`.tbl` 或 `.query`。
4. 检查 DTS、同类文件差异和元数据静态结构。
5. 推送测试服务器并预览报表。
6. 验证打印、导出、参数切换和权限数据范围。

## 验证重点{#validation}

1. 报表能打开并渲染。
2. 参数默认值和查询条件正确。
3. 分组、合计、排序和格式符合业务口径。
4. 打印和导出效果符合要求。
5. 大数据量场景下查询性能可接受。