n8n 中文文档

Microsoft Excel (SharePoint) 节点

使用 Microsoft Excel (SharePoint) 节点读取和写入存储在 SharePoint 文档库中的 Excel 工作簿,包括通过 Microsoft Teams 站点共享的工作簿。

本页列出了 Microsoft Excel (SharePoint) 节点支持的操作,提供选择工作簿的指导,并包含更多资源的链接。

提示

Credentials 凭据

此节点提供两种登录方式,可通过 Authentication 身份验证 下拉菜单选择:

  • Microsoft OAuth2 (Graph):使用通用 Microsoft OAuth2 凭据以个人身份登录。在凭据的 Scope 范围 字段中输入节点所需的 scopes:浏览和读取需要 Sites.Read.All,写入需要 Sites.ReadWrite.All。请包含 openid offline_access,以便凭据刷新 token。例如,要执行节点的全部操作,请输入:openid offline_access Sites.ReadWrite.All。
  • Microsoft Entra Service Principal (App-Only):使用 Microsoft Entra Service Principal 凭据以应用身份登录,适用于没有用户参与的无人值守工作流。向 app registration 授予 Sites.Read.All 读取权限和 Sites.ReadWrite.All 写入权限,并获得 admin consent。要将应用限制在特定站点,请改为向每个站点授予 Sites.Selected。

此节点仅接受上述两种凭据。节点专用的 Microsoft Excel 和 Microsoft SharePoint 凭据无法与其配合使用:Excel 凭据不包含 SharePoint(Sites.*)scopes,而 SharePoint 凭据签发的 token 适用于 SharePoint REST API,并非此节点使用的 Microsoft Graph。

应使用哪个 Excel 节点?

n8n 提供两个 Excel 节点:

  • Microsoft Excel (OneDrive):用于存储在个人或企业 OneDrive 中的工作簿。
  • Microsoft Excel (SharePoint)(本节点):用于存储在 SharePoint 文档库中的工作簿,包括位于 Teams 站点中的文件。此节点还支持 app-only 登录,因此适合无人值守工作流。

如果他人向你共享了工作簿链接,且链接指向 SharePoint 站点,请使用此节点。

选择工作簿

可通过三种方式指定工作簿:

  • Paste the workbook's address 粘贴工作簿地址(默认):从 SharePoint 或 Excel 复制链接(Share > Copy link),并粘贴到 Workbook 工作簿 字段。直接使用复制按钮生成的链接即可,无需先选择站点或文档库。
  • Pick from a list 从列表中选择:选择 Site 站点 和 Document Library 文档库,然后按名称搜索工作簿。
  • By ID 按 ID:直接粘贴工作簿 ID。

Operations 操作

  • Sheet 工作表:
  • Append 追加:将行追加到工作表末尾。
  • Append or Update 追加或更新:追加新行;如果该行已存在,则更新当前行。
  • Clear 清除:清除工作表或区域。
  • Delete 删除:删除工作表。
  • Get Many 获取多个:获取工作簿中的工作表列表。
  • Get Rows 获取行:从某个区域或工作表的已用区域读取行。
  • Update 更新:更新与列值匹配的行。
  • Table 表格:
  • Append 追加:将行追加到表格末尾。
  • Convert to Range 转换为区域:将表格转换为普通单元格区域。
  • Create 创建:从单元格区域创建表格。
  • Delete 删除:删除表格。
  • Get Columns 获取列:获取表格的列列表。
  • Get Many 获取多个:获取工作簿中的表格列表。
  • Get Rows 获取行:获取表格的行列表。
  • Lookup 查找:查找特定列值,然后返回匹配的行。
  • Workbook 工作簿:
  • Add Sheet 添加工作表:向工作簿添加新工作表。
  • Delete 删除:删除工作簿。
  • Get Many 获取多个:获取文档库中的工作簿列表。

更多操作即将推出。本页会在功能发布时同步更新。

模板和示例

搜索所有模板,查看使用此节点的示例。

相关资源

有关此服务的更多信息,请参阅 Microsoft Excel Graph API 文档。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。