分类

XLSX 图表嵌入器

从工作簿数据区域生成柱状图/饼图图片并嵌入 Excel 工作表

当前实现为 Canvas 生成图表图片并嵌入工作簿,适合稳定导出型报表。

示例结果

1 个示例

嵌入柱状图和饼图图片

从工作表范围读取数据生成两类图表并嵌入到 Excel 中

xlsx-chart-embedder-example1.xlsx 查看文件
查看输入参数
{ "workbookFile": "/public/samples/xlsx/xlsx-chart-embedder-example1.xlsx", "chartsJson": "[\n {\n \"sheetName\": \"Charts\",\n \"chartType\": \"bar\",\n \"title\": \"Monthly Revenue\",\n \"categoriesRange\": \"Data!A2:A7\",\n \"valuesRange\": \"Data!B2:B7\",\n \"anchorCell\": \"B2\",\n \"widthPx\": 520,\n \"heightPx\": 320\n },\n {\n \"sheetName\": \"Charts\",\n \"chartType\": \"pie\",\n \"title\": \"Orders Share\",\n \"categoriesRange\": \"Data!A2:A7\",\n \"valuesRange\": \"Data!C2:C7\",\n \"anchorCell\": \"B22\",\n \"widthPx\": 520,\n \"heightPx\": 320\n }\n]" }

Click to upload file or drag and drop file here

Maximum file size: 20MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

关键信息

分类
Format Conversion
输入类型
file, textarea
输出类型
file
样本覆盖
4
支持 API
Yes

概览

XLSX 图表嵌入器是一款在线工具,它能从您上传的 Excel 工作簿中读取指定数据区域,自动生成柱状图或饼图,并将生成的图表图片嵌入到工作表的指定位置。此工具适用于需要将数据可视化结果直接固化到 Excel 文件中的场景,便于分发和离线查看。

适用场景

  • 需要将数据图表直接嵌入 Excel 文件,生成包含可视化内容的最终报告时。
  • 希望避免使用 Excel 原生图表功能,或需要确保图表在不同设备上显示一致时。
  • 需要批量或自动化地为多个数据区域生成并嵌入标准化图表时。

工作原理

  • 上传您的 Excel 工作簿文件(.xlsx 或 .xls)。
  • 在“图表 JSON”配置区域,以 JSON 数组格式定义一个或多个图表,需指定工作表名、图表类型、数据范围、锚点单元格及尺寸等参数。
  • 工具根据配置,从指定的数据范围读取数据,使用 Canvas 生成对应的柱状图或饼图图片。
  • 生成的图片将被嵌入到您指定的工作表和单元格位置,最终输出一个包含嵌入式图表的新 Excel 文件。

使用场景

销售部门将月度业绩数据自动生成柱状图并嵌入报表,快速制作可视化销售简报。
财务人员在季度报告中,将收支占比数据生成饼图并嵌入指定工作表,使报告更直观。
项目经理将项目各阶段任务完成情况数据生成图表,嵌入项目进度文档中进行汇报。

用户案例

1. 销售月度营收可视化报告

销售分析师
背景原因
销售分析师每月需要从原始数据表中提取各产品线的营收数据,并手动制作图表插入报告Excel中,过程繁琐。
解决问题
需要快速将“Data”工作表中A2:A7的产品名称和B2:B7的营收数据生成柱状图,并嵌入到“Charts”工作表的B2单元格开始位置。
如何使用
上传包含原始数据的Excel文件,在图表JSON中配置一个柱状图对象,指定数据范围和嵌入位置。
示例配置
[
  {
    "sheetName": "Charts",
    "chartType": "bar",
    "title": "Monthly Revenue",
    "categoriesRange": "Data!A2:A7",
    "valuesRange": "Data!B2:B7",
    "anchorCell": "B2",
    "widthPx": 520,
    "heightPx": 320
  }
]
效果
工具生成一张展示各产品月度营收的柱状图图片,并准确嵌入到“Charts”工作表的指定位置,完成可视化报告。

2. 订单份额饼图嵌入

运营专员
背景原因
运营专员需要在一份Excel报告中,直观展示不同渠道的订单占比情况。
解决问题
需要将“Data”工作表中A2:A7的渠道名称和C2:C7的订单数量数据生成饼图,并嵌入到“Charts”工作表的B22单元格开始位置。
如何使用
上传Excel文件,在图表JSON中添加一个饼图配置对象,指向正确的数据范围和嵌入位置。
示例配置
[
  {
    "sheetName": "Charts",
    "chartType": "pie",
    "title": "Orders Share",
    "categoriesRange": "Data!A2:A7",
    "valuesRange": "Data!C2:C7",
    "anchorCell": "B22",
    "widthPx": 520,
    "heightPx": 320
  }
]
效果
工具生成一张展示各渠道订单份额的饼图图片,并嵌入到报告工作表的指定位置,清晰呈现了数据分布。

用 Samples 测试

json, xml, xlsx

相关专题

常见问题

支持哪些图表类型?

目前支持生成柱状图(bar)和饼图(pie)两种类型的图表图片。

如何编写图表配置 JSON?

配置是一个 JSON 数组,每个对象代表一个图表。必须包含 sheetName(目标工作表)、chartType(bar/pie)、categoriesRange(分类数据范围)、valuesRange(数值数据范围)、anchorCell(嵌入起始单元格)等字段。可参考页面上的示例。

输出的文件是什么格式?

输出文件与输入文件格式相同,为 Excel 工作簿(.xlsx),其中包含了嵌入的图表图片。

可以一次嵌入多个图表吗?

可以。您只需在图表配置 JSON 数组中定义多个图表对象,工具会按顺序生成并嵌入所有图表。

对上传的文件大小有限制吗?

是的,上传的 Excel 文件大小不能超过 20MB。

API 文档

请求端点

POST /zh/api/tools/xlsx-chart-embedder

请求参数

参数名 类型 必填 描述
workbookFile file (需要先上传) -
chartsJson textarea -

文件类型参数需要先通过 POST /upload/xlsx-chart-embedder 上传获取 filePath,然后将 filePath 传递给对应的文件字段。

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-xlsx-chart-embedder": {
      "name": "xlsx-chart-embedder",
      "description": "从工作簿数据区域生成柱状图/饼图图片并嵌入 Excel 工作表",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-chart-embedder",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题,请联系我们:[email protected]