通过

Salesforce 对象

概要

条目 DESCRIPTION
发布状态 一般可用性
产品 Excel
Power BI （语义模型）
Power BI （数据流）
Fabric（Dataflow Gen2）
Power Apps（数据流）
Dynamics 365 Customer Insights
Analysis Services
支持的身份验证类型 Salesforce 帐户

注释

由于部署计划和主机特定的功能，某些功能可能存在于一个产品中，但不是其他功能。

警告

默认情况下，Salesforce 不支持 Internet Explorer 11，它用作 Power Query Desktop 中联机服务的身份验证体验的一部分。 选择使用 Microsoft Internet Explorer 11 访问闪电体验的扩展支持。 你可能还想要查看有关 配置 Internet Explorer 的 Salesforce 文档。 此时，用户无法进行身份验证，但存储的凭据应继续工作，直到其现有身份验证令牌过期。 若要解决此问题，请转到 在 Power BI Desktop 中为 OAuth 身份验证启用 Microsoft Edge （Chromium）。

先决条件

若要使用 Salesforce 对象连接器，必须具有 Salesforce 帐户用户名和密码。

此外，应启用 Salesforce API 访问。 若要验证访问设置，请转到个人 Salesforce 页面，打开配置文件设置，然后搜索并确保选中 “启用 API ”复选框。 请注意，Salesforce 试用帐户没有 API 访问权限。

支持的功能

  • 生产
  • 自定义警报
    • 自定义域
    • CNAME 记录重定向
    • 关系列

从 Power Query Desktop 连接到 Salesforce 对象

连接到 Salesforce 对象数据：

  1. 从产品特定的数据连接器列表中选择 Salesforce 对象 ，然后选择 “连接”。 有关详细信息，请访问 何处获取数据。

  2. 在 Salesforce 对象中，如果使用 Salesforce 生产 URL （https://www.salesforce.com） 登录，请选择生产 URL。

    “获取数据”对话框的屏幕截图，其中选择了生产 URL。

    还可以选择“ 自定义 ”并输入用于登录的自定义 URL。 此自定义 URL 可能是你在 Salesforce 中创建的自定义域，例如 https://contoso.salesforce.com。 如果使用重定向到 Salesforce 的自己的 CNAME 记录，也可以使用自定义 URL 选择。 当前自定义 URL 仅支持 salesforce.com 和 cloudforce.com 域。

    注释

    不支持 Lightning URL。

    此外，还可以选择“ 包括关系列”。 此选择通过包括可能与其他表具有外键关系的列来更改查询。 如果未选中此框，则看不到这些列。

    选择 URL 后，选择“ 确定 ”继续。

  3. 选择 “登录 ”以登录到 Salesforce 帐户。

    Salesforce 帐户的登录对话框的屏幕截图。

    成功登录后，选择 Connect。

  4. 如果首次使用特定应用登录，系统会要求你输入发送到电子邮件地址的代码来验证真实性。 然后，系统会询问你是否希望你使用的应用来访问数据。 例如，系统会询问你是否希望允许 Power BI Desktop 访问 Salesforce 数据。 选择“允许”。

  5. 在 “导航器 ”对话框中，选择要加载的 Salesforce 对象。 然后，可以选择“ 加载 ”以加载数据，或选择“ 转换数据 ”以转换数据。

在 Power Query Online 中连接 Salesforce 对象

连接到 Salesforce 对象数据：

  1. 从产品特定的数据连接器列表中选择 Salesforce 对象 ，然后选择 “连接”。 有关详细信息，请访问 何处获取数据。

  2. 在 Salesforce 对象中，选择要用于连接的 URL。 如果您使用 Salesforce 生产环境 URL（）登录，请选择生产环境 URL。

    “连接到数据源”窗口的屏幕截图，可在其中添加 Salesforce 对象连接信息。

    注释

    目前，可能需要选择 “自定义 URL”，在文本框中输入 https://www.salesforce.com ，然后选择 “生产 ”以连接到数据。

    还可以选择“ 自定义 ”并输入用于登录的自定义 URL。 此自定义 URL 可能是你在 Salesforce 中创建的自定义域，例如 https://contoso.salesforce.com。 如果使用重定向到 Salesforce 的自己的 CNAME 记录，也可以使用自定义 URL 选择。

    此外，还可以选择“ 包括关系列”。 此选择通过包括可能与其他表具有外键关系的列来更改查询。 如果未选中此框，则看不到这些列。

  3. 如果首次建立此连接，请选择本地数据网关（如果需要）。

  4. 选择 “登录 ”以登录到 Salesforce 帐户。 成功登录后，选择“ 下一步”。

  5. 在 “导航器 ”对话框中，选择要加载的 Salesforce 对象。 然后选择“ 转换数据 ”以转换数据。

指定 Salesforce API 版本

我们需要指定受支持的 Salesforce API 版本才能使用 Salesforce 连接器。 为此，可以使用 Power Query 高级编辑器修改查询。 例如，Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48])。

如果指定了 Salesforce 不支持的版本，则会遇到一条错误消息，指出你指定了不支持的 ApiVersion。

有关 Salesforce API 版本和支持的详细信息，请访问 Salesforce 网站。

已知问题和限制

  • 如果 Salesforce Objects 连接器的结果中缺少表，原因之一可能是必须指定 ApiVersion 或将其更新到 Salesforce 支持的版本。 若要指定或更新 ApiVersion，请使用高级编辑器并显式添加 ApiVersion 参数。 例如：

    Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

    Salesforce 会定期弃用 ApiVersions，因此请确保指定 Salesforce 支持的 ApiVersion。

  • 对 Salesforce 查询可以包含的字段数有限制。 此限制因列的类型、计算列数等而异。 收到 Query is either selecting too many fields or the filter conditions are too complicated 错误时，这意味着查询超出了限制。 若要避免此错误，请使用 “选择查询 高级”选项并指定真正需要的字段。

  • Salesforce 会话设置可以阻止此集成。 确保禁用锁定会话到其发起的 IP 地址的设置。

  • 应启用 Salesforce API 访问。 若要验证访问设置，请转到当前用户的配置文件设置并搜索 “启用 API” 复选框。

  • Salesforce 试用帐户没有 API 访问权限。

  • “创建记录”和“更新记录”操作不支持类型为 Picklist (Multi-Select) 的自定义字段。

  • 不支持 Lightning URL。

  • 自定义 URL 仅支持 salesforce.com 和 cloudforce.com 域。 使用其他域会导致“参数无效”错误。

  • Salesforce 限制单个帐户可以执行的并发查询数。 “INVALID_QUERY_LOCATOR”错误 这是 Salesforce 限制，在使用同一帐户对 Salesforce 进行多个并发查询时，可能会遇到此限制。 此限制包括使用 Salesforce API 的所有客户端应用程序（而不仅仅是 PowerQuery 连接器）。 若要降低此错误的可能性：

    • 确保 Salesforce 查询数保持在最小值。
    • 使用可用选项（如数据流）来暂存 Salesforce 中的数据。
    • 确认不会同时计划具有相同帐户的 Salesforce API 的其他用法。

有关 Salesforce 内部 API 限制的详细信息，请转到 Salesforce 开发人员限制和分配快速参考。

  • Last updated on