Microsoft SharePoint
Microsoft SharePoint 连接器可让您连接到 Designer 中的 Microsoft SharePoint 存储。它能助您直接在 Designer 工作流中读写 SharePoint 文件和列表。
SharePoint 文件:在读写存储在 SharePoint 中的 CSV、XLSX 或 JSON 文件等文档库内容时,请使用此选项。每当数据以文件形式存在(例如上传的电子表格)时,选择此项即为正确。
SharePoint 列表:当数据以 SharePoint 列表形式存在(即直接在 SharePoint 中维护的行和列)时,请使用此选项。若要读写单个列表项,选择此项即为正确。
升级到新的 SharePoint 连接器
如果您的工作流使用独立的 SharePoint 输入或 SharePoint 输出工具,这些工具现已弃用。请改用连接器版本 3.1.1 或更高版本,配合“输入数据”和“输出数据”工具使用。使用工作流迁移实用程序更新现有工作流。
先决条件
继续之前,请确保您已满足以下前提条件:
要求 | 详情 |
|---|---|
Designer | Designer 2026.1 或更高版本。 Designer 2025.2 补丁 3 或更高版本。 Designer 2025.1 补丁 5 或更高版本。 |
连接器版本 | Microsoft SharePoint 3.1.0 或更高版本。可从 Designer 附加组件获取。 |
Azure 权限 | |
请务必在 Designer 中启用 DCM。转至选项 > 高级设置 > DCM 以启用此功能。 | |
网络访问 | 对 SharePoint Online 和 Microsoft OAuth 端点的出站访问。 |
Microsoft SharePoint Connector 详细信息
Microsoft SharePoint 在 Designer Desktop 2025.1.XX 及更高版本中可用作输入数据和输出数据工具的数据源。如需详细了解文件类型选项,请转到 从 SharePoint 读取数据 或 将数据写入 SharePoint。
SharePoint Release Version 3.1.2 | |
|---|---|
Version | Description |
v3.1.2 |
|
v3.1.0 |
|
安装连接器
请通过“加载项”,直接从 Designer 安装最新版本的 SharePoint 连接器。这是推荐的安装方法,助您在无需离开 Designer 或访问 Alteryx Marketplace 的情况下浏览、安装和更新连接器。
要安装连接器…
在 Designer 中,转至附加组件 > 管理 Marketplace 附加组件。您将看到可用连接器列表。
请选择 Microsoft SharePoint Connector,然后选择安装。Designer 将下载并安装该软件包。Designer 可能需要重新启动才能完成安装。
安装和设置完成后,SharePoint 连接器即可在输入数据和输出数据工具中使用。
您可以将 Microsoft SharePoint 文件和 Microsoft SharePoint 列表用作数据源或目标。
请设置连接
Microsoft SharePoint 连接器 3.1.0 及更高版本需要 DCM 才能进行连接。在设置连接之前,请务必在 Designer Desktop 中启用 DCM。请转至选项 > 高级设置 > DCM 以启用此功能。
请设置连接
若要连接到 Microsoft SharePoint...
将输入数据或输出数据工具拖到画布上,然后选择连接到数据。
在连接器设置中,选择创建或浏览数据连接。
如果您之前已创建过 Microsoft SharePoint 连接,可以从最近选项卡中选择该连接。
选择 + 新建。从技术列表中,选择 Microsoft SharePoint。
输入连接名称和数据源名称。
在凭证部分中,选择您的身份验证方法,然后输入凭证。如需了解详情,请参阅身份验证方法。
选择保存。您也可以在保存之前测试连接。
选择连接。Microsoft SharePoint 可能会请求身份验证。
在选项窗口中选择读取或写入配置。要了解有关这些选项的详细信息,请参阅从 SharePoint 读取数据或将数据写入 SharePoint。
选择确认以创建与该文件的连接。您可以继续构建您的工作流。
工作流迁移
如果您的现有工作流使用了已弃用的 SharePoint 输入或 SharePoint 输出工具,则需要将其迁移以使用新版连接器。使用工作流迁移实用程序更新现有工作流。
该实用程序将预览所有更改,并在不破坏工作流正常运行的情况下,将已弃用的工具实例替换为新版连接器版本。
身份验证方法
Microsoft SharePoint 支持四种身份验证方法。请参考下表,为您的使用案例选择合适的身份验证方法。
方法 | 详情 |
|---|---|
Azure AD-Private(内置应用程序) |
|
Azure AD-Private(自定义应用程序) |
|
服务主体(应用程序) |
|
服务主体(证书) |
|
重要
截至 2026 年 3 月,我们已弃用独立的 SharePoint 工具。安装最新的 SharePoint 连接器以利用最新功能。Microsoft SharePoint
2026 年 3 月 12 日
SharePoint 版本 2.7.7
已修复的问题
已修复 SharePoint 版本 2.7.7 | |
|---|---|
ID | 描述 |
TPM-5063 | 将 Python 升级到 3.13.11 版本后,SharePoint 输出工具无法创建 YXDB 文件。 |
TPM-5062 | 将 Python 升级到 3.13.11 版本后,SharePoint 工具未能读取 XLSX 文件。 |
TPM-5080 | 为 CSV 文件启用“附加元数据”时,元数据不会被填充。 |
TPM-4989 | 启用 LinkFilename 时,SharePoint 输入工具不会返回 CSV 文件的文件名。 |
TPM-4552 | 使用 GCC High 环境的自定义应用程序与 SharePoint 工具不兼容。 |
TPM-4066 | SharePoint 工具未能通过某些代理服务器进行连接,因为 CONNECT 请求无主机标头。 |
已知问题
已知 SharePoint 版本 2.7.7 | |
|---|---|
ID | 描述 |
TPM-5118 | 2.7.6 版本的 SharePoint 工具在下拉列表中不显示经过筛选的网站搜索结果。 |
TPM-5072 | 当文档库包含大量条目时,SharePoint 列表输入工具未能运行,并出现错误:“未能更新人员记录”。 |
TPM-5066 | 在配置中应用搜索筛选器时,SharePoint 列表工具会返回错误。 |
TPM-5042 | SharePoint 工具在更新到版本 2.7.3 后运行失败。 |
TPM-4959 | 当站点语言设置为法语时,向 SharePoint 列表上传数据会失败。 |
已取消的问题
已取消 SharePoint 版本 2.7.7 | |
|---|---|
ID | 描述 |
TPM-4894 | 当启用 WPAD 时,SharePoint 输入和输出工具版本 2.7.3 解析代理设置的方式不同。 |
TPM-4355 | SharePoint 输入工具和 SharePoint 输出工具不支持 Kerberos 身份验证。 |
TPM-5076 | SharePoint 输出工具在写入 YXDB 文件时不支持动态文件命名。 |
TPM-5070 | PyPAC 在 CIBC 环境中返回的专用 IP 地址有误。 |
TPM-5033 | 使用证书为 SharePoint 列表或文件设置仅应用程序服务主体身份验证时,登录界面出现 404 错误。 |
TPM-5026 | 修改从 DCM 获取的凭证,并在不使用 DCM 进行身份验证时,SharePoint 列表工具会返回 ValueError。 |
TPM-5022 | SharePoint 工具版本 2.7.4 在与界面工具或宏一起使用时无法更新 SharePoint 站点。 |
TPM-4908 | 在 Designer 中,SharePoint 输出工具在使用电子邮件地址、雇员姓名或声明字符串等标识符时,无法更新“人员或组”字段。 |
TPM-4806 | 向现有 CSV 文件追加数据时,SharePoint 输出工具会返回错误。 |
TPM-4551 | 基于 GCC High 环境的服务主体身份验证与 SharePoint 工具不兼容。 |
TPM-4512 | 在 SharePoint 工具中,向包含“人员”或“组”列类型的列表追加数据会失败并报错。 |
TPM-4510 | SharePoint 输入工具对双精度列数据类型的处理有误。 |
TPM-4444 | SharePoint 输入工具返回的日期和时间值会携带多余的小数部分。 |
TPM-4443 | 启用附加元数据时,SharePoint 输入工具不返回 YXDB 和 CSV 文件的元数据。 |
TPM-4441 | SharePoint 输入工具在 YXDB 文件中返回的时间和日期时间值会携带多余的“.000000000”。 |
TPM-4303 | 使用内置身份验证向 YXDB 文件追加多列数据时执行无报错,但生成的文件数据为空。 |
TPM-4274 | 更新日期字段包含 null 值的 SharePoint 列表时,会返回错误:错误代码 400:请求语法错误或方法不受支持。 |
TPM-4071 | SharePoint 输出工具写入浮点数时精度不足。 |
TPM-4015 | 在 SharePoint 列表中选择“文档”时,SharePoint 输入工具会返回错误。 |
TPM-3975 | 仅提供表头行作为输入数据时,SharePoint 输出工具不会覆盖列表。 |
TPM-3795 | 写入 SharePoint 列表时,SharePoint 输出工具不会上传以下划线开头的字段。 |
TPM-3785 | 在 SharePoint 本地部署中,覆盖工作表会删除文件中的其他工作表,仅保留被覆盖的工作表。 |
TPM-3783 | 读取 SharePoint 列表时,SharePoint 输入工具会将日期时间元数据以字符串形式返回。 |
TPM-3773 | 对于 Int64 数据类型,SharePoint 输入工具会返回“整数过大,无法转换”错误。 |
TPM-3711 | SharePoint 输出工具中的“起始单元格”选项在覆盖工作表和追加操作时无法正常工作。 |
TPM-3171 | 使用未启用多选的“人员”或“组”字段的邮箱值时,SharePoint 列表追加操作会失败。 |
版本 | 描述 |
v2.7.6 |
已知问题
|
v2.7.5 |
|
v2.7.4 |
|
v2.7.3 |
|
v2.7.2 |
|
v2.7.0 |
|
v2.6.3 |
|
v2.6.2 |
已知问题
|
v2.6.1 |
|
v2.6.0 |
已知问题
|
v2.5.0 |
|
v2.4.2 |
已知问题
|
v2.4.1 |
已知问题
|
v2.4.0 |
已知问题
|
v2.3.0 |
已知问题
|
v2.2.0 |
|
v2.1.0 |
|
v2.0.1 |
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.x |
|
数据连接管理器
SharePoint 工具 2.2.0 版及更高版本支持数据连接管理器,以便更轻松、更安全地存储凭证。创建与 SharePoint 的连接,并在包含 SharePoint 工具的工作流中轻松重用存储的凭证。Alteryx Server 需要存储的凭证才能成功运行已发布的工作流。
启用 AMP Engine
确保为包含 SharePoint 工具版本 2.2.0 及更高版本的工作流启用 AMP Engine。
自定义 Microsoft Azure API 应用程序设置
要为此工具设置自定义 API 应用程序,请参阅我们的指南。
启用传统加密方法
如果您正在连接到 SharePoint 本地版或使用带有 NTLM 身份验证的代理,则需要在 OpenSSL3 中启用加密方法。
其他详细信息
SharePoint 将所有日期时间值存储为 UTC。要在系统的日期时间值与 UTC 之间正确来回转换,请执行以下操作:
写入 SharePoint 时,请使用 DateTimeToUTC() 函数将系统的时区转换为 UTC。
从 SharePoint 读取数据时,请使用 DateTimeToLocal() 函数从 UTC 转换为系统的时区。
否则,请使用另一个日期时间函数来执行计算。有关更多信息,请参阅函数。
重要
SharePoint(SharePoint 文件)不支持 Desktop Automation(计划程序)。


