Microsoft SharePoint
Designer 中的新连接器版本
SharePoint 连接器现在是 Alteryx One 体验的一部分。请仔细阅读此页面上的信息,以确保您正确使用相应的工具。
如果要更新 Designer Desktop 工作流中的 SharePoint 连接器,可以使用工作流迁移实用程序。
Microsoft SharePoint 连接器可让您连接到 Designer Desktop 中的 Microsoft SharePoint 存储。
Microsoft SharePoint 可作为数据源在输出数据工具中使用,并且支持写入文件和列表。独立的 SharePoint 输入和 SharePoint 输出工具已弃用。
连接器类型 | 发布 | 工具和数据处理选项 |
|---|---|---|
最新版本可从 Alteryx Marketplace 获得。 | ||
最新版本可从 Alteryx Marketplace 获得。 |
Microsoft SharePoint Connector 详细信息
Microsoft SharePoint 在 Designer Desktop 2025.1.XX 及更高版本中可作为输出数据工具的数据源。如需详细了解文件类型选项,请转到 将数据写入 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 Desktop 的用户体验,我们为 Designer Desktop 发布了一款新的 Microsoft SharePoint 连接器。此连接器可在“输出数据”工具中实现与 Microsoft SharePoint 的 DCM 连接。
已知问题
已知 Microsoft SharePoint 连接器版本 3.0.0 | |
|---|---|
ID | 描述 |
TCO-2795 | 将名为“ID”的列从 Alteryx One 写入 SharePoint 列表会导致静默失败,并且不显示任何错误消息。 |
要求
要求 | 详情 |
|---|---|
Designer Desktop | Designer Desktop 2025.2 补丁 3 或更高版本。 Designer Desktop 2025.1 补丁 5 或更高版本。 |
连接器版本 | Microsoft SharePoint 3.1.0 或更高版本。可从 Designer 附加组件获取。 |
Azure 权限 | |
请务必在 Designer Desktop 中启用 DCM。转至选项 > 高级设置 > DCM 以启用此功能。 | |
网络访问 | 对 SharePoint Online 和 Microsoft OAuth 端点的出站访问。 |
安装连接器
通过附加组件,您可以轻松从 Designer Desktop 安装最新版本的 SharePoint 连接器。如果以这种方式安装连接器,则无需访问 Alteryx Marketplace。
注意
Designer Desktop 附加组件
“附加组件”窗口可让您浏览、安装和更新连接器,而无需离开 Designer。这是最新版本连接器的推荐安装过程。
要安装连接器…
在 Designer Desktop 中,转至附加组件 > 管理 Marketplace 附加组件。
Designer Desktop 将打开一个包含可用连接器列表的窗口。
键入 SharePoint 进行搜索。
查找 Microsoft SharePoint Connector v3.1.0 或更高版本。
选择连接器,然后选择安装。Designer Desktop 将自动下载并安装软件包。Designer Desktop 可能需要重新启动才能完成安装。
安装和设置完成后,SharePoint 连接器将在工具面板的“连接器”类别中提供。输出数据工具还将 Microsoft SharePoint 文件和 Microsoft SharePoint 列表列为可用数据源。
工作流迁移
使用工作流迁移实用程序更新现有工作流。安装新版本的连接器不会自动迁移现有工作流。仅需迁移使用已弃用的 SharePoint 输入或 SharePoint 输出工具的工作流。
工作流迁移实用程序会预览更改,并使用新版本的连接器替换已弃用的工具实例,且不会破坏您的工作流或丢失配置。
身份验证方法
Microsoft SharePoint 支持使用用户凭证(Azure AD-Private(内置应用程序))、自定义应用程序(Azure AD-Private(自定义应用程序))和高级自定义 API 应用程序身份验证(服务主体(应用程序))进行基本身份验证。
Azure AD-Private(内置应用程序)
使用邮件和密码进行的基本身份验证与用户的个人 Google 凭证绑定。您可以允许 SDK 使用此连接。
我们不建议在计划工作流时使用此类身份验证。
Azure AD-Private(自定义应用程序)
有关如何设置 API 应用程序的说明,请参阅 Microsoft Azure API 应用程序设置。您可以允许 SDK 使用此连接。
服务主体(应用程序)
高级身份验证利用具有服务主体的自定义 API 应用程序的功能。有关如何设置 API 应用程序的说明,请参阅 Microsoft Azure API 应用程序设置。您可以允许 SDK 使用此连接。
具有服务主体的 API 应用不与特定用户绑定,因此您可以更方便地使用它们来计划工作流。但是,当您在 DCM 中创建连接时,它们需要一次性身份验证。
服务主体(证书)
要启用 SharePoint 应用专用身份验证,您需要创建证书、将其上传到 Azure 门户,并获取私钥。仅限应用程序身份验证适用于所有版本的 SharePoint 连接器中的 SharePoint 列表,以及 2.7.2 及更高版本的连接器中的 SharePoint 文件。
有关如何设置 API 应用程序的说明,请参阅 创建 SharePoint 仅限应用程序的身份验证证书。仅限应用程序的身份验证仅通过 DCM 支持。DCM - Designer
使用 DCM 设置连接
要使用 DCM 连接到 Microsoft SharePoint...DCM - Designer
将输入数据或输出数据工具从工具面板拖到画布上并选择它。
选择设置连接。
如果您以前创建过 Microsoft SharePoint 连接,则可以选择数据源 > Microsoft SharePoint 文件或列表 > 快速连接,然后跳至第 12 步。
在数据连接窗口中,选择数据源。
查找 Microsoft SharePoint 文件或列表,然后选择快速连接。
此时将打开连接窗口。
选择 + 新建以创建连接。
输入您选择的连接名称。
在数据源部分,Designer 会自动选择 Microsoft SharePoint 数据源技术。
输入您选择的数据源名称。
在凭证部分,选择您的身份验证方法,然后输入凭证。如需了解详情,请参阅上一节中的身份验证方法。
选择保存。您也可以在保存之前测试连接。
选择连接。Microsoft SharePoint 可能会请求身份验证。
在文件浏览器窗口中选择要读取或写入的文件。
在选项窗口中选择读取或写入配置。
选择确认以创建与该文件的连接。您可以继续构建您的工作流。
重要
截至 2026 年 3 月,我们已弃用独立的 SharePoint 工具。安装最新的 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(计划程序)。




