Microsoft Excel 连接器

微软 Excel 连接器

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

简介

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

目的

本文档将重点介绍不同的连接器功能，这些功能可通过 HTTP 调用 Microsoft 的 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 连接器的更多信息

• 微软日历连接器
• Microsoft Outlook 连接器
• 微软团队连接器