本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
从 Amazon S3 升级到 API-based 集成
注意
本节指导您如何将您的 AWS 合作伙伴 CRM 连接器从亚马逊升级 S3-based 到 API-based 集成。该 API-based 集成通过 IAM 角色和 API 使用实时、双向同步取代了传统的 Amazon S3 存储桶模型。
有关包含屏幕截图的全交互式演练，请参阅 AWS 研讨会网站上的
升级涉及以下步骤：
先决条件
迁移操作顺序
合作伙伴经常询问是要在 AWS 控制台中迁移到新的合作伙伴中心体验，还是先从 Amazon S3 升级到 API。以下是推荐的方法：
| 场景 | 建议 |
|---|---|
| 目前在 Amazon S3 上线，尚未推出新的合作伙伴中心体验 | 先迁移到 API，然后并行或之后迁移到新的合作伙伴中心体验 |
| 目前在 Amazon S3 上，已经有新的合作伙伴中心体验了 | 直接进行 API 迁移 |
| 已经在 API 上线，尚未推出新的合作伙伴中心体验 | 在方便时迁移到新的合作伙伴中心体验 |
账户关联是唯一的硬性先决条件
账户关联是亚马逊 S3-to-API 迁移的唯一硬性先决条件。无需迁移到新的合作伙伴中心体验即可开始 API 升级。
关键信息：
Amazon S3-based 集成已过时，新用户不再可用。
Amazon S3 上的合作伙伴应计划尽快完成向 API 的迁移，以避免服务降级。
查看 AWS 合作伙伴 CRM 集成文档，了解有关 Amazon S3 后端生命周期终止的最新时间表。
确保合作伙伴中心已链接到 AWS 账户
亚马逊 S3-based 连接器使用 AWS 管理账户中托管的 Amazon S3 存储桶的权限进行了身份验证。相反， API-based 连接器通过合作伙伴自己的关联 AWS 账户上的 IAM 角色进行身份验证，以直接调用 Partner Central API。这就是为什么账户关联是硬性技术先决条件的原因：没有账户关联，连接器就无法访问具有必要权限的 Partner Central API。
为什么这个可能不见了
在 2024 年 11 月 AWS 发布合作伙伴中心销售API时，引入了账户关联，允许合作伙伴以编程方式访问这些 API。从连接器版本 3.0（也是 2024 年 11 月）开始，账户关联成为 API-based 同步的必要条件。在此日期之前设置亚马逊 S3-based 连接器的合作伙伴将无法完成账户关联。
将您的合作伙伴中心账户关联到您的主 AWS 账户。从一开始就谨慎选择您的账户。虽然可以取消关联并重新关联其他账户，但这样做会造成数据持久性问题，需要手动对账。
账户选择规则 — AWS 账户必须：
信誉良好的付费账户（非免费套餐）
归合作伙伴的公司所有（不是分销商的账户）
账单地址与合作伙伴的主要营业地点相匹配
不是沙盒、开发者、个人或账户 management/payer
账户关联是永久性的
在合作伙伴中心迁移到 AWS 控制台后，账户关联是永久性的。所有 APN 资源（ACE 机会、历史记录、多合作伙伴邀请）都与该账户永久关联。谨慎选择。
资源：
AWS 研讨会网站上升级研讨会的
账户关联部分 取消合作伙伴中心
网站上的账户关联
可选：迁移到中新的合作伙伴中心体验 AWS 控制台
升级亚马逊 S3-to-API 连接器不需要执行此步骤。仅账户关联即可提供所需的 API-based 功能。但是，迁移到新的合作伙伴中心体验可以让您的团队获得更多功能：
合作伙伴中央代理（Co-Sell 代理、融资代理、自主探矿）
集中式 AWS 控制台体验，用于管理合作伙伴活动和 AWS 资源
提高了直接在控制台中对机会生命周期事件的可见性
解决方案 ID 格式更改
如果您迁移到新的 Partner Central 体验，然后创建新的解决方案，这些解决方案将使用新soln-*格式。CRM 连接器尚不支持这种格式；它需要该solutionOffered字段的旧S-*格式。迁移之前创建的传统解决方案保留了S-*格式并继续有效。
有关更多详细信息，请参阅合作伙伴中心迁移指南。
Pre-migration 数据清理
在开始迁移之前，请确保 S3-based与 Amazon 集成完全脱节。最关键的步骤是删除延迟的计划作业，这些作业可能会干扰 API-based 连接器和回填过程。
当您通过连接器用户界面停用 Amazon S3 计划时，底层 Salesforce 计划任务（带有 APN 前缀）将保留在系统中。如果在您开始回填或启用 API-based 同步时这些记录仍然存在，则旧的调度程序和新的连接器可能会同时写入相同的记录，从而导致重复的机会创建或数据冲突。
仅在 UI 中停用是不够的
仅在连接器用户界面中停用计划是不够的。您还必须删除 Salesforce 安装程序中的基础计划任务条目。查看并禁用 Amazon S3 的时间表有关完整的分步说明，请参阅。
设置 AWS 基础设施
此阶段要求Salesforce管理员与IT云管理员合作设置两个新组件：Salesforce外部客户端应用程序和 AWS 基础设施组件（EventBridge 规则和IAM角色）。
设置 Salesforce 外部客户端应用程序
在 Amazon S3 版本中，两个同步方向都经过每个合作伙伴共享的 Amazon S3 存储桶。API 版本对入站更新进行了颠覆——合作伙伴中心现在通过以下方式将事件直接实时推送到您的组织。 EventBridge外部客户端应用程序启用 OAuth 2.0 客户端凭证流程，因此 EventBridge 可以在通知发生时发送通知。
Salesforce管理员应按照研讨会 “在Salesforce上设置外部客户端应用程序
设置 AWS 组件
API 版本 AWS 的基础架构包括：
EventBridge用于实时事件处理
用于安全身份验证的 IAM 角色
这些组件取代了先前版本中使用的 Amazon S3 存储桶访问模型。
IT 云管理员应按照研讨会 “设置 AWS 组件
在 Salesforce 中完成设置和配置
其余配置由 Salesforce 管理员执行。首先在沙盒中完成活动，进行测试，然后进入生产阶段。
从 Salesforce 安装最新版本的 AWS 合作伙伴 CRM 连接器 AppExchange
查看和调整您的映射
在 Amazon S3 版本中，出站同步依赖于Sync with AWS和Has Updates for AWS字段。它们不再用于集 API-based 成。
在 API 版本中，出站同步通过 AWS
合作伙伴 CRM 连接器自定义设置 (Companion_App_Settings__c) 中的 “启用 AWS 集成共享” 设置进行控制。启用后， AWS 只要符合条件的更新发生，就会自动与之共享 ACE 机会。
关键点：
建议将 ACE 机会对象作为着陆区域，它与 Partner Central 中的 AWS 机会数据点相匹配并允许自动映射。
如果您已经使用 ACE 机会进行集成映射，则基础配置不会更改。但是，升级后的软件包引入了早期版本中不存在的新字段。
查看所有引用旧亚马逊 S3-era 字段 (
Sync_with_AWS__c,Has_Updates_for_AWS__c) 的自动操作以使用新的等效字段。
ACE 机会数据模型可在GitHub 网站上找到
最新的连接器版本包括流程模板，可帮助将您的标准机会映射到 ACE 机会。有关更多详细信息，请参阅流程模板。
查看并添加必填字段和按钮
自 3.0+ 版本起，该连接器引入了新的字段和按钮。您必须手动更新您的闪电记录页面布局。
将以下按钮添加到 ACE 机会闪电记录页面：
| 按钮 | 用途 |
|---|---|
| 与... 共享 AWS | 通过 API 手动将机会推送到合作伙伴中心。 |
| 从... 刷新 AWS | 将合作伙伴中心的最新数据提取到这个 ACE 机会记录中。 |
| Accept/Reject | 接受或拒绝 AWS推荐的机会。 |
| Associate/Disassociate | 关联或取消关联 AWS经批准的合作伙伴解决方案、产品和市场优惠。 |
| 分配 | 将机会重新分配给您的合作伙伴中心账户中的其他用户。 |
从 ACE Opportunity 闪电记录页面中删除以下旧版按钮：
| 按钮 | Reason |
|---|---|
| 发送至 AWS | 替换为 “共享为 AWS”。 |
| 链接私享优惠 | 替换为 Associate/Disassociate。 |
将以下列表视图按钮添加到 ACE 机会选项卡：
接受机会 AWS— Bulk-accept 多个推荐机会。
分配机会 — Bulk-reassign 多个机会。
有关新字段，请查看连接器版本 3.0 之后添加的所有字段
查看并禁用 Amazon S3 的时间表
使用 API-based 这种方法，不再需要预定的任务 ——集成是实时运行的。
禁用计划作业
在 “ AWS 合作伙伴 CRM 连接器” 应用程序中导航到 “计划” 选项卡。
选择 “停用所有作业”，然后再次选择 “停用”。
还要删除预定记录。要从安装程序中移除剩余的 APN 计划作业，请执行以下操作：
从安装程序中删除 APN 计划作业
导航到 “设置” 。搜索 “已计划”，然后选择 “计划作业” 。
查看所有 APN-related 职位的清单。选择 Del 将其删除。
继续 CustomLogInteractionBatch 跑步
保持CustomLogInteractionBatch作业运行（AppExchange 应用程序分析）。
删除预定任务，而不仅仅是停用
不要让任务处于 “已停用但未删除” 状态。延迟的工作与 API-based 实时同步相结合，会造成重复的机会创造。
资源清理
停用旧版验证规则
必须停用一些旧版验证规则，其他规则必须保持活动状态。有关完整的分步和验证规则表，请参阅研讨会的
还要确保以下传统流程已停用：
将 ACE 机会同步到合作伙伴中心 API
私人报价查询
APN 同步失败通知
更新有关 ACE 机会的 “私募报价” 字段
更新同步日志详细信息记录上的 Ace 机会字段
统一 Standard-ACE 机会同步流程（模板）
在投入生产之前测试您的流程。参见研讨会中的设置测试
彻底回补来自的机会 AWS 到 Salesforce
进行回填以确保环境之间的数据匹配。ACE Opportunity 上的awsapn__Last_Modified_Date__c字段需要与 “合作伙伴中心” 中的 “上次修改日期” 相匹配，以便将来的更新同步。Amazon S3 集成并未填充此字段，因此从 Amazon S3 迁移的机会将该字段清空——回填内容填满。
回填提供三种模式：
| Mode | 作用 | 何时使用 |
|---|---|---|
| 仅刷新缺少上次修改日期的机会 | 仅更新为空awsapn__Last_Modified_Date__c的记录 | 推荐用于亚马逊 S3-to-API 迁移 |
| 只刷新 Salesforce 中已经存在 AWS 的机会 | 更新所有已经有 APN CRM ID 的记录 | 安全的迁移替代方案 |
| 刷新所有 AWS 机会 | 将整个 “合作伙伴中心” 渠道拉入 Salesforce | 仅在全新安装时使用 |
在运行回填之前：
确认所有 APN 计划任务均已删除（不仅仅是停用）。
停用 “将 ACE 机会同步到合作伙伴中心 API” 流程（如果处于活动状态）。
在自定义设置中禁用 “启用 AWS 集成共享”（
Companion_App_Settings__c）。完成中描述的迁移前数据清理。Pre-migration 数据清理
回填完成后：
Re-enable 启用 “ AWS 集成共享” ——这将推动持续同步。
无需重新激活 “将 ACE 机会同步到合作伙伴中心 API” 流程。
验证记录样本以确认
awsapn__Last_Modified_Date__c已填充。
有关更多详情，请参阅研讨会的 “合作伙伴中心回补机会
Post-migration: 监控 EventBridge 事件
迁移后，您的 Salesforce 组织通过 EventBridge以下方式接收来自合作伙伴中心的实时更新。要验证事件是否流动，请执行以下操作：
CloudWatch 指标：导航到 CloudWatch > 指标 > EventBridge。检查调用情况和您 FailedInvocations 的 API 目的地。
Salesforce 同步日志：在任何 ACE 机会上，查看同步日志相关列表，查看最近的入站条目。
EventBridge 规则监控：检查 CloudFormation 模板为最近的匹配事件创建的规则。
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| Salesforce 中没有入站更新 | 外部客户端应用程序令牌已过期 | Re-authenticate 连接的应用程序；在 API 目标中 EventBridge 验证 OAuth 凭据 |
| 工作后活动停止 | Salesforce 会话超 | 在中检查 API 目标运行状况 EventBridge；重新连接 |
| 部分更新（缺少某些字段） | 字段映射不匹配 | 升级到最新的连接器版本；验证字段映射 |
疑难解答常见迁移问题
| 错误/症状 | 根本原因 | 解决方案 |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTION单击 “刷新自 AWS” 时 | 旧版验证规则未停用 | 停用和 ACEOppNew_PreventUpdatesWhenPOSubmitted ACEOpp_PreventUpdatesWhenPOSubmitted |
| 重复机会 | 延迟安排的任务或多个集成用户 | 删除所有 APN 计划任务。确认只有一个用户持有APN Business Admin。 |
| 同步日志记录增长迅速 | 记录每个周期验证失败的重试次数 | 通过同步日志识别失败记录。修复缺失的必填字段。 |
| 回填量超过存储限制 | 一次记录太多了 | 小批量运行。监控存储。 |
| “刷新自 AWS” 显示过时数据 | awsapn__Last_Modified_Date__c不匹配 | Re-run 使用 “仅限缺少上次修改日期的刷新机会” 进行定向回填 |
| 合作伙伴中心提供的机会未出现 | EventBridge 连接问题或自动共享已禁用 | 验证 EventBridge API 目标运行状况。确认 “启用 AWS 集成共享” 已启用。 |
获取帮助
如果您遇到前面步骤无法解决的问题：
提交支持案例：合作伙伴中心 → 支持 → 打开新案例
→ CRM 集成 迁移援助：对于复杂的迁移（500 多个机会、自定义集成或之前的生产事件），请通过您的联盟负责人请求白手套支持。
