Skip to main content

Designer 与 Server 版本兼容性

在 2025.2 版本发布之前,如果您使用的 Designer 版本比 Server 版本更新,则由于潜在的版本兼容性问题,您将无法将工作流上传到 Server。

2025.2 版 Designer 与 Server 的发布将两者的更新分离。阅读下文,了解这对您的影响。

重要提示

  • 在 2025.2 版本中,以前的 Designer-Server 版本兼容性限制仍然适用于工作流执行。也就是说,您无法执行在比 Server 更新版本的 Designer 中创建的工作流。

  • 2026.1 版本将是首个助您利用 Designer 与 Server 解耦优势的版本。也就是说,您可以将 Designer 升级到 2026.1,并在 Server 2025.2 中保存和执行 2026.1 工作流(注意潜在的执行影响)。

我们建议您将此页面添加为书签。我们将持续更新此页面,并会在未来版本改进和更新此体验时同步更新。

Designer 与 Server 更新分离

为了实现更新体验的现代化并降低 IT 开销,Alteryx 已将 Designer 和 Server 更新分离开来。此更改允许您在不依赖 Server 的情况下独立升级 Designer,因此用户无需等待 Server 审批或环境升级,即可立即使用最新的 Designer 功能。这一改进简化了落地流程,加快新功能的获取,并减少延迟——对 Server 更新周期较长的组织尤其明显。

通过此增强功能,使用较新版本 Designer 构建的资产不再被阻止发布到较旧的 Server 环境。系统将不再显示阻止性错误,而是会显示一条警告,用户可以选择是否继续操作。这为团队提供了更大的灵活性,同时减少了工作流中断。

Designer 与 Server 分离的警告示例

当您尝试连接或保存到版本低于当前 Designer 的 Server 时,系统会显示此警告消息:

您正在连接或保存到的 Alteryx Server 的版本低于您当前 Designer 的版本。部分功能可能不受支持。

重要

为避免潜在的执行影响,建议同时使用 Alteryx Designer 和 Alteryx Server 的用户在升级 Designer 前先升级 Server。如需了解详情,请转至安装或升级 Server

潜在的执行影响

如果您计划使用比 Server 版本更新的 Designer 版本,建议在向较旧版本的 Server 上传资产时查看验证运行日志,并在 Server 上运行工作流时查看执行运行日志。

  • 请查看下表,了解如果您使用的 Designer 版本比 Server 版本更新,可能会出现哪些问题。

  • 此外,请查看下方提供的版本特定信息。

潜在的破坏性变更

可能导致问题的原因

受影响的具体方面

Python 升级

Designer 与 Server 不一致

使用 Python SDK 构建的工具可能需要更新。

  • 如果 Python 升级不影响 SDK 插件中使用的 Python 函数,一切可能正常工作。

  • Python 脚本中可能出错,因为函数不再兼容。这可能导致执行失败。

新的公式函数或工具选项

这些功能或工具选项在 Server 版本中不可用。

  • 使用较新版本 Designer 构建且使用了新函数的资产无法在较旧版本的 Server 上运行,并会在执行期间报错。

  • 未知工具选项将被忽略。

新工具或用户安装的 Designer 附加组件工具

新工具和用户安装的 Designer 附加组件在 Server 版本中不可用。

在执行过程中将显示一条错误消息,指示引用的工具未安装。

对现有工具配置的更改

Designer 版本和 Server 版本之间的预期功能差异。

用户未预期的操作可能会执行失败,或被静默执行。

2025.2 版本中的更新

阅读下文,查看 2025.2 版本中的主要更改列表。

现在,可将使用较新版本 Designer 生成的资产(工作流、分析应用程序、宏)用于较旧版本的 Server/Gallery。当您尝试执行此操作时,系统会显示一条警告消息,但您可以选择忽略警告继续。

警告

  • 在 2025.2 版本中,以前的 Designer-Server 版本兼容性限制仍然适用于工作流执行。也就是说,您无法执行在比 Server 更新版本的 Designer 中创建的工作流。

  • 2026.1 版本将是首个助您利用 Designer 与 Server 解耦优势的版本。也就是说,您可以将 Designer 升级到 2026.1,并在 Server 2025.2 中保存和执行 2026.1 工作流(注意潜在的执行影响)。

Designer 用户界面更新

如果 Designer 版本比 Server 版本新,则在以下情况下会向用户发出警告:

  • 当您添加的 Server/Gallery 连接其版本低于当前 Designer 版本时,您会收到一条警告。您仍然可以选择继续连接。

  • 当您尝试将资产从 Designer 上传到 Server 时,如果该资产是使用较新版本的 Designer 构建的,您将收到警告。您仍然可以选择继续上传。

此警告适用于工作流、分析应用程序和宏:

您正在连接或保存到的 Alteryx Server 的版本低于您当前 Designer 的版本。部分功能可能不受支持。

Server 管理员工作流视图

如果您尝试通过“管理员工作流”视图将资产直接上传到 Server UI,系统会显示一条警告,指出该资产是在较新版本的 Designer 中创建的。您可以继续。

此警告适用于工作流、分析应用程序和宏:

您上传到的 Alteryx Server 版本低于您的 Designer 版本。部分功能可能不受支持,或无法按预期工作。

工作流版本

一个工作流包 (YXZP) 可以包含多个工作流、分析应用程序和宏,但这些资源不一定都使用相同的工作流版本。

当您上传 YXZP 包(通过 REST API 或 Server 管理员界面)时,仅以包内的默认工作流进行版本校验。

Server REST API

当 Server 版本低于工作流版本时,如果您尝试通过 REST API 将资产直接上传到 Server,则可以绕过通常阻止此操作的防护机制。为此,请使用新的 bypassWorkflowVersionCheck 标志。如需了解详情,请转至工作流端点