搜索本地 Excel 电子表格中的文本——查找特定数据

搜索电子表格内容 API

通过 Aspose.Cells Cloud API 编程方式在任意 Excel 电子表格中搜索特定文本。该 API 可定位存储于云端的本地文件中的文本、数字或公式，从而实现自动化数据发现、内容分析及电子表格审计工作流。

Web API

PUT https://api.aspose.cloud/v4.0/cells/search/content

若您更倾向于使用原生 HTTP 请求，以下 cURL 示例展示了相同的请求：

curl -X PUT "https://api.aspose.cloud/v4.0/cells/search/content?searchText=Invoice&ignoringCase=true" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: multipart/form-data" \
     -F "spreadsheet=@/path/to/your/file.xlsx"

安全与认证

Aspose.Cells Cloud API 具备安全性，需使用 基于 JWT 令牌的身份验证。

-H "Authorization: Bearer {access_token}"

请求参数

响应

API 返回一个 SearchResult 对象，其中包含匹配单元格的数组。每个元素提供工作表名称、单元格地址及匹配的文本内容。

{
  "textItems": [
    {
      "cellName": "A1",
      "text": "合计",
      "occurrences": 1
    },
    {
      "cellName": "B5",
      "text": "合计",
      "occurrences": 2
    }
  ],
  "code": 200,
  "status": "OK"
}

错误码

• 400 Bad Request（错误请求）：请求 URI 或参数无效。
• 401 Unauthorized（未授权）：缺少或无效的访问令牌，或客户端凭据不正确。
• 404 Not Found（未找到）：无法访问指定的电子表格。
• 500 Internal Server Error（内部服务器错误）：处理工作簿时发生意外服务器错误。

在何处应使用“电子表格内容搜索”API？

• 全面工作簿合规审计：扫描整个工作簿以定位敏感术语（例如“保密条款”、“内部数据”），用于数据安全与合规性检查。
• 跨工作表数据关联查询：查找在多个工作表中出现的项目编号或客户名称，从而实现快速跨工作表集成。
• 批量模板内容验证：生成报告后，验证一批 Excel 文件中所有占位符（例如 {{Date}}）是否已正确替换。
• 历史数据归档与挖掘：在旧版 Excel 文件中搜索特定事件代码或业务术语，以加速数据考古与分析。

为何应使用“电子表格内容搜索”API？

• 开发者友好：提供多种编程语言的 SDK，相比自研方案显著降低开发工作量。
• 降低人工成本：自动化原本需人工逐一检查电子表格的任务。
• 按需付费：仅对实际调用的 API 请求计费。
• 零维护：无需管理服务器、软件更新，亦无兼容性问题。
• 保留复杂格式：结果可导出为 PDF，同时保留原始 Excel 布局。

如何使用 SDK 调用电子表格“查找断链”功能

OpenAPI 规范

OpenAPI 规范 定义了一个公开可访问的编程接口，允许您直接从 Web 浏览器发起 REST 调用。

使用 Aspose.Cells Cloud SDK

使用 SDK 是集成搜索功能最快捷的方式。SDK 封装了 HTTP 层，使您能以极少代码调用 API。查看 GitHub 仓库中的 完整 SDK 列表。

以下代码示例展示了如何使用不同 SDK 调用“搜索电子表格内容”操作：