本文以销售明细导出为例，讲解 VeryReport 自助取数：选数据集、拖字段、设筛选、预览 50 行、异步下载全量文件。对标 Quick BI 自助取数，无需 SQL。
范围说明：本文介绍「数据分析」下的自助取数（resourceType=EXTRACT，路由/analysis/extract）：业务人员无需写 SQL，通过拖拽字段导出 Excel/CSV。这与复杂报表（.vrp 电子表格设计）及仪表板（可视化看板）是不同模块。能力规划见《自助取数设计》文档。
1. 概述
自助取数让业务人员自主提取数据，减少对研发的依赖。任务定义存于 bi_extract.definition_json，预览与导出由后端根据行列字段自动生成 SQL（支持聚合与明细两种模式）。
| 阶段 | 说明 | 入口 |
|---|---|---|
| 准备数据集 | 含维度与度量的业务数据集 | 数据中心 → 数据集 |
| 新建取数 | 创建取数任务 | 自助取数 → 新建 |
| 配置字段 | 行/列/过滤器 + 预览 | 取数编辑器 |
| 下载导出 | 异步生成 Excel/CSV | 更多 → 下载 / 任务列表 |
1.1 预期效果
- 行维度为「区域」，列度量为「订单金额」求和；
- 过滤「订单金额 > 0」；
- 中间预览表展示前 50 行；
- 下载任务完成后获得 Excel 文件。
2. 制作步骤
2.1 准备数据集
- 在 数据中心 → 数据集 准备 JDBC 数据集（支持 MySQL、Oracle、SQL Server 等；不支持 API 跨源数据集）。
- 确认含维度字段（如区域、订单日期）与度量字段（如订单金额）。
2.2 新建取数任务
- 进入 数据分析 → 自助取数（
/analysis/extract）。 - 点击 ＋ 新建 → 自助取数，系统自动命名并进入取数编辑器（
/analysis/extract/editor/:extractId）。 - 顶部可双击修改任务名称，如「销售明细导出」。
2.3 选择数据集与配置字段
编辑器为四列布局：数据面板｜字段配置｜预览画布｜右侧任务/页面设置。
- 第 1 列 · 数据：选择数据集「销售明细」；左侧列出维度/度量字段。
- 第 2 列 · 字段：
- 将「区域」拖入行区（维度）；
- 将「订单金额」拖入列区（度量），设置聚合为「求和」；
- 在过滤器中添加：订单金额 > 0；
- 模式选聚合（默认）；若需原始明细行可切换明细。
- 点击蓝色 更新 或等待自动刷新，中间预览表显示结果（最多 50 行）。
字段 Tag 可排序、右键设置显示名、日期格式、对齐、排序方式等。
2.4 页面设置（可选）
- 右侧 页面设置 Tab：配置标题「销售数据取数」、备注说明。
- 可开启显示字段选择（下载时勾选列）、显示查询控件（预览页顶部日期/下拉筛选）、记住查询条件。
2.5 保存
- 点击顶部 保存，definition 写入
bi_extract并同步资源树名称。 - 支持撤销/重做（⌘Z）、锁定画布防误触。
3. 下载导出
- 点击顶部 ⋮ 更多 → 下载（或工具栏下载入口）。
- 输入下载任务名，选择格式：
| 格式 | 说明 |
|---|---|
| EXCEL_RAW / EXCEL_FORMAT | Excel，后者带数字/日期格式 |
| CSV_RAW / CSV_FORMAT | CSV，UTF-8 带 BOM |
- 系统创建异步下载任务（status：PENDING → GENERATING → COMPLETED）。
- 在右侧 任务列表 或管理页预览区查看进度，完成后点击下载文件。
- 文件默认保留 7 天（可在系统设置调整），过期自动清理。
4. 权限与边界
| 权限点 | 能力 |
|---|---|
| analysis:extract:view | 查看与预览 |
| analysis:extract:create | 新建 |
| analysis:extract:edit | 编辑定义 |
| analysis:extract:download | 创建下载任务 |