Salesforce

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域 ：      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域 ：      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域 ：      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）

连接器元数据
发布者	Microsoft

若要使用此集成，需要访问启用了 API 访问权限的 Salesforce 帐户。 若要查看 Salesforce 版本具有 API 访问权限，请查看 Salesforce 文章。 若要建立连接，请选择“ 登录”。 系统将提示你提供 Salesforce 登录名，按照屏幕的其余部分创建连接。 连接器当前使用的默认 API 版本为 v58.0。

现在，你已准备好开始使用此集成。

已知问题和限制

1. 对 Salesforce 查询可以包含的字段数有限制。 此限制因列的类型、计算列数等而异。收到错误“查询选择过多字段或筛选条件太复杂”时，这意味着查询超出了限制。 若要避免这种情况，请使用“选择查询”高级选项并指定真正需要的字段。
2. Salesforce 会话设置可以阻止此集成。 请确保将 “锁定会话锁定到其发起的 IP 地址” 处于禁用状态。
3. 应启用 Salesforce API 访问。 若要验证访问设置，请转到当前用户的配置文件设置并搜索“已启用 API”复选框。
4. Salesforce 试用帐户没有 API 访问权限，因此无法使用。
5. “选择列表（多选）”类型的自定义字段不受 “创建记录 ”和 “更新记录”（V3）作（ 包括其各自的已弃用版本）的支持。
6. 不支持使用 Salesforce“自定义域”登录创建新连接。
7. 应避免在参数中使用 Order By 可以为 null 的字段，因为这可能会在以下作中导致运行时错误： 获取记录、 创建记录时、 创建或修改记录时。
8. 修改记录 触发器时，只能检测标准对象的记录更改，但无法检测标准对象的附件更改。
9. 以下触发器和作无法在没有“ID”列的自定义表上正常运行： 创建记录时， 创建或修改记录时， 获取记录、 创建记录、 更新记录（V3）、 删除记录。
10. 创建或修改的触发器时 ，将同时返回新的和已修改的项。 若要检查返回的项是新的还是修改的，请比较其“CreatedDate”和“LastModifiedDate”字段值。 在新项上，这些值应相等。 在这方面，这两个字段对于应用此触发器的项是必需的。
11. 创建记录和更新记录（包括其各自的已弃用版本）不支持复杂对象（包括嵌套对象，请参阅下面的示例）。 若要解决此问题，应使用平面对象结构。
12. 执行 SOQL 查询 并 获取记录 作基于“查询”API。 因此，并非所有记录都可能由于 API 限制（例如已删除的项）而返回。
13. 如果在使用 更新记录（V3）将数据设置为默认值时遇到任何问题，这是因为标头“sforce-auto-assign”设置为 true。 若要解决此问题，建议使用 发送 HTTP 请求 作并将自定义标头值设置为“sforce-auto-assign： false”
14. Salesforce 连接器对身份验证有特殊处理，但由于 Salesforce 后端存在限制，如果长时间未使用令牌，并且用户可能面临“Bad_OAuth_Token/会话过期或无效”错误，令牌将过期。 请使用凭据重新登录。
    • 现在解决了此限制，但必须创建新的连接才能使用。 预先存在的连接仍然有效，但可能面临上述问题。

不支持的复杂对象的示例，因为它具有具有具有MerchandiseExtID__c字段的嵌套对象：

{
    "Name" : "LineItemCreatedViaExtID",
    "Merchandise__r" :
    {
        "MerchandiseExtID__c" : 123
    }
}

上述复杂对象重写为 IS 支持的平面对象的示例：

{
    "Name" : "LineItemCreatedViaExtID",
    "MerchandiseExtID__c" : 123
}

上传附件

Salesforce API 支持上传以下对象的附件：“Account”、“Asset”、“Campaign”、“Case”、“Contact”、“Contract”、“Custom objects”、“EmailMessage”、“EmailTemplate”、“Event”、“Lead”、“Opportunity”、“Product2”、“Solution”、“Task”。 若要上传附件文件，请使用 “创建记录 ”作并参阅 Salesforce 文档页 ，了解必填字段和参数的含义。

适用于 Salesforce 的 Power Apps 可委派函数和作

对于给定的数据类型，这些 Power Apps作可以委托给 Salesforce 进行处理（而不是在 Power Apps 中本地处理）。

顶级函数

	Delegable
平均值	否
过滤器	是的
LookUp	是的
麦克斯	否
最小值	否
搜寻	是的
排序	是的
SortByColumns	是的
总和	否

Filter 和 LookUp 谓词

	Salesforce
Not	是的
IsBlank	否
TrimEnds	否
Len	否
+, -	否
<、<=、=、<>、>>=	是的
和 （>）， 或 （||）， 不是 （！）	是的
in	是的
StartsWith	否

连接器深入

有关连接器的详细信息，请参阅 深入部分。

常规限制

Name	价值
连接器并发处理的最大请求数	50

正在创建连接

连接器支持以下身份验证类型：

使用自定义 Salesforce 登录 URI 登录	使用自定义 Salesforce 登录 URI 登录	仅限美国政府（GCC）	可共享
使用 Salesforce 帐户登录	提供 Salesforce 凭据以登录。	所有区域	可共享
默认值 [已弃用]	此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。	所有区域	不可共享

使用自定义 Salesforce 登录 URI 登录

身份验证 ID：CustomLoginURIAuth

适用：仅限美国政府（GCC）

使用自定义 Salesforce 登录 URI 登录

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
Salesforce 登录 URI	字符串	https://custom-domain-or-instance.my.salesforce.com	True
Salesforce API 版本	字符串	Salesforce API 版本。 对于默认值，请留空或使用 v58.0

使用 Salesforce 帐户登录

身份验证 ID：BasicAuthentication

适用：所有区域

提供 Salesforce 凭据以登录。

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
登录 URI （环境）	字符串	Salesforce 登录 URI。 对于生产，请留空或使用 https://login.salesforce.com
Salesforce API 版本	字符串	Salesforce API 版本。 对于默认值，请留空或使用 v58.0

默认值 [已弃用]

适用：所有区域

此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
登录 URI （环境）	字符串	Salesforce 登录 URI。 对于生产，请留空或使用 https://login.salesforce.com
Salesforce API 版本	字符串	Salesforce API 版本。 对于默认值，请留空或使用 v58.0

限制

名称	调用	续订期
每个连接的 API 调用数	900	60 秒

操作

Salesforce 的 MCP 服务器	Salesforce 的 MCP 服务器
上传作业数据	使用 CSV 数据上传作业的数据。
从 Salesforce 获取 Case 记录	此作从 Salesforce 获取 Case 记录。
从 Salesforce 获取产品记录	此作从 Salesforce 获取 Product 记录。
从 Salesforce 获取商机记录	此作从 Salesforce 获取商机记录。
从 Salesforce 获取帐户记录	此作从 Salesforce 获取帐户记录。
从 Salesforce 获取用户记录	此作从 Salesforce 获取用户记录。
从 Salesforce 获取联系人记录	此作从 Salesforce 获取 Contact 记录。
关闭或中止作业	关闭或中止作业。 使用 UploadComplete 关闭作业，或中止作业。 如果关闭作业，Salesforce 会将作业排入队列并上传数据进行处理，并且无法添加任何其他作业数据。 如果中止作业，则作业不会排队或处理。
创建作业 [已弃用]	此作已弃用。 请改用“创建作业”（V2）。 创建一个作业，该作业表示发送到 Salesforce 进行异步处理的批量作（和相关数据）。 通过上传作业数据请求提供作业数据。
创建作业 （V2）	创建一个作业，该作业表示发送到 Salesforce 进行异步处理的批量作（和相关数据）。 通过上传作业数据请求提供作业数据。
创建记录	此作将创建记录并允许 null 值。
创建记录 [已弃用]	此作将创建记录。
删除作业	删除作业。 若要删除，作业必须具有 UploadComplete、JobComplete、Aborted 或 Failed 的状态。
删除记录	此作将删除记录。
发送 HTTP 请求	构造要调用的 Salesforce REST API 请求
执行 SOQL 查询	执行 SOQL 查询。
执行 SOSL 搜索查询	执行指定的 SOSL 搜索 qyery
按外部 ID 插入或更新记录 （Upsert） [已弃用]	此作已弃用。 请改 用“插入”或“更新”（Upsert）外部 ID（V2）记录 。 此作使用外部 ID 插入或更新记录（upserts）。
按外部 ID 插入或更新（Upsert）记录（V2）	此作使用外部 ID 插入或更新记录（upserts）。
按外部 ID 获取记录	此作使用外部 ID 检索记录。
更新记录 [已弃用]	此作已弃用。 请改用更新记录（V3）。 此作将更新记录并允许 null 值。
更新记录 [已弃用]	此作将更新记录。
更新记录 （V3）	此作将更新记录并允许 null 值。
获取作业信息	检索有关作业的详细信息。
获取作业结果	根据已完成作业的结果类型检索记录列表。
获取对象类型	此作列出了可用的 Salesforce 对象类型。
获取所有作业	获取所有作业的列表
获取记录	此作获取特定 Salesforce 对象类型的记录，例如“潜在顾客”。
获取记录	此作获取记录。
获取记录 [已弃用]	此作已弃用。 请改用 Get 记录 。 此作获取记录。

Salesforce 的 MCP 服务器

上传作业数据

从 Salesforce 获取 Case 记录

从 Salesforce 获取产品记录

从 Salesforce 获取商机记录

从 Salesforce 获取帐户记录

从 Salesforce 获取用户记录

从 Salesforce 获取联系人记录

关闭或中止作业

创建作业 [已弃用]

创建作业 （V2）

创建记录

创建记录 [已弃用]

删除作业

删除记录

发送 HTTP 请求

执行 SOQL 查询

执行 SOSL 搜索查询

按外部 ID 插入或更新记录 （Upsert） [已弃用]

按外部 ID 插入或更新（Upsert）记录（V2）

按外部 ID 获取记录

更新记录 [已弃用]

更新记录 [已弃用]

更新记录 （V3）

获取作业信息

获取作业结果

获取对象类型

获取所有作业

获取记录

获取记录

获取记录 [已弃用]

触发器

修改记录时	当有新修改的记录时，此作将触发。
创建记录时	当有新创建的记录时，此作将触发。

修改记录时

创建记录时

定义

CreateJobResponse

Table

TablesList

GetAllJobsResponse

JobInfo

CheckJobResponse

SOSLSearchQueryResponse

SearchRecordObject

ObjectWithoutType

MCPQueryResponse

字符串

对象