图表

图表用于把数据集中的维度和指标展示成可视化结果。创建图表前，需要先准备至少一个可用数据集。

新建图表

进入 可视化
点击右上角创建，选择图表
在 选择数据集 弹窗中选择一个数据集
进入图表编辑器
配置图表类型、字段、筛选条件和显示样式
点击保存
填写图表名称，选择保存文件夹
点击保存完成创建

如果当前没有可用数据集，系统会提示先准备可用数据集后再创建图表。

图表列表操作

图表列表中可以查看图表、文件夹和更新时间。

操作	说明
打开	进入图表编辑器
移动	将图表移动到指定文件夹或根目录
删除	删除图表；删除前会弹出确认提示，删除后不可恢复

双击图表行也可以打开图表。双击文件夹行会展开或收起文件夹。

文件夹

文件夹用于整理图表。

操作	说明
新建文件夹	点击创建 > 文件夹，填写文件夹名称后创建
移动图表	在图表操作中选择移动，选择目标文件夹后保存
删除文件夹	删除前需要选择如何处理文件夹下的图表

删除文件夹时，可以选择：

处理方式	说明
保留图表，并移动到指定文件夹	删除文件夹本身，文件夹下的图表会移动到选择的目标文件夹或根目录
同时删除文件夹下全部图表	删除文件夹，并同时删除文件夹下的图表

编辑器说明

图表编辑器顶部提供：

操作	说明
返回	退出图表编辑器
查看数据	将右侧预览切换为数据表
查看图表	将右侧预览切换回图表
保存	保存当前图表配置

左侧有四个配置区：

配置区	用途
数据配置	查看当前数据集字段，并选择图表类型
视觉配置	配置字段槽位、筛选条件、数据限制和显示样式
绑定脚本	选择 Studio 脚本，将脚本结果写入脚本型计算字段
权限信息	配置当前图表的查看、编辑、删除主体权限

右侧是预览区。配置维度和指标后，预览区会显示图表结果；切换到数据表后，可以查看图表查询返回的数据明细。

选择图表类型

在 数据配置 中，可以选择图表类型。

图表类型	适合场景
柱状图	对比不同分类的数值，例如各部门销售额
堆叠柱状图	查看总量和组成，例如各地区不同产品销售额
条形图	分类名称较长，或需要横向比较时使用
瀑布图	展示数值如何逐步增减形成最终结果
折线图	查看趋势变化，例如月度订单量
堆叠折线图	查看多组趋势及其叠加关系
面积图	强调趋势变化和数值规模
平滑折线图	趋势变化较连续时使用
阶梯折线图	数值按阶段变化时使用
饼图	查看各分类占比
环形图	查看占比，并保留中心展示空间
玫瑰图	强调分类占比差异
散点图	查看两个指标之间的关系
气泡散点图	在散点图基础上增加气泡大小指标
指标卡	展示单个核心指标
雷达图	对比多个指标维度
漏斗图	展示流程转化，例如线索到成交
金字塔图	展示层级或阶段分布
仪表盘	展示当前值和目标值的达成情况
报表	展示从数据集字段中选择出的明细行

切换图表类型后，系统会根据新类型调整可用字段槽位。

配置字段槽位

在 数据配置 中，把数据集字段放入对应槽位。槽位会根据图表类型变化。

图表类型	需要配置的字段
柱状图、折线图	X 轴维度、颜色分组、Y 轴指标
饼图、漏斗图	分类维度、分类颜色、指标
散点图	X 轴指标、Y 轴指标、气泡大小、分类颜色、粒度明细
指标卡	指标
雷达图	分类维度、对比指标
仪表盘	当前指标、目标指标
报表	报表字段；维度和指标都可以选择

字段分为两类：

字段类型	用途
维度	用于分类、分组、横轴、颜色或筛选
指标	用于数值展示、纵轴、大小或核心指标

如果某个槽位提示只能放入 1 个字段，就只能选择一个字段；如果提示支持多个指标，可以选择多个指标一起展示。

对于支持排序的槽位，例如 Y 轴指标 和 报表字段，可以上下拖拽已选字段，调整显示顺序。在报表中，右键已选报表字段，选择 合并项，可以把该列中相邻且值相同的行合并显示；选择 取消合并项 后，会恢复为每行单独展示。

报表

当需要展示明细表格，而不是聚合图形时，可以选择报表。

在 数据配置 中选择报表
在 数据配置 中，把字段加入 报表字段
拖拽已选报表字段，调整表格列顺序
按需要添加筛选条件，限制展示数据范围
配置基础记录数，控制查询的明细行范围
保存报表

报表默认使用表格预览。它查询的是数据集明细行，已选字段会作为表格列展示，不再作为图表坐标轴或指标聚合展示。

操作	说明
添加字段	从数据集字段选择器中选择维度或指标
调整列顺序	上下拖拽已选报表字段，改变表格列顺序
合并项	右键已选报表字段，选择合并项，合并该列中相邻且值相同的行
取消合并项	右键已合并字段，选择取消合并项，恢复为每行单独展示
导出数据表	在权限允许时导出当前报表表格

筛选条件

在 数据配置 中，可以添加筛选条件，并保存为一个或多个筛选组。筛选组适合把常用查询口径沉淀到图表里，例如“审批中”“未审批”“本月”“重点区域”等。

点击 添加筛选条件
选择数据集字段
设置条件和值
保存筛选
输入筛选名称

筛选条件会影响当前图表的查询结果。已保存的筛选组显示在左侧筛选列表中，也会显示在右侧图表标题旁边。点击右侧图表上方的筛选组，可以在多个筛选组之间切换，预览会按当前选中的筛选组重新查询。

操作	说明
拖拽筛选组	调整左侧筛选列表中的筛选组顺序
编辑	打开筛选弹窗，编辑筛选组名称和正式筛选条件
弹窗中删除	从当前图表中删除这个筛选组
锁定	筛选组使用保存时的条件，图表上方不可临时修改
解锁	允许在图表上方临时编辑这个筛选组

每个筛选组都有独立的锁定状态。左侧筛选列表和图表上方筛选组都会显示锁定图标：红色锁表示 锁定筛选组，绿色解锁表示 解锁筛选组。

当筛选组处于锁定状态时，图表上方只允许切换筛选组，不能临时修改条件。适合用于标准口径、需要固定展示的图表。

当筛选组处于解锁状态时，可以在图表上方右键这个筛选组，选择 编辑筛选，在弹窗中临时调整条件，然后点击 应用筛选。临时筛选只影响当前预览，不会覆盖左侧保存的正式筛选条件，也不会随图表保存写入数据库。刷新页面或重新打开图表后，会恢复为已保存的筛选条件。

如果需要把临时调整变成图表的正式筛选条件，请回到左侧筛选列表，点击编辑按钮，在弹窗中调整并保存。

数据限制

在 数据配置 中，可以设置基础记录数。

配置项	说明
按更新时间	先按最近更新时间取基础记录，再执行聚合查询
按创建时间	先按最近创建时间取基础记录，再执行聚合查询
基础记录数	控制参与聚合查询的基础记录范围

当数据量较大时，可以通过基础记录数控制查询范围，提升预览和加载速度。

下钻分析

柱状图、折线图、饼图和漏斗图支持下钻分析。

先配置主维度，例如 X 轴维度或分类维度
开启 下钻分析
选择下钻维度
在预览图表中点击分类项，进入下一层维度

下钻维度不能和主维度重复。适合从总览逐层查看明细，例如从地区下钻到城市，再下钻到客户。

同环比

柱状图和折线图支持同环比。

同环比需要先在维度槽位中选择时间类字段。字段放入槽位后，右键该字段打开配置菜单，再选择同环比模式和周期。

配置步骤：

选择柱状图或折线图
在 X 轴维度中选择日期或日期时间字段
右键已选中的时间字段
在菜单中选择 同环比
选择环比或同比，再选择对比周期

开启后，可以查看当前数据与上一周期或上一年同期的对比。

模式	说明
环比	与上一个周期比较
同比	与上一年同周期比较
自动	系统根据时间维度自动选择合适周期

显示配置

在 视觉配置 中，可以调整图表展示效果。

配置项	说明
图表名称	图表标题，也是保存时默认使用的名称
图表说明	保存后作为图表描述
显示标题	控制预览中是否显示标题
显示图例	控制是否显示图例
图例位置	设置图例在顶部、右侧、底部或左侧
显示标签	控制图表中是否显示数据标签
配色方案	切换图表颜色主题

部分图表类型还会提供额外显示项，例如柱圆角、标签字号、辅助线、极值标记或缩放。

绑定脚本

当数据集里有 值来源为自定义脚本 的计算字段时，可以在图表中使用绑定脚本把脚本结果写入这些字段。

如果需要先了解脚本型计算字段的使用方式，请查看计算字段使用说明。

绑定脚本在图表查询之后运行：图表先按维度和指标聚合数据，再把聚合结果传给 Studio 脚本。脚本返回的数据通过 匹配字段 找到图表行，再通过 赋值字段 写入脚本型计算指标。

配置项	说明
匹配字段	用数据集字段和脚本结果字段进行匹配，把结果写入对应分类或分组
赋值字段	指定哪个脚本结果字段写入哪个计算字段
执行脚本	运行当前绑定脚本，并刷新预览结果

完整示例：给各地区销售额添加目标金额

假设你已有一个包含地区和 销售金额 的销售数据集，要用柱状图同时显示各地区的实际销售额与目标金额。示例目标为北美 150000、欧洲 110000；请在自己的脚本中替换为实际业务目标。这里用固定值演示绑定过程，不需要连接外部系统。

第 1 步：准备数据集字段

进入 可视化 > 数据集，打开销售数据集。没有数据集时，先按数据集中的步骤从销售表单创建。
在 字段与元数据 中确认地区的身份是维度，销售金额 的身份是指标，聚合方式为求和。
在 数据集属性 中点击 自定义列 图标，新增字段 目标金额：数据类型选数字，值来源选 自定义脚本，然后保存。
回到 字段与元数据，确认 目标金额 已启用，身份为指标，聚合方式选无。本例中脚本对每个地区只返回一条目标记录。
保存数据集。此时数据集预览里没有目标金额的计算结果是正常的；它要等图表运行绑定脚本后才有值。

第 2 步：在 Soln Studio 创建并发布脚本

进入 Soln Studio，点击创建，在 新建 Studio 资产 中填写名称“地区销售目标”，资产类型选脚本，起始模板选 TypeScript 脚本，然后点击创建。
打开脚本入口文件 index.ts，把默认模板替换为以下代码：

type ChartBindingInput = {
  chartData: {
    rows: Array<{ __category?: unknown }>;
  };
};

export default async function main(payload: StudioScriptRuntimeContextPayload) {
  const input = payload.input as ChartBindingInput;
  const targets: Record<string, number> = {
    北美: 150000,
    欧洲: 110000,
  };

  return {
    rows: input.chartData.rows.flatMap((row) => {
      const region = String(row.__category ?? '').trim();
      const targetAmount = targets[region];
      return targetAmount === undefined ? [] : [{ region, targetAmount }];
    }),
  };
}

保存、编译并发布脚本资产。图表的脚本选择器只列出已发布且可运行的脚本。

chartData.rows 是图表聚合后的行；本例的 __category 是 X 轴上的地区。脚本为每个已配置目标的地区返回一行，例如 { region: '北美', targetAmount: 150000 }。没有配置目标的地区不会返回结果，其目标金额显示为空。不要把 Studio 编辑器中单独点击运行当作本例的验收：图表的 chartData 由图表查询传入，应在图表编辑器里点击 执行脚本。

第 3 步：创建图表并配置绑定关系

进入 可视化，点击 创建 > 图表，选择刚才的销售数据集。
选择 柱状图，把地区放入 X 轴维度，把 销售金额 和 目标金额 放入 Y 轴指标。
打开左侧 绑定脚本，选择已发布的“地区销售目标”资产，再选择入口文件 index.ts。
在 匹配字段 点击添加：数据集字段选地区，右侧 脚本结果字段 填 region。
在 赋值字段 点击添加：计算字段选 目标金额，右侧 脚本结果字段 填 targetAmount。字段名需与脚本返回对象完全一致。
点击 执行脚本，再切换到 查看数据，确认每个地区的目标金额写入了正确的行；切回 查看图表 检查柱状图，然后保存图表。

例如，若销售数据汇总后北美为 120000、欧洲为 90000，预览应看到：

地区	销售金额	目标金额
北美	120000	150000
欧洲	90000	110000

看不到目标金额时，先确认脚本已发布、目标金额已放入 Y 轴指标，再检查 region 是否与图表中的地区值一致，以及赋值字段是否准确填写 targetAmount。如果图表还按产品等第二个维度分组，需要让脚本按“地区 + 分组”返回结果，并添加对应的第二个匹配字段；只用地区无法唯一定位每个图表点。

指标卡等只有一行结果的图表可以不添加匹配字段：脚本返回单行时，系统会把它写入第 0 个图表点。多地区图表请使用上面的匹配字段，或在每条脚本结果中返回对应的 __rowIndex。更多入参和返回格式见计算字段使用说明。

保存图表

点击保存后，会打开保存弹窗。

配置项	说明
图表名称	图表在列表中的名称
保存文件夹	图表保存的位置；可以选择根目录或已有文件夹

保存成功后，图表会出现在图表列表中。再次打开图表并保存，会更新已有图表。

查看和导出

配置图表后，可以在编辑器右侧查看图表预览。

操作	说明
查看数据	切换到数据表，查看图表查询结果
查看图表	从数据表切回图表预览
导出图表	导出当前图表图片；是否可用取决于权限
导出数据表	导出当前数据表；是否可用取决于权限

如果预览查询失败，页面会显示错误提示。可以检查数据集字段、筛选条件、字段槽位或绑定脚本配置。

如果需要单独设置某张图表谁可以查看、编辑或删除，请继续查看图表权限。

新建图表​

图表列表操作​

文件夹​

编辑器说明​

选择图表类型​

配置字段槽位​

报表​

筛选条件​

数据限制​

下钻分析​

同环比​

显示配置​

绑定脚本​

完整示例：给各地区销售额添加目标金额​

保存图表​

查看和导出​