Skip to main content

Salesforce

Salesforce 连接器助您在 Designer 中连接至 Salesforce。使用单一连接器从 Salesforce 对象读取数据并将数据写回 Salesforce，该连接器在 Alteryx Designer (Desktop) 和 Alteryx One (Cloud) 中的运行方式完全相同。

Salesforce 既可在输入数据工具和输出数据工具中作为数据源，也可作为独立的 Salesforce 输入和Salesforce 输出工具使用。

Designer 中的新连接器版本

Salesforce 连接器现在是 Alteryx One 连接器体验的一部分。请仔细阅读此页面上的信息，以确保您正确使用相应的工具。

如果您想更新 Designer 工作流中的 Salesforce 连接器，可以使用工作流迁移实用程序。

开始之前

从 Alteryx Marketplace 下载并安装 Salesforce。

Salesforce 连接器设置

Salesforce 适用于 Designer 2025.1.2 补丁 7 或更高版本。如果您之前曾使用过 Salesforce 连接器，请参阅迁移至统一连接器。

先决条件

继续之前，请确保您已满足以下前提条件：

要求

详情

Designer 版本

  • 2025.1 补丁 5、2025.2 补丁 3 或 2026.1 及更高版本（除内置和自定义 OAuth 之外的所有功能）

  • 2025.1.2 补丁 7、2025.2.1 补丁 5 或 2026.1 补丁（所有身份验证方法）

自定义应用 (OAuth 2.0) 设置（若使用）

包含客户端 ID、客户端私密密钥、重定向 URI（必须与已连接应用匹配）和作用域的 Salesforce 已连接应用

环境 URL

生产（默认）、沙盒或自定义域

DCM

请务必在 Designer 中启用 DCM。请转至选项 > 高级设置 > DCM 以启用此功能

安装连接器

您可以轻松地从 Designer 通过附加组件安装最新版本的 Salesforce 连接器。这是推荐的安装方法，助您在无需离开 Designer 或访问 Alteryx Marketplace 的情况下浏览、安装和更新连接器。

要安装连接器…

  1. 在 Designer 中，转至附加组件 > 管理 Marketplace 附加组件。您将看到可用连接器列表。

  2. 选择 Salesforce 连接器，然后选择安装。Designer 将下载并安装该软件包。Designer 可能需要重新启动以完成安装。

  3. 在安装和设置完成后，Salesforce 连接器即可在“输入数据”和“输出数据”工具中使用。

请设置连接

如需使用 DCM 连接到 Salesforce...DCM - Designer

  1. 将输入数据或输出数据工具拖到画布上，然后选择连接到数据。

  2. 在连接器设置中，选择创建或浏览数据连接。

    如果您之前已创建过 Salesforce 连接，可以从最近选项卡中选择该连接。

  3. 选择 + 新建。从技术列表中，选择 Salesforce。

  4. 选择快速连接，然后选择设置连接。此时将打开连接窗口。

  5. 选择 + 新建。

  6. 指定连接名称和数据源名称。选择环境。

  7. 在凭证部分中，选择您的身份验证方法，并输入凭证名称。如需了解详情，请参阅身份验证方法。

  8. 选择保存。

  9. 选择连接。Salesforce 可能会请求身份验证。

  10. 在文件浏览器窗口中选择要读取或写入的文件。

  11. 在选项窗口中选择读取或写入配置。

  12. 选择确认以创建与该文件的连接。您可以继续构建您的工作流。

迁移至统一连接器

如果您已在 Alteryx 中使用 Salesforce 连接器，请阅读以下部分。其中将详细介绍统一版本中的变更内容。

参数

传统连接器

统一连接器 (v6.1.0)

平台和工具

Desktop（输入和输出）

Cloud（仅输入）

Desktop（输入和输出）

Cloud（输入和输出功能尚在开发中）

框架

Python SDK (Desktop)

CData ODBC 驱动程序 (Cloud)

EACD 框架（Desktop 和 Cloud）

通信 / API

Salesforce API v52 (Summer '21)

Salesforce API v61+ (Summer '24)

身份验证方法

OAuth 2.0

用户名 + 密码 + 安全令牌

相同的身份验证方法，但支持扩展配置

连接模型

独立的生产/沙盒/自定义 URL 选项

DCM，提供单个“环境 URL”字段

关键变更

  • 生产、沙盒和自定义 URL 下拉选项已被单个环境 URL 字段所替代。请重新配置使用此下拉列表的任何工作流。

  • “环境 URL”将替换旧的下拉列表：https://login.salesforce.com（生产，默认）、https://test.salesforce.com（沙盒）或您的自定义域。

  • Salesforce 凭证身份验证现在还需要客户端 ID 和客户端私密密钥。

  • 在 Desktop 上，自定义域现在适用于所有身份验证方法（此前仅限 OAuth）。

您可以使用 Designer 2025.2 补丁 3 或更高版本中的 Alteryx 工作流迁移实用程序来迁移现有工作流。如需了解更多信息，请参阅工作流迁移实用程序。

注意

  • 工作流迁移实用程序仅限在 Desktop 上运行。

  • 安装统一连接器后，您可能会在管理连接中同时看到列出的传统 Salesforce 技术和统一 Salesforce 技术。这是过渡期间的正常预期情况。请使用统一连接器来开展任何新工作。

关于 Salesforce 连接器

输入和输出工具

Salesforce 输入和输出工具用于从 Salesforce 读取数据并将数据写回 Salesforce。

Salesforce 输入

Salesforce 输入工具用于读取标准对象和自定义对象。您可以通过以下三种方式进行读取：

  • 查询构建器：选取一个对象，然后选择您要读取的字段。字段选取器提供多选列表，支持全选、按字符串或子字符串进行搜索、显示已选字段数与总字段数的实时计数，以及仅显示已选内容的筛选器。此外，您还可以设置记录数限制。有四种字段模式可用：读取所有标准字段、读取所有自定义字段、读取所有字段和手动选择。

  • 自定义查询 (SOQL)：编写 SOQL 查询以读取标准对象和自定义对象（包括 __r 关系字段），并在运行前对其进行验证。自定义查询始终返回单表。

  • 从报告中读取：浏览并搜索已保存的报告，选择其中一个报告，然后解析其结果。

Salesforce 输出

Salesforce 输出工具用于将行写入标准对象或自定义对象。选择以下操作之一：

  • 插入：添加新记录。

  • 更新：修改现有记录。需要 Salesforce 记录 ID。

  • 删除：移除记录。需要 Salesforce 记录 ID。

  • 更新/插入：在单次操作中同时插入新记录并更新现有记录。

输出工具支持批量处理记录，并允许您自行选择 Salesforce API 版本。当您使用更新、删除或更新/插入时，请在您的数据中包含记录 ID 作为主键。

对象模型

Salesforce 将数据存储在对象中，这些对象的作用类似于数据库表：

  • 标准对象为系统内置对象，例如账户、联系人、线索、商机、个案、市场活动、任务、事件和用户。

  • 自定义对象在您的组织中创建并以 __c 结尾，例如 Invoice__c。

  • 对象之间的关系字段使用 __r 后缀，并可以在 SOQL 中引用。

身份验证方法

Salesforce 支持三种身份验证方法。请参考下表，为您的使用案例选择合适的身份验证方法。

方法

必填字段

Desktop（旗舰版）

Cloud (Alteryx One)

内置应用 (OAuth 2.0)

无

是

不可用（Cloud 上不提供内置连接创建）

自定义应用 (OAuth 2.0)

客户端 ID、客户端私密密钥、重定向 URI（默认为 http://localhost:1717/）和作用域（默认为 api offline_access）

是

是

Salesforce 凭证（用户名、密码、安全令牌）

用户名、密码、安全令牌（可选）、客户端 ID、客户端私密密钥

是

是

适用于所有方法的自定义域

NA

是

不可用（Cloud 上的所有方法均不支持自定义域）

 

OAuth 既支持授权码流（用户到应用），也支持客户端凭证流（服务主体，用于无头或计划的自动化）。

限制

  • 该连接器不支持对读取操作或自定义查询进行试运行。请运行工作流以检索数据，或在真正执行前通过 SOQL 验证步骤检查该自定义查询。

  • 对于具有超过 200 个字段的对象，读取所有自定义字段和读取所有字段模式未能生效。请改用手动选择选取所需的字段，或编写明确列出对应特定字段的 SOQL 自定义查询。

  • SOQL 自定义查询始终仅返回单表。若要合并来自多个对象的数据，请在 SOQL 查询内部将其进行连接，或使用多个输入工具并在工作流中对所得结果进行混合。

  • 从报告中读取功能仅支持针对每个输入选择单个报告工具。若需读取多个报告，请使用多个输入工具。

  • 该连接器调用 Salesforce REST API。目前尚未支持 Salesforce Bulk API。对于高数据量级的读取或写入操作，预计将受到 REST API 吞吐量及 Salesforce API 限额的约束。

  • 对象和字段数据预览在 Cloud 上可用，但在 Desktop 上则不可用。在 Desktop 上，请使用查询构建器字段列表或 SOQL 查询来配置字段。

  • 在 Cloud 上，并不具备对所有身份验证方法的自定义域支持。请为您的 Cloud 连接使用所支持的方法，或者改从支持将自定义域应用于所有方法的 Desktop 进行连接。

  • 工作流迁移实用程序仅在 Desktop 上运行。

  • 在 Cloud 上，不再提供内置应用连接的创建流程。请在 Cloud 上使用自定义 OAuth 应用或 Salesforce 凭证。

  • 从同一对象生成的数据类型在 Cloud 和 Desktop 之间可能会存在差异。

  • 在 Cloud 上，对于某些对象可能会出现未能成功加载数据集的情况。如果某一特定对象未能成功加载，请尝试对该对象采用 SOQL 自定义查询或减少已选字段数量。

  • 该连接器已在 Desktop 上正式对外发布。Cloud 支持尚在开发中，目前还未正式对外发布 (GA)。

Salesforce 连接器发行说明

Salesforce 版本 6.1.0

连接器发行版本 6.1.0

版本

描述

v6.1.0

  • 所有身份验证方法均需要 Designer 2025.1.2 补丁 7、2025.2.1 补丁 5、2026.1 补丁 2 或 2026.2 GA。

  • 使用 DCM 并通过 Salesforce API v61+（2024 年夏季）进行通信。

  • 基于 DCM 的连接，具备简化的连接设置（单个环境 URL，以及暴露重定向 URI和作用域的自定义 OAuth）。

  • 输入：

    查询构建器：字段全选、搜索、计数、筛选、记录限制。

    从报告中读取，且无记录上限。

    支持校验的 SOQL 自定义查询。

    选择 API 版本。

  • 输出

    插入、更新、删除和新的更新插入操作。

    批处理

    选择 API 版本。

  • 已修复从 Salesforce 报告中读取记录时受限于固定数量 (2000) 的问题。此功能仅在使用标准 REST API 时有效。

  • 已修复 DateTime 值返回为 00:00:00 的问题，目前已正确处理空值。

  • 列列表中现已提供全选功能。

  • 重复使用空闲的自定义 OAuth DCM 连接不再因令牌错误而失败。

  • 内置应用 OAuth 现在可以正确进行身份验证。

  • 在云端，某些对象的数据集加载可能会失败。

  • 针对 Salesforce 自定义查询，已禁用“按架构预览”。

Salesforce 独立连接器

连接类型

Alteryx 工具。最新版本可从 Alteryx Marketplace 获得。

支持类型

读取与写入

已验证版本

ODBC 客户端版本 2.2.20 也可用于输入和输出数据工具。

Salesforce 工具发行说明

版本

描述

v5.1.4

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 在 Alteryx Server 上运行此连接器需要 DCM。

  • Salesforce 连接器将时间和日期时间精度默认设为毫秒，以避免末尾出现多余的零，但若工作流有需求，仍支持纳秒级分辨率。（TPM-4753、TPM-4736）

  • 修复了 Salesforce 工具在 Server 上忽略代理设置的问题。(TPM-4647)

  • 修复了由于 Salesforce 工具依赖 Designer 的访问令牌，导致 Server 无法运行相关工作流的问题。(TPM-4846)

  • 修复了 Designer 开发工具在返回的 JSON 文件中暴露机密值的问题。(TPM-4788)

v5.1.3

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 在 Alteryx Server 上运行此连接器需要 DCM。

  • 增加了使用 DCM 时对自定义 Salesforce 域的支持。

  • 改进了身份验证。

  • 已将 SDK 更新至 2.4.2 版。

  • 已将 API 更新为最新版本。

  • 修复了在使用 DCM 时 Salesforce 工具忽略 PAC 脚本的问题。(TPM-4620)

  • 修复了 Salesforce 输入工具无法读取某些日期类型列的问题。(TPM-4604)

  • 修复了 Salesforce 输出工具无法显示更新操作的字段映射的问题。(TPM-4519)

  • 修复了如果未在 DCM 中创建安全令牌，Salesforce 工具显示“访问被拒绝”的问题。(TPM-4507)

  • 修复了 Salesforce 工具未根据前端标签对齐 API 版本的问题。(TPM-4493)

  • 修复了 Salesforce 工具无法使用自定义域进行连接的问题。(TPM-4488)

  • 修复了 Salesforce 工具会针对时间戳意外截断发出警告的问题。(TPM-4368)

  • 修复了当在自定义 SOQL 查询中使用嵌套关系对象时，Salesforce 输入工具会将值截断的问题。(TPM-4367)

  • 修复了如果工作流包含多个 Salesforce 输出工具，Salesforce 输出工具会无限期运行的问题。(TPM-4268)

  • 修复了 Salesforce 工具将多个 API 版本显示为可选选项的问题。(TPM-4264)

  • 修复了 Salesforce 输出工具无法使用插入和更新操作写入数据的问题。(TPM-4248)

  • 修复了 Salesforce 工具无法正确读取百分比数据类型的问题。(TPM-4174)

  • 修复了 Salesforce 工具在处理自定义日期字段时返回错误的问题。(TPM-4051)

  • 修复了 Salesforce 工具返回“错误代码 400：请求语法错误或方法不受支持”的问题。(TPM-3982)

  • 修复了导致 Salesforce 工具运行缓慢的问题。(TPM-3919)

  • 修复了 Salesforce 输入工具将 VersionData 字段返回为 URL 而不是文档正文的问题。(TPM-3662)

已知问题

  • Salesforce 工具升级到新版本后，某些字段显示为 Null。(TPM-4805)

  • SDK 连接器忽略服务器上的代理 (Gallery)。(TPM-4647)

  • Designer HMTL 开发工具在返回的 JSON 中公开密钥值。(TPM-4788)

  • Salesforce 输入工具中的查询返回 Null 记录。(TPM-4641)

v5.1.2

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 在 Alteryx Server 上运行此连接器需要 DCM。

  • 已更新为在 Designer 和 Server 2024.1 上运行。

  • 修复了 Salesforce 输入在运行 45 分钟后出现故障的问题。(TPM-3556)

  • 修复了缺少来源和描述元数据的问题。(TPM-3486)

  • 修复了 Salesforce 工具忽略代理设置的问题。(TPM-3358)

  • 修复了 Salesforce 输入工具返回“错误代码 401：无权限 - 请查看授权方案”错误的问题。（TDCE-449 和 TDCE-361）

v5.1.1

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 在 Alteryx Server 上运行此连接器需要 DCM。

  • 已更新为在 Designer 和 Server 2024.1 上运行。

  • 修复了通过自定义 OAuth 应用程序进行身份验证不起作用的问题。(TFLN-1912)

  • 修复了 Salesforce 输入在配置为读取空数据集时无限期运行的问题。(TPM-2453)

已知问题

  • Salesforce 工具 5.1.1 无法在 Designer FIPS 和 Server FIPS 上运行。要解决此问题，请使用 5.1.0 版本。(TFLN-1982)

  • 工作流结果中当前缺少来源和描述元数据。(TPM-3486)

v5.1.0

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 增加了对 DCM 至 Salesforce 输出的支持。

  • 在 Alteryx Server 上运行此连接器需要 DCM。

  • Salesforce 输出现在符合 FIPS 标准。

  • 提升了自动配置功能的性能。

  • 在 Salesforce 输入中添加了试运行选项。

  • 修复了 Salesforce 输入 5.0.10 错误解析数据类型的问题。(TFLN-1676)

v5.0.10

  • 与 Designer 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 仅与 AMP Engine 兼容。

  • 增加了对 DCM 的支持。

    • 在 Alteryx Server 上运行此连接器需要 DCM。

  • FIPS 功能。

  • 添加了对 OAuth 身份验证和自定义域的支持。

  • 修复了 Salesforce 输入未显示所有字段和对象的问题。(TPM-1579)

  • 修复了 Salesforce 输入错误解析 PAC 文件的问题。(TFLN-1243)

  • 修复了当 Designer 语言设为法语时 Salesforce 输入不显示配置窗口的问题。(TDCE-119)

已知问题

  • 报告仅列出最近的报告，而不是列出所有可供用户使用的报告。

  • 报告仅返回前 2000 条记录。

v4.2.4

  • 修复了自定义查询无法通过 Salesforce 输入工具解析的缺陷。

  • 从命令行计划或运行 Salesforce 输入作业时，这些作业将不再失败。

  • 使用 Salesforce 输入工具中的证书验证来修复缺陷。

  • 支持在没有令牌的情况下，将 Salesforce 输入工具上传至 Gallery。

v4.1.0

  • 已添加对使用自动检测和配置通过代理进行连接的支持。

  • 与 Alteryx 2019.2 版本及更高版本兼容。

v4.0.0

  • 已添加查询 Salesforce 报告的功能。

  • 默认情况下，查询生成器和自定义查询返回所有记录（包括已删除的记录）。

  • 在 WHERE 子句中添加“IsDeleted=False”以排除已删除的记录。

  • 与 Alteryx 2018.3 - 2019.2 版本兼容。

v3.1

  • 修复了工作流配置的“运行时”选项卡下的“记录限制”和包含 XML 特殊字符的密码的缺陷。

  • 与 Alteryx 11.0 - 2018.2 版本兼容。

Salesforce 输出工具（已弃用）说明

版本

描述

v1.3.1

  • 已更新工具元信息。

v1.3

  • 更新了宏指令引擎中的 Salesforce API 版本。

  • 修复了错误以正确转义字符。

v1.2

  • 日期时间字段会自动转换为 YYYY-MM-DDThh:mm:ss.sss。

  • 修复了即使用户尚未登录，仍会出现“需要表格名称”和“需要输出操作”错误消息的问题。

注意

  • 确保您为包含 Salesforce 输入工具 2.2.0 版及更高版本的工作流启用了 AMP Engine。

  • 若要为此工具设置自定义 API 应用，请参阅此指南。

  • 如果要处理通过多个代理 IP 路由请求的 PAC 文件，请使用安全令牌。

自定义 Salesforce 域

Salesforce 工具支持自定义 Salesforce 域。

要手动连接到自定义域...

  1. 在 Salesforce 工具配置窗口中，选择使用自定义环境 url。

  2. 在自定义环境中输入您的自定义域。

使用 DCM 连接到自定义域...

  1. 选择设置连接。DCM 打开。

  2. 选择 + 新建。“新数据源”窗口打开，其中预先选择了 Salesforce 技术。

  3. 在环境中选择自定义。

  4. 在自定义环境中输入您的自定义域，然后选择保存。

本节内容如下: