Microsoft Excel 连接器
  • 06 Mar 2024
  • 1 分钟阅读
  • 贡献者

Microsoft Excel 连接器


Article Summary

::(信息)()要下载应用程序,请访问:图书馆:::

微软 Excel 连接器

与 Microsoft O365 工作表集成 V1.0 Api

简介

Microsoft Excel 工作表 API 允许用户创建、读取和编辑 Microsoft Excel 工作表,并对其 Office365 账户设置正确的访问权限。该连接器的目标是使用 Microsoft 的 Graph API(v1.0),通过 HTTP 连接器将 Tulip 与 Microsoft 集成,并为客户提供可导入其实例的开箱即用连接器。

目的

本文档将重点介绍不同的连接器功能,这些功能可通过 HTTP 调用微软的 Graph API(v1.0) 与 M365 Excel 工作表进行交互,以展示工作表上的各种读写操作,这些操作可用于各种用例。

应用程序接口文档

微软图形 API 文档

前提条件

  1. 在 Microsoft O365 上创建帐户,并在 Microsoft Entra ID 中配置 OAuth 2.0 凭据。
  2. 在 Microsoft 门户中使用所需范围注册 API。Azure - Entra ID

设置连接器的视频:

郁金香连接详细信息

需要在 Tulip 的

连接器。

  1. 运行于:云连接器主机
  2. 主机:graph.microsoft.com
  3. 端口:443
  4. TLS: 是

OAuth 2:获取访问令牌,以便与 Microsoft 图形 API 通信

连接器功能

1) 获取一个驱动器的详细信息

用途

此连接器将从一个驱动器获取所有项目。

端点

HTTP POST 调用端点-https://graph.micrsoft.com:443/v1.0/me/drive/root/children

所需输入

无需输入

所需输出提取器

  1. SheetID: 用于执行其他任务的工作簿的唯一标识符。
  2. 创建时间:工作簿的创建日期和时间。
  3. LastModified(最后修改工作簿的最后修改日期和时间。
  4. 工作表名称:工作簿名称。
  5. SpreadSheetURL:工作簿的 URL。

2) 获取工作簿中的所有工作表

目的

该连接器将通过传递工作簿 ID 获取工作簿中的所有工作表。

端点

HTTP GET 到端点-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

所需输入

以下是需要传递的 URL 参数

  1. 工作簿 ID

所需输出提取器

  1. sheetId:用于执行其他任务的电子表格的唯一标识符。
  2. sheetName:工作表的显示名称。
  3. sheetPosition:工作表在工作簿中的零基位置。
  4. 工作表可见性:工作表的可见性。可能的值为可见、隐藏、非常隐藏。

3) 获取工作表元数据

目的

该连接器将从工作簿 ID 和工作表名称中获取数据。

端点

HTTP GET 调用端点https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/

所需输入

以下是需要传递的 URL 参数

  1. 工作簿 ID
  2. 工作表名称

所需输出提取器

  1. sheetId:用于执行其他任务的电子表格的唯一标识符。
  2. sheetName:工作表的显示名称。
  3. sheetPosition:工作表在工作簿中的零基位置。
  4. 工作表可见性:工作表的可见性。可能的值有可见、隐藏、非常隐藏。

4) 创建新工作表

目的

  1. 用户可以将工作簿 ID 和工作表名称作为输入,Tulip 将根据提供的工作表名称创建新工作表。API 的响应将是工作表的元数据和各种属性。这可进一步用于从工作表中获取和更新数据。
  2. 从 Microsoft Graph V1.0 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add

所需输入

以下是作为请求体发送的参数

  1. 工作簿 ID - 工作簿 ID
  2. 工作表名称 - 工作表标题

所需输出提取器

  1. 工作表 ID:电子表格的唯一标识符,用于执行其他任务。
  2. spreadsheetURL:新创建电子表格的 URL。
  3. 随响应返回的其他参数可作为输出参数的一部分。

5) 更新工作表属性

目的

用户可以将工作簿 ID、旧工作表名称、工作表位置和新工作表名称作为输入,郁金香将根据提供的工作表名称更新工作表。API 的响应将是工作表的元数据和各种属性。这可进一步用于从电子表格中获取和更新数据。

端点

HTTP PATCH 调用端点-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

所需输入

以下是作为请求正文发送的参数

  1. 工作簿 ID - 工作簿 ID
  2. 工作表名称 - 工作表标题
  3. 工作表位置-工作表在工作簿中基于零的位置
  4. 新工作表名称 - 新工作表标题

所需的输出提取器

  1. 工作表 ID:用于执行其他任务的工作簿的唯一标识符
  2. 工作表名称:工作表的显示名称。
  3. sheetPosition:工作表在工作簿中的零基位置。

6) 获取特定单元格数据

用途

此连接器将根据所提供的 WorkbookID、工作表名称、行索引和列索引作为输入,从工作簿的工作表中获取数据。API 的响应将是所提供单元格值的数据。

端点

HTTP GET 调用端点-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={row index},column={column index})

必须输入

以下是需要传递的 URL 参数

  1. 工作簿 Id- 工作簿 ID
  2. 工作表名称- 工作表标题
  3. 行索引- 要检索单元格的行号
  4. 列索引 - 要检索单元格的列号

所需输出提取器

此连接器返回所提供行和列索引的单元格值。

7) 获取工作表范围数据

目的

此连接器将根据提供的 WorkbookID、工作表名称、开始范围和结束范围作为输入,从工作簿的工作表中获取数据。API 的响应将是所提供范围的数据。

端点

HTTP GET 调用端点-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address='{start range}:{end range}')

必要输入

以下是需要传递的 URL 参数

  1. 工作簿 Id- 工作簿 ID
  2. 工作表名称- 工作表标题
  3. 起始范围- 起始范围
  4. End range- 结束范围

所需输出提取器

此连接器返回所提供范围内的所有单元格值。

8) 按范围更新值

目的

用户可将工作簿 ID、工作表名称、起始范围、终止范围和要更新的值作为输入,Tulip 将根据提供的范围更新范围值。API 的响应将是更新的范围值。

端点

HTTP PATCH 调用端点-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address='{start range}:{end range}')

必要输入

以下是需要传递的 URL 参数

  1. 工作簿 Id- 工作簿 ID
  2. 工作表名称- 工作表标题
  3. 起始范围- 起始范围
  4. 结束范围 - 结束范围
  5. 所提供范围内每个单元格的值

所需的输出提取器

我们不需要任何输出提取器。

9) 在工作表中创建表格

目的

  1. 用户可以将工作簿 ID、工作表名称、工作表地址和标题作为输入,Tulip 将根据表名创建一个新表。API 的响应将是表的元数据和各种属性。
  2. 这可进一步用于从电子表格中获取和更新数据。
  3. 从 Microsoft Graph V1.0 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add

所需输入

以下是作为请求体发送的参数

  1. 工作簿 ID - 工作簿 ID
  2. 工作表名称 - 工作表标题
  3. 地址-代表数据源的范围对象的地址或名称。如果地址不包含工作表名称,则使用当前活动工作表。
  4. hasHeaders-布尔值,表示导入的数据是否有列标签。如果数据源不包含页眉(即此属性设置为 false 时),Excel 将自动生成页眉,并将数据向下移动一行。

所需输出提取器

返回新建表格的元数据值。

10) 在表格中添加新行

目的

用户可将工作簿 ID、表名和行值作为输入,Tulip 将根据提供的行值创建新行。API 的响应将是在表中创建的行值。

端点

HTTP POST 调用端点https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add

所需输入

以下是作为请求正文发送的参数

  1. 工作簿 ID - 工作簿 ID
  2. 工作表名称 - 工作表标题
  3. 行值

必要输出提取器

返回新建行的行值。

11)清除工作表数据

目的

用户可将工作簿 ID、工作表名称、开始范围和结束范围作为输入,Tulip 将根据给定范围清除单元格值。

端点

HTTP POST 调用端点https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address='{start range}:{end range}')/clear

所需输入

以下是作为请求正文发送的参数

  1. 工作簿 ID - 工作簿 ID
  2. 工作表名称 - 工作表标题
  3. 起始范围
  4. 结束范围

更多阅读

查看有关 Microsoft 连接器的更多信息


本文对您有帮助吗?