数据集
数据集用于把表单数据整理成图表可以使用的数据来源。你可以先选择一个主表单，再按需要关联其他表单、添加计算字段，并把字段整理成维度或指标。
新建数据集
- 点击右上角 新建数据集
- 填写 名称
- 按需要填写 描述
- 点击 创建
创建后，数据集会出现在列表中。双击数据集行进入配置页面。
配置页面说明
数据集配置页面顶部提供：
| 操作 | 说明 |
|---|---|
| 返回 | 退出配置页面；如果有未保存内容，会提示确认离开 |
| 保存 | 保存当前配置；没有修改时不可点击 |
| 删除 | 删除当前数据集；删除前会先确认，并检查当前数据集是否正在被图表使用；如果已被图表使用，继续删除会同时删除使用该数据集的图表 |
左侧有两个配置区：
| 配置区 | 用途 |
|---|---|
| 数据集属性 | 修改名称、描述、来源类型，并配置主表和关联数据 |
| 字段与元数据 | 管理字段名称、维度/指标、聚合方式和启用状态 |
选择主表单
- 在左侧选择 数据集属性
- 在中间区域的 数据 中选择主表单
- 选择后，系统会读取该表单字段，生成数据集字段
- 点击预览按钮，可以查看主表单数据是否正确
主表单是数据集的基础。后续图表统计会以主表单数据作为主要分析对象。
注意：切换主表单会清空已配置的关联数据和计算字段，需要重新配置。
添加关联数据
当分析需要使用多个表单的数据时，可以添加关联数据。
- 先选择主表单
- 点击 关联数据 图标
- 在关联行中选择左侧来源
- 选择连接类型
- 选择要关联的表单
- 设置关联条件，例如
客户 ID = 记录 ID - 条件完整后，可以点击预览按钮检查关联结果
一条关联数据由以下配置组成：
| 配置项 | 说明 |
|---|---|
| 左侧来源 | 可以选择主表单，也可以选择前面已经关联过的表单 |
| 连接类型 | 决定哪些记录会保留下来 |
| 关联表单 | 当前要追加进数据集的表单 |
| 关联条件 | 用 左字段 = 右字段 表示两张表如何匹配 |
连接类型说明
| 类型 | 保留哪些数据 | 适合场景 |
|---|---|---|
| 左连接 | 保留左侧来源的全部记录；右侧表单匹配不到时，右侧字段为空 | 以主表为准做分析，例如“所有订单及其客户信息” |
| 内连接 | 只保留左右两侧都能匹配上的记录 | 只分析有关联关系的数据，例如“已绑定客户的订单” |
| 右连接 | 保留右侧表单的全部记录；左侧来源匹配不到时，左侧字段为空 | 以关联表为准做分析，例如“所有客户及其订单信息” |
| 全连接 | 左右两侧记录都会保留；匹配不到的一侧字段为空 | 对账或排查缺失关系，例如“订单和回款是否都能匹配” |
一般情况下，如果你希望图表仍然以主表单为主，优先选择 左连接。
关联条件说明
关联条件用于告诉系统两张表如何匹配。
| 左字段 | 右字段 | 含义 |
|---|---|---|
| 客户 | 记录 ID | 当前表单中的客户字段，匹配客户表中的记录 |
| 订单编号 | 订单编号 | 两张表使用同一个业务编号匹配 |
| 记录 ID | 订单 | 右侧表单中有一个订单关联字段，指向左侧记录 |
可以添加多组条件。多组条件会同时生效，只有全部条件都匹配的记录才会被关联。
如果表单字段中已经配置过关联关系，选择关联表单后，系统会尝试自动填充关联条件。仍建议使用预览确认结果。
添加计算字段
当现有字段不能直接满足分析需要时，可以添加计算字段。
- 在 数据集属性 中点击 自定义列 图标
- 填写字段名称
- 选择数据类型
- 选择值来源
- 配置表达式或脚本
- 保存计算字段
计算字段会作为新的字段出现在数据集中，后续可以在 字段与元数据 中设置为维度或指标。
| 配置项 | 说明 |
|---|---|
| 字段名称 | 图表中展示的字段名称 |
| 数据类型 | 计算结果的数据类型，例如数字、文本、日期、日期时间或布尔值 |
| 值来源 | 决定这个字段的值由表达式计算，还是由图表绑定脚本写入 |
值来源
值来源 是一个下拉选择，用来决定计算字段的取值方式。
下拉选项包括：
- 表达式：在数据集内根据主表单和关联表单字段直接计算。适合金额、时长、状态判断等规则固定的字段，数据预览时可以看到计算结果
- 自定义脚本：在数据集中先定义字段，实际数值由图表中的绑定脚本返回并写入。适合需要调用 Studio 脚本、使用复杂逻辑或外部计算结果的指标
使用表达式
选择 表达式 后，可以从当前数据集字段中插入字段，并组合函数或运算符生成结果。
常见示例：
| 场景 | 示例 |
|---|---|
| 金额计算 | 实际金额 = 订单金额 - 优惠金额 |
| 时间计算 | 处理时长 = 完成时间 - 创建时间 |
| 状态判断 | 是否逾期 = 截止时间早于当前时间 |
表达式适合直接从当前行数据推导结果。配置后，可以通过数据预览检查计算值是否符合预期。
使用自定义脚本
选择 自定义脚本 后，数据集会保存一个脚本型计算字段。这个字段本身不在数据集预览中直接计算，而是在图表查询时由图表的 绑定脚本 写入结果。
保存数据集后，需要在图表中配置绑定脚本，才能把脚本返回结果写入这个计算字段。具体操作请查看 图表 - 绑定脚本。
自定义脚本型计算字段常用于：
| 场景 | 说明 |
|---|---|
| 外部指标 | 从外部服务或脚本计算结果中补充指标 |
| 复杂规则 | 使用表达式不方便维护的多步骤计算 |
| 图表后处理 | 基于图表已聚合数据再次计算目标值、达成率或预测值 |
字段与元数据
选择左侧 字段与元数据 后，可以管理数据集字段。
| 列名 | 说明 |
|---|---|
| 源字段 | 字段来自哪个表单、原始字段名和 API Name |
| 语义名称 | 图表中展示的字段名称，可直接修改 |
| 身份 | 字段作为维度或指标使用 |
| 聚合方式 | 指标字段的统计方式 |
| 状态 | 是否在数据集中启用该字段 |
维度和指标
| 身份 | 说明 | 示例 |
|---|---|---|
| 维度 | 用于分组、分类、筛选 | 客户类型、城市、负责人、创建月份 |
| 指标 | 用于统计数值结果 | 订单金额、订单数量、处理时长 |
切换字段身份后，系统会自动调整默认聚合方式。
聚合方式
| 聚合方式 | 说明 | 常见用法 |
|---|---|---|
| 求和 | 把数值相加 | 订单金额、回款金额 |
| 平均 | 计算平均值 | 平均处理时长、平均评分 |
| 计数 | 统计记录数量 | 订单数、工单数 |
| 去重计数 | 去重后统计数量 | 客户数、负责人数量 |
| 最大值 | 取最大值 | 最高金额、最长耗时 |
| 最小值 | 取最小值 | 最低金额、最短耗时 |
数字字段可以使用全部聚合方式。非数字字段通常只能使用计数和去重计数。
字段状态
字段状态用于控制字段是否参与后续图表配置。
| 状态 | 说明 |
|---|---|
| 启用 | 字段可以在图表中使用 |
| 隐藏 | 字段保留在数据集中，但不作为常用分析字段展示 |
如果来源表单字段被删除或变更，数据集中可能出现失效字段。失效字段可以重新绑定到同类型字段，也可以批量删除。
数据预览
配置主表、关联数据或计算字段后，建议点击预览检查结果。
重点检查：
- 主表数据是否正确
- 关联数据是否匹配到预期记录
- 连接类型是否导致记录变多或变少
- 计算字段结果是否正确
- 字段名称是否适合给业务人员阅读
确认无误后点击 保存。