
图表是直观呈现数据的重要机制之一,在处理 Excel 文件 中的计算数据时,图形和图表在数据呈现中起着关键作用。但是,有时我们会遇到无法在 Excel 电子表格中容纳图表的情况。因此,我们需要一种更智能的方式来表示数据趋势,这时迷你图就可以发挥作用了。
在 Excel 中使用迷你图的优点
Excel 中的迷你图可让您一目了然地查看数据中的趋势和模式,只需在仪表板上占用最少的空间。大多数情况下,您可能会创建一组迷你图 — 每行或每列数据一个。工作表可以容纳任意数量的迷你图组。Excel 会记住每个组,您可以将该组作为一个单元进行操作。
迷你图组提供了一种非常方便的机制来处理特定组中的一组迷你图。例如,您可以选择组中的一条迷你图,然后修改组中所有迷你图的格式。为了方便我们的用户以编程方式处理 Excel 工作表,在最新发布的 Aspose.Cells Cloud API 版本中,迷你图组的操作得到了进一步优化。
如何获取迷你图组描述
处理文档最快捷、最简单的方法是使用 云存储。上传包含迷你图组的 Excel 工作表后,您可以轻松获得与该组相关的详细信息。
获取 JSON Web 身份验证令牌
我们的云 API 和 云存储 是安全的,只有授权用户才能访问。获得授权后,您可以轻松地对云存储或本地系统上的文档执行读取、上传、更新或删除操作。为了获取 JWT 令牌,
- 首先通过 Cloud 仪表板 注册一个帐户
- 然后登录 云仪表板 并点击左侧的应用程序菜单
- 默认情况下,页面上将显示第一个应用。单击以打开详细信息
- 在第一个应用详情页面,您将找到您的个性化客户端 ID 和客户端密钥
- 在命令提示符中输入以下命令来检索您的 JWT 令牌。
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx-xxx-xxx-xxx-xxxx&client_secret=xxxxxxx" \
-H "Accept: application/json"
欲了解更多详细信息,请访问 JSON Web Token 身份验证
cURL 命令
curl -X GET "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
尝试使用 API 参考
- 打开 Aspose.Cells Cloud 的 API 参考页面。
- 使用客户端 ID 和客户端-服务器密钥进行身份验证。
- 访问 GetWorksheetSparklineGroups API 并单击试用按钮。
- 根据名称字段提供 Excel 工作簿名称(在我们的例子中为 Sparkline.xlsx)。
- 输入包含针对 sheetName 字段的 Sparkline 组的工作表的名称(在我们的例子中为 Sheet1)。
- 单击“执行”按钮。详细信息将被获取并显示在响应部分下。
请求 URL
https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups
响应将显示与颜色、预设、样式、类型、LowPointColor、MarkersColor 等相关的所有详细信息。请查看以下图像,其中显示了包含迷你图组的 Excel 工作表的预览以及响应中呈现的信息。

图 1:- 与 Sparkline 组相关的属性的预览。

图 2:垂直迷你图组的数据范围预览。

图 3:水平迷你图组的数据范围预览。

图 4:迷你图组类型的预览。
添加迷你图组描述
Aspose.Cells Cloud 还提供了在 Excel 工作表中添加 Sparkline 组描述的功能。PostWorksheetSparklineGroup 需要 name、sheetName、sparklineGroupIndex、sparklineGroup 参数来实现此要求。
在 Excel 中更新 Sparkline 组描述
为了更新 Excel 中的迷你图,请尝试使用 PutWorksheetSparklineGroup API。该 API 需要以下参数才能满足要求
- 名称:- 存储在云存储上的工作簿的名称
- sheetName:- 需要添加迷你图的工作表
- 类型:迷你图类型(线、柱、胜/负)
- dataRange:我们需要用作迷你图源的数据范围
- isVertical :迷你图是否垂直
- locationRange:我们需要绘制迷你图的位置
cURL 命令
curl -X PUT "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
在上面的场景中,sparkline 的类型指定为 Column(从 Line 更新为 Column),dataRange 指定为 B3:F9,isVertical 指定为 False,locationRange 指定为 G3:G9。
请求 URL
https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9

图 5:- 迷你图类型的预览已更新。
删除迷你图组描述的步骤
Aspose.Cells Cloud 还提供了一种快速删除 Excel 中现有迷你图的机制。为了删除所有迷你图组,请尝试使用 DeleteWorksheetSparklineGroups API。然而,如果我们需要根据特定索引 ID 删除迷你图组,我们需要使用 DeleteWorksheetSparklineGroup。
cURL 命令
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
请求 URL
https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1
执行成功后,响应主体中显示 200 响应代码。下图显示了从 Excel 工作表中删除的垂直迷你图组。而另一个水平迷你图组仍保留在工作表中,因为只删除了索引 1 组。

图 6:删除后的垂直迷你图组的预览。
结论
本文介绍了使用 REST API 获取、创建、更新和删除 Excel 中的迷你图的步骤。您也可以考虑阅读相关博客 使用 Cloud API 操作图表数据透视表和迷你图。如果您有任何相关疑问,请随时通过 免费支持论坛 联系。
API 的源代码也可以在 GitHub 免费代码库 上找到。
相关文章
我们强烈建议您访问以下链接以了解更多信息: