帆软报表开发学习

以 **普通报表 + SQL 数据集 + 参数查询 + 图表 + 明细表** 的方式一步一步去做，这样最适合初学者。

---

# 一、先明确你要做什么报表

我们先做一个最适合入门的案例：

## 案例名称
**月度销售统计报表**

## 功能要求
- 可以选择开始日期和结束日期
- 展示每个月销售额
- 展示销售明细
- 支持导出 Excel
- 支持预览

---

# 二、设计前准备

在打开帆软设计器之前，先准备好：

1. 一台已安装好的帆软设计器
2. 一个数据库连接
3. 一张销售订单表

## 示例表字段
- 订单号
- 订单日期
- 客户名称
- 销售员
- 产品名称
- 数量
- 单价
- 金额

如果你现在还没有真实数据库，也可以先用测试表练习。

---

# 三、帆软报表设计步骤

---

## 第 1 步：新建普通报表

### 操作路径
- 打开帆软设计器
- 在左上角点击 **新建**
- 选择 **普通报表**

### 你会看到什么
- 一个空白报表页面
- 默认有若干单元格区域
- 左侧通常是资源树或目录
- 右侧通常是属性面板

### 这一步的目标
先创建一个可以编辑的报表模板。

---

## 第 2 步：设置报表名称

### 操作
- 点击报表空白区域
- 在属性面板里找到报表名称
- 输入名称，例如：
  - 月度销售统计报表

### 建议
报表名称尽量清晰，便于后期维护。

---

## 第 3 步：配置数据库连接

### 操作路径
- 打开 **模板数据**
- 进入 **数据连接**
- 点击 **新增数据连接**

### 填写内容
- 数据库类型：MySQL、Oracle、SQL Server 等
- 主机地址
- 端口
- 数据库名
- 用户名
- 密码

### 操作后
- 点击 **测试连接**
- 连接成功后保存

### 这一步的目标
让报表能从数据库中取数。

---

## 第 4 步：新建 SQL 数据集

### 操作路径
- 在数据集区域点击 **新增数据集**
- 选择 **SQL 数据集**

### 命名建议
例如：
- ds_sales_month
- ds_sales_detail

### 示例 SQL 思路
先做一个按日期查询的订单明细数据集。

```sql
select
  order_no,
  order_date,
  customer_name,
  sales_name,
  product_name,
  quantity,
  unit_price,
  amount
from sales_order
where order_date between ? and ?
```

### 说明
这里的 `?` 是参数占位符，后面会绑定开始日期和结束日期。

---

## 第 5 步：创建查询参数

### 操作路径
- 进入 **参数管理**
- 点击 **新增参数**

### 建议创建两个参数
1. 开始日期
2. 结束日期

### 参数设置建议
- 参数名称：start_date
- 参数名称：end_date
- 参数类型：日期

### 这一步的目标
让用户可以在页面上选择查询范围。

---

## 第 6 步：绑定参数到 SQL

### 操作
回到刚才的 SQL 数据集，把 `?` 对应参数绑定为：
- 第一个问号绑定 start_date
- 第二个问号绑定 end_date

### 提示
不同版本的帆软界面可能略有差异，但核心就是：
- 参数定义
- 参数引用
- 参数映射

---

## 第 7 步：设计参数面板

### 操作路径
- 在报表上方预留一行
- 放置两个日期控件
- 一个“查询”按钮

### 页面布局建议
最上方放：
- 开始日期
- 结束日期
- 查询按钮

### 作用
用户选择条件后点击查询，报表刷新。

---

## 第 8 步：插入表格区域

### 操作
- 选中报表中的一个单元格区域
- 设置为表格样式
- 预留列数

### 推荐列
- 订单号
- 订单日期
- 客户名称
- 销售员
- 产品名称
- 数量
- 单价
- 金额

### 这一步的目标
给明细数据预留展示位置。

---

## 第 9 步：绑定数据到单元格

### 操作方法
- 点击某个单元格
- 在属性中选择数据字段
- 将字段拖入对应单元格

### 对应关系示例
- 第一列：order_no
- 第二列：order_date
- 第三列：customer_name
- 第四列：sales_name
- 第五列：product_name
- 第六列：quantity
- 第七列：unit_price
- 第八列：amount

### 结果
报表预览时会自动按行展示数据。

---

## 第 10 步：设置表头

### 操作
在明细表上方一行写表头文字：
- 订单号
- 订单日期
- 客户名称
- 销售员
- 产品名称
- 数量
- 单价
- 金额

### 建议格式
- 加粗
- 居中
- 背景色浅灰
- 边框清晰

---

## 第 11 步：设置数字格式

### 操作
选中金额列和单价列

### 设置格式
- 金额：保留两位小数
- 单价：保留两位小数
- 数量：整数或一位小数

### 目的
让报表更专业、更易读。

---

## 第 12 步：设置合计行

### 操作
在表格底部新增一行

### 合计字段
- 数量合计
- 金额合计

### 示例
- 数量列使用求和
- 金额列使用求和

### 效果
让报表直接看到总销售情况。

---

## 第 13 步：插入图表

### 操作路径
- 在报表空白区域插入图表
- 选择柱状图或折线图

### 建议做法
做一个“月度销售趋势图”

### 数据来源
再建一个聚合数据集，例如：

```sql
select
  date_format(order_date, '%Y-%m') as month,
  sum(amount) as total_amount
from sales_order
where order_date between ? and ?
group by date_format(order_date, '%Y-%m')
order by month
```

### 图表绑定方式
- 横轴：month
- 数值：total_amount

---

## 第 14 步：设置图表样式

### 建议
- 标题：月度销售趋势
- 柱状图颜色统一
- 显示数据标签
- 图例简洁

### 目的
让图表一眼看懂。

---

## 第 15 步：设置报表边距和布局

### 操作
- 调整表格和图表的位置
- 让参数区在顶部
- 图表在中间
- 明细表在下方

### 建议结构
1. 顶部：查询条件
2. 中部：图表
3. 下部：明细表

---

## 第 16 步：添加标题

### 标题示例
**月度销售统计分析报表**

### 格式建议
- 字号大一些
- 居中
- 加粗
- 可加企业名称

---

## 第 17 步：配置查询按钮

### 操作
- 选择查询按钮
- 设置点击后执行刷新
- 让参数传入数据集

### 作用
用户改条件后可以重新查询。

---

## 第 18 步：预览报表

### 操作
- 点击 **预览**
- 选择测试日期范围
- 查看图表和表格是否正常显示

### 重点检查
- 数据是否能查出来
- 日期参数是否生效
- 格式是否正确
- 图表是否正常渲染

---

## 第 19 步：导出测试

### 操作
- 预览页面中点击导出
- 选择 Excel 或 PDF

### 检查
- 表头是否正确
- 数据是否完整
- 合计是否保留
- 格式是否错乱

---

## 第 20 步：保存报表

### 操作
- 点击保存
- 输入文件名
- 保存到指定目录或服务器

### 建议命名
- sales_month_report.cpt

---

# 四、你在界面里可以这样理解各区域

## 1. 左侧
通常是：
- 资源树
- 数据集
- 参数
- 图表组件

## 2. 中间
是报表设计画布

## 3. 右侧
是属性设置区

### 你常用的属性
- 字体
- 对齐方式
- 边框
- 背景色
- 数据绑定
- 公式设置

---

# 五、一个完整的实操顺序

你可以直接照这个顺序练：

1. 新建普通报表
2. 配置数据库连接
3. 建 SQL 数据集
4. 建开始日期、结束日期参数
5. 设计顶部查询区
6. 放置标题
7. 放置图表
8. 放置明细表
9. 设置字段绑定
10. 设置样式和格式
11. 配置查询按钮
12. 预览测试
13. 导出检查
14. 保存报表

---

# 六、初学者最容易出错的地方

## 1. 参数未绑定
表现：
- 查询后没数据

解决：
- 检查参数名
- 检查 SQL 占位符顺序

---

## 2. 日期格式不一致
表现：
- 日期条件查询不到数据

解决：
- 统一数据库日期格式
- 统一控件类型为日期

---

## 3. 金额显示为科学计数法
表现：
- 数字不美观

解决：
- 设置数字格式，保留两位小数

---

## 4. 图表无数据
表现：
- 图表空白

解决：
- 检查聚合 SQL
- 检查横轴和数值字段绑定

---

## 5. 合计行错误
表现：
- 汇总不对

解决：
- 确认使用求和公式
- 检查是否重复汇总

---

# 七、建议你边学边做的练习

## 练习 1
做一个只有明细表的报表

内容：
- 订单号
- 日期
- 客户
- 金额

目标：
熟悉数据绑定

---

## 练习 2
在练习 1 基础上增加参数

内容：
- 开始日期
- 结束日期

目标：
熟悉查询参数

---

## 练习 3
在练习 2 基础上增加图表

内容：
- 月度销售趋势图

目标：
熟悉图表绑定

---

## 练习 4
在练习 3 基础上增加合计和样式

目标：
熟悉报表美化

---

# 八、给你的一个最简实战模板

你可以把它理解成一个标准报表骨架：

- 顶部：标题
- 顶部第二行：查询条件
- 中间：图表
- 下方：明细表
- 底部：合计行