SuperAPI AI 工具集

sf-integration

营销与增长

查看项目

更新于 10-15 19:50

技能介绍

用途:作为 Salesforce 集成架构技能,用于配置集成基础设施,包括 Named Credentials、Connected Apps、External Services、Platform Events、Change Data Capture(CDC)及认证流程,重点在元数据设置、安全配置与架构决策。范围边界:仅覆盖集成配置与元数据;Apex 调用代码模式(HttpRequest、@RestResource、SOAP、mock)属于 sf-apex 集成模式。

主要能力:

  1. Named Credentials:区分旧版(端点与认证合一)与增强版(External Credential 管认证、Named Credential 管端点)。增强版需通过 Permission Set 映射 externalCredentialPrincipalAccesses,否则调用报 NAMED_CREDENTIAL_NOT_FOUND;generateAuthorizationHeader 需为 true 才自动注入 OAuth 头。
  2. Connected Apps:定义 OAuth 客户端配置,含 scopes(Api、RefreshToken、OfflineAccess 等)、IP 放松策略(ENFORCE、BYPASS、BYPASS_WITH_VALID_BROWSER_SESSION)、刷新令牌有效期;支持 JWT Bearer 与 Web Server 流程。
  3. External Services:注册 OpenAPI 3.0 规范(上限 100 KB、最多 50 个操作),自动生成可在 Flow、Einstein Bots、Apex 中使用的可调用操作,认证由 Named Credential 处理。
  4. Platform Events:自定义事件总线,publishBehavior 可选 PublishAfterCommit(默认,回滚不触发)或 PublishImmediately;订阅方式含 Apex 触发器、平台事件触发 Flow、CometD 或 Pub/Sub API;支持 Replay ID 重放。
  5. CDC:自动将记录变更(CREATE/UPDATE/DELETE/UNDELETE)发布到 /data/<Object>ChangeEvent,含 ChangeEventHeader(changeType、changedFields、commitTimestamp、sequenceNumber 等)。
  6. 旧版 Outbound Messaging:仅由 Workflow Rules 触发,SOAP 格式,24 小时指数退避重试,建议迁移到 Platform Events。
  7. Remote Site Settings 迁移到 Named Credentials 的步骤与认证流程决策指南(JWT Bearer、Web Server、Auth Code + PKCE、Client Credentials、Device Flow、Refresh Token)。

使用方式:通过元数据文件(.namedCredential-meta.xml、.externalCredential-meta.xml、.connectedApp-meta.xml、.externalServiceRegistration-meta.xml、.object-meta.xml)配置,并在 Setup 中完成注册与权限映射。

限制与注意事项:同步事务最多 100 次调用;Platform Events 标准 5 万/小时、高容量 15 万/小时,至少一次投递需幂等;CDC 重放窗口 72 小时;Connected App 变更最多 10 分钟生效,证书过期会导致静默失败;调用超时单请求与单事务均最多 120 秒;同一事务中同步调用与 DML 需注意顺序。具体平台版本与可用对象范围暂未提供。