## 📈 使用报表查看器

在网页版打开任意命名报表，跟着下面的步骤设置日期范围，再在查看器工具栏打印、导出或发邮件。

### 📝 操作步骤

1. 在**网页版**打开侧栏 **报表**。原生收银端没有此菜单 — 若要在 POS/平板把报表打到小票机，请用 **系统管理 → 报表 页签** 代替。
2. 选择 **报表分类**，再选择 **报表名称**。选定分类后会自动选中该分类下的第一份报表。你只能看到当前账号有权查看的分类和报表。
3. 点击 **开始时间** 字段，打开选择器。
4. 在日历里选择日期。
5. 从 30 分钟为步进的时间列表里选择时间，或直接按 `yyyy-MM-dd HH:mm` 格式输入。
6. 点击 **结束时间** 字段，用同样方式设置 — 日历选日期，时间列表选时间或按 `yyyy-MM-dd HH:mm` 输入。默认范围是当天 **00:00** 到 **23:59**。
7. 等待预览自动刷新。如果没有自动更新，点击工具栏的 **Refresh** 按钮。
8. 要下载 PDF，点击工具栏的 **Export** 按钮，选择 **PDF**。
9. 要下载 Excel 文件，再次点击 **Export**，改选 **XLSX (Excel)**。浏览器下载栏会显示这个文件。
10. 要打印，点击工具栏的 **Print** 按钮，打开打印预览 / 浏览器打印对话框。
11. 要发送邮件，点击 **Send Email**。在 **To** 中填收件人，可选填 **CC**，**From** 保持预填的 no-reply@posx.ai 不动，检查 **Subject**（预填为 `{公司名称}-{报表名称}`），选择 **Format**（PDF 或 XLSX），然后点击 **Send**。
12. 若 **To** 为空或格式不对，对话框会提示 "Email field is required" 或 "Email format is not valid" — 改正后再次点击 **Send**。
13. 若必填参数为空，应用会提示"请填写所有必填参数后再生成报表" — 补全 **开始时间** 和 **结束时间** 后重试。
14. 留意这些提示：出现"报表已过期，正在刷新"表示会话正在自动刷新，等它完成即可；出现"报表服务器暂时不可用，请稍后再试"或"网络错误，请检查网络连接后重试"，请稍后再试；出现"报表加载失败，请重新进入页面"，请关闭并重新打开页面。

> **💡 提示:** **报表** 仅网页版提供，不要在原生收银端找这个菜单。会话过期时等自动刷新完成，不必立刻关页。只要看屏幕图表、不需要文件时，请用 **数据分析** — 那个仪表板不能导出。

---

## 🎬 视频教程

[观看演示视频](https://support.agenteehq.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaXdEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9302a8f464b759ca57c9087b48694b899cb085dd/use-the-report-viewer-CN.mp4)