模块指南稳定能力
报表设计完整指南
报表设计是 DSP 平台核心模块之一，提供与业务对应的配置、设计或运维能力。下文按界面区域说明入口、分步操作与注意事项。 典型场景： 经营报表
报表设计是 DSP 平台核心模块之一，提供与业务对应的配置、设计或运维能力。下文按界面区域说明入口、分步操作与注意事项。 典型场景： 经营报表 完成本页后，你应能够理解功能边界，并按步骤完成配置和验证。
开始前检查
- 已登录 DSP 平台并进入正确组织
- 已选择目标应用和当前开发版本
- 账号拥有当前功能的查看或编辑权限
概述
报表设计是 DSP 平台核心模块之一，提供与业务对应的配置、设计或运维能力。下文按界面区域说明入口、分步操作与注意事项。
典型场景：
- 经营报表
入口与使用前准备
访问入口
| 入口 | 路径 |
|---|---|
| 列表 | /dsp/report/:appCode/reportList |
| 设计 | /dsp/report/design/:appCode/:reportId |
| 预览 | /dsp/report/preview/:id |
使用前准备
数据源就绪。
界面总览
功能分节
报表列表
功能说明：管理报表定义。
操作步骤：
- 新建
- 设计
- 预览
报表设计器
功能说明：配置数据集与图表。
操作步骤：
- 绑定数据
- 布局
- 保存
高级配置
功能说明：高级配置相关能力，详见界面实际 Tab/按钮。
操作步骤：
- 打开对应 Tab 或菜单
- 按界面提示完成配置
- 保存并验证
预期结果：无报错且列表/画布数据刷新。
运维监控
功能说明：运维监控相关能力，详见界面实际 Tab/按钮。
操作步骤：
- 打开对应 Tab 或菜单
- 按界面提示完成配置
- 保存并验证
预期结果：无报错且列表/画布数据刷新。
端到端场景
场景 A：经营报表
数据集→图表→门户挂载
权限与可见性
应用级。
字段与控件说明
字段名称以当前页面显示为准。不同版本或权限下，可选项可能有所差异。
| 字段名称 | 位置 | 用途 | 填写规则 | 可选值 | 影响结果 | 常见错误 |
|---|---|---|---|---|---|---|
| 列表 | 入口 | 打开 /dsp/report/:appCode/reportList | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/report/:appCode/reportList | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 设计 | 入口 | 打开 /dsp/report/design/:appCode/:reportId | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/report/design/:appCode/:reportId | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 预览 | 入口 | 打开 /dsp/report/preview/:id | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/report/preview/:id | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 新增 | 报表列表 | 打开新建弹窗或向导 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开新建弹窗或向导 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 报表列表 | 报表列表 | 管理报表定义。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 管理报表定义。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 保存 | 报表设计器 | 持久化配置 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存，优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 报表设计器 | 报表设计器 | 配置数据集与图表。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 配置数据集与图表。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 保存 | 高级配置 | 持久化配置 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存，优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 高级配置 | 高级配置 | 高级配置相关能力，详见界面实际 Tab/按钮。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 高级配置相关能力，详见界面实际 Tab/按钮。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 保存 | 运维监控 | 持久化配置 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存，优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 运维监控 | 运维监控 | 运维监控相关能力，详见界面实际 Tab/按钮。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 运维监控相关能力，详见界面实际 Tab/按钮。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
完成标准
不要只以“按钮点击成功”作为完成依据，请至少核对以下结果。
- 打开 /dsp/report/:appCode/reportList
- 打开 /dsp/report/design/:appCode/:reportId
- 打开 /dsp/report/preview/:id
- 经营报表
- 保存或提交后页面没有错误提示，刷新后配置仍可正确回显。
常见问题
Q1：预览无数据
现象预览无数据。
原因见处理步骤。
处理检查查询与租户字段
Q2：页面白屏或路由 404
现象页面白屏或路由 404。
原因见处理步骤。
处理检查 /dsp 前缀与路径参数；重新登录。
Q3：无权限 403
现象无权限 403。
原因见处理步骤。
处理权限管理分配角色资源后重新登录。
Q4：保存或提交失败
现象保存或提交失败。
原因见处理步骤。
处理F12 查看接口 message；补全必填项。
Q5：列表无数据
现象列表无数据。
原因见处理步骤。
处理确认后端服务与租户；点击刷新。
Q6：菜单无入口
现象菜单无入口。
原因见处理步骤。
处理getMyMenuTree 资源配置。
截图与文档不一致
处理检查前置条件、权限与当前配置，修正后重新执行。