Microsoft SharePoint
The Microsoft SharePoint connector lets you connect to Microsoft SharePoint storage in Designer. It enables you to read from and write to SharePoint Files and Lists directly in your Designer workflows.
SharePoint Files: Use this when reading or writing document-library content such as CSV, XLSX, or JSON files stored in SharePoint. This is the right choice whenever your data lives as a file, such as an uploaded spreadsheet.
SharePoint Lists: Use this when your data lives as a SharePoint List — rows and columns maintained directly in SharePoint. This is the right choice when reading or writing individual list items.
升级到新的 SharePoint 连接器
如果您的工作流使用独立的 SharePoint 输入或 SharePoint 输出工具,这些工具现已弃用。请改用连接器版本 3.1.0 或更高版本,配合“输入数据”和“输出数据”工具使用。使用工作流迁移实用程序更新现有工作流。
Prerequisites
Ensure you have completed the following prerequisites before proceeding:
Requirement | Details |
|---|---|
Designer | Designer 2026.1 or later. Designer 2025.2 Patch 3 or later. Designer 2025.1 Patch 5 or later. |
Connector Version | Microsoft SharePoint version 3.1.0 or later. Available from Designer Add-Ons. |
Azure Permissions | |
You must enable DCM in Designer. Go to Options >Advanced Settings > DCM to enable it. | |
Network Access | Outbound access to SharePoint Online and Microsoft OAuth endpoints. |
Microsoft SharePoint Connector 详细信息
Microsoft SharePoint 在 Designer Desktop 2025.1.XX 及更高版本中可用作输入数据和输出数据工具的数据源。如需详细了解文件类型选项,请转到 从 SharePoint 读取数据 或 将数据写入 SharePoint。
2026 年 3 月 17 日
Microsoft SharePoint 连接器版本 3.1.0
新增功能
Microsoft SharePoint 连接器现已正式发布。
已修复的问题
已修复 Microsoft SharePoint 连接器版本 3.1.0 | |
|---|---|
ID | 描述 |
TCO-3269 | 在启用代理的情况下测试连接时,SharePoint 连接器会返回错误。 |
TCO-3168 | 将新文件写入空文件夹时,SharePoint 输出工具会返回“无法获取数据”错误。 |
TCO-3154 | SharePoint 列表输出工具未能完成大列表的写入。 |
TCO-3144 | SharePoint 文件和列表输入和输出工具在默认范围及所有身份验证类型下均支持“通过链接浏览”功能。 |
TCO-3124 | SharePoint 列表输出工具将重复记录添加到列表中。 |
TCO-3094 | 在 SharePoint 工具中,使用 Sites.Selected 权限时无法执行写入操作。 |
TCO-3068 | 在 SharePoint 工具中,由于路径解析错误导致“拒绝访问”,使用服务主体写入文件时,Sites.Selected 权限会失败。 |
TCO-2974 | 在 SharePoint 工具中,手动编辑文件路径并非在所有情况下都能正常工作。 |
TCO-2949 | 在 SharePoint 工具中,搜索未能找到现有列表并返回“无法获取数据”错误。 |
TCO-2795 | 向 SharePoint 列表写入包含“ID”列的表时,将导致静默失败且不触发任何错误消息。 |
TCO-2788 | 即使源表和目标表之间不存在匹配列,追加操作仍会成功。 |
TCO-2783 | 当源包含额外列时,追加操作会显示成功,但目标并未更新且未显示错误。 |
TCO-2777 | 用户无法通过在路径导航中键入完整路径来选择列表。 |
TCO-2775 | 在 SharePoint 工具中,搜索未能找到现有列表并返回“无法获取数据”错误。 |
TCO-2774 | SharePoint 列表连接器的 OAuth 客户端列表未填充。 |
TCO-2771 | SharePoint 列表连接器针对无效的颁发机构 URL 返回 HTTP 200 响应,从而导致错误处理不正确。 |
TCO-2600 | SharePoint 列表输出工具对 FixedDecimal 值的映射有误,导致数值不准确。 |
已取消的问题
已取消 Microsoft SharePoint 连接器版本 3.1.0 | |
|---|---|
ID | 描述 |
TCO-3360 | 当输出操作设置为“删除”时,SharePoint 列表输出工具不允许用户选择主列。 |
TCO-3115 | 当读取名称长度为 128 个字符的文件时,SharePoint 输入工具会返回错误。 |
TCO-2979 | SharePoint 输入工具在读取元数据时表现不一致。 |
TCO-2972 | 更新 OAuth 凭证后,SharePoint 列表工具间歇性地未能解析连接,仅在延迟一段时间后才能成功。 |
TCO-2895 | 选择空文件夹或新创建的文件夹时,SharePoint 输出工具会返回 UnboundLocalError。 |
TCO-2893 | 将数据写入列表时,SharePoint 列表输出工具不保留原始行顺序。 |
TCO-2796 | Null 值不会写入 SharePoint 列表。 |
TCO-2790 | 在标准模式下,“创建”和“追加”操作不起作用。 |
TCO-2781 | 当仅完成部分列表创建时,SharePoint 列表输出工具不会通知用户。 |
TCO-2772 | 使用服务主体证书创建 SharePoint 列表连接会返回不一致的有效负载。 |
TCO-2722 | SharePoint 列表输出工具无法使用服务主体证书身份验证执行输出操作。 |
TCO-2602 | SharePoint 列表输出工具在写入浮点数时会出现舍入误差。 |
TCO-2601 | SharePoint 列表输出工具会跳过 DateTime 值超出范围的记录,且不发出任何通知。 |
TCO-2326 | 在使用混合数据时,SharePoint 列表输出工具创建的列表会缺失记录,且不会记录错误或失败的记录 ID。 |
TCO-2286 | DCM 处理无法与 SharePoint 输出工具和 EACD 连接器正常工作。 |
TCO-2234 | 若第一行未被用作列名,SharePoint 输入工具会将其忽略。 |
TCO-2095 | 选中“指定范围”时,SharePoint 输出工具将禁用“从”和“到”字段。 |
2025 年 10 月 24 日
Microsoft SharePoint 连接器版本 3.0.0
新增功能
为统一 Alteryx One 和 Designer 的用户体验,我们为 Designer 发布了一款新的 Microsoft SharePoint 连接器。此连接器可在“输出数据”工具中实现与 Microsoft SharePoint 的 DCM 连接。
已知问题
已知 Microsoft SharePoint 连接器版本 3.0.0 | |
|---|---|
ID | 描述 |
TCO-2795 | 将名为“ID”的列从 Alteryx One 写入 SharePoint 列表会导致静默失败,并且不显示任何错误消息。 |
Install the Connector
Install the latest version of the SharePoint connector directly from Designer using Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.
To install the connector…
In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.
Select Microsoft SharePoint Connector and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.
After installation and setup are complete, the SharePoint connector is available from the Input Data and Output Data tools.
You can use Microsoft SharePoint Files and Microsoft SharePoint Lists as data sources or destinations.
Set Up a Connection
Microsoft SharePoint connector version 3.1.0 and later requires DCM to connect. You must enable DCM in Designer Desktop before setting up a connection. Go to Options > Advanced Settings > DCM to enable it.
使用 DCM 设置连接
要使用
将输入数据或输出数据工具拖到画布上,然后选择连接到数据。
在连接器设置中,选择创建或浏览数据连接。
如果您之前已创建过 Microsoft SharePoint 连接,可以从最近选项卡中选择该连接。
选择 + 新建。从技术列表中,选择 Microsoft SharePoint。
输入连接名称和数据源的详细信息。
在凭证部分中,选择您的身份验证方法,然后输入凭证。
选择保存。您也可以在保存之前测试连接。
选择连接。Microsoft SharePoint 可能会请求身份验证。
在选项窗口中选择读取或写入配置。要了解有关这些选项的详细信息,请参阅从 SharePoint 读取数据或将数据写入 SharePoint。
选择确认以创建与该文件的连接。您可以继续构建您的工作流。
Workflow Migration
If your existing workflows use the deprecated SharePoint Input or SharePoint Output tools, you need to migrate them to use the new connector. Use the workflow migration utility to update existing workflows.
The utility previews all the changes and replaces deprecated tool instances with the new connector versions without breaking the workflows.
Authentication Methods
Microsoft SharePoint supports four authentication methods. Use the table below to choose the right one for your use case.
Method | Details |
|---|---|
Azure AD-private (Built-In App) |
|
Azure AD-private (Custom App) |
|
Service Principal (Application) |
|
Service Principal (Certificate) |
|
重要
截至 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(计划程序)。


