Bitzsoft.Integrations.Salesforce 1.0.0-alpha.10

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher.
This is a prerelease version of Bitzsoft.Integrations.Salesforce. 
dotnet add package Bitzsoft.Integrations.Salesforce --version 1.0.0-alpha.10
                    


                    

                
NuGet\Install-Package Bitzsoft.Integrations.Salesforce -Version 1.0.0-alpha.10
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Bitzsoft.Integrations.Salesforce" Version="1.0.0-alpha.10" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Bitzsoft.Integrations.Salesforce" Version="1.0.0-alpha.10" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Bitzsoft.Integrations.Salesforce" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Bitzsoft.Integrations.Salesforce --version 1.0.0-alpha.10
                    


                    

                
#r "nuget: Bitzsoft.Integrations.Salesforce, 1.0.0-alpha.10"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Bitzsoft.Integrations.Salesforce@1.0.0-alpha.10
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Bitzsoft.Integrations.Salesforce&version=1.0.0-alpha.10&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Bitzsoft.Integrations.Salesforce&version=1.0.0-alpha.10&prerelease
                    


                            Install as a Cake Tool

Bitzsoft.Integrations.Salesforce

Salesforce Sales Cloud 多租户连接器，目标框架为 net5.0;net8.0;net10.0。

安装

dotnet add package Bitzsoft.Integrations.Salesforce

已实现能力

  • External Client App OAuth 2.0 JWT Bearer；
  • RS256、短生命周期 assertion 与一次性 jti；
  • Production、Sandbox、My Domain 和显式可信私有代理 profile；
  • token 返回 instance_url 的 HTTPS / host 信任边界；
  • 按租户、profile、登录入口和凭据隔离的 single-flight token 缓存；
  • 401 INVALID_SESSION_ID 一次失效刷新重放；
  • Sforce-Limit-Info API 使用量解析。
  • Account / Contact 固定对象、受验证字段的强类型查询；
  • 自定义字段完整原始 JSON，以及不透明 nextRecordsUrl 分页；
  • 绑定租户、profile、对象与 API 版本的短期分页游标；
  • Account 自定义 External ID 的幂等 upsert。
  • Account / Contact 的闭合 SystemModstamp,Id keyset 变更读取；
  • Account / Contact 官方 Get Deleted 删除日志与实际覆盖水位。
  • Account / Contact 可暂停恢复的 Full 与 Incremental Sync；
  • 删除日志先行、窗口自适应缩小和完整 Full 后 reconcile。

token 请求和响应正文按凭据显式禁止进入 RequestLogging；普通业务请求和 响应不设置强制日志大小上限，也不修改实际 payload。

凭据与注册

凭据字段：

ClientId
Username
PrivateKeyPem

固定 profile 注册示例：

services.AddBitzsoftSalesforce(
    SalesforceEndpointProfile.Sandbox,
    new[]
    {
        new SalesforceSyncProfile(
            "Accounts",
            SalesforceSyncObject.Account),
        new SalesforceSyncProfile(
            "Contacts",
            SalesforceSyncObject.Contact)
    });

复杂多租户宿主使用 AddBitzsoftSalesforce<TEndpointProfileResolver, TSyncProfileResolver>()， 凭据仍由宿主的 IIntegrationCredentialResolver 按每次请求上下文解析。

查询与写入边界

查询不接受任意 SOQL。默认字段避开依赖 State and Country/Territory Picklists 的 *StateCode / *CountryCode；已启用该功能的组织可把它们 作为受验证附加字段请求。服务端 query locator 最长只按约两天的临时游标 处理，跨租户、跨对象、跨 profile 或过期游标会在发请求前拒绝。

Account upsert 只允许明确支持的标准字段和 __c 自定义字段；External ID 字段必须为客户创建的唯一 __c 字段，正文必须包含非空 Name，从而保证 目标不存在时也可创建。

变更读取把最多 2,000 条的逻辑页固定在闭合时间上界内；即使 Salesforce 把该逻辑页拆成多个 nextRecordsUrl 响应，client 也会完整消费并验证 tuple 单调性。Get Deleted 只接受 UTC 分钟对齐且不超过 15 天的窗口， 保留 earliestDateAvailable / latestDateCovered 供同步层判断缺口。

同步与当前限制

同步 checkpoint 绑定租户、任务、profile、对象、字段形状和运行 ID。 Full 只在完整结束后允许宿主 reconcile；Incremental 对删除保留期缺口、 不前进的覆盖水位和单分钟仍超过页容量的删除量全部失败关闭并要求新 Full，不会把缺口解释成“没有删除”。

Provider Descriptor、DI 和 Bitzsoft.Integrations.All 聚合依赖均已接入。 当前包保持 Preview，不声明 Pub/Sub、CDC、Bulk API、Salesforce on Alibaba Cloud 或商业 sandbox 已完成。

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Bitzsoft.Integrations.Salesforce:

Package Downloads
Bitzsoft.Integrations.All

Bitzsoft 第三方集成聚合包 — net5.0 包含传统连接器，net8.0+ 额外包含受上游 TFM 限制的 AI 模块

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-alpha.10 52 7/26/2026