

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS Partner CRM 连接器常见问题
<a name="crm-connector-faq"></a>

本节中的主题有助于回答有关 AWS Partner CRM 集成和使用 CRM 连接器的常见问题。

**注意**  
本常见问题解答中的问题和答案假设您使用的是 Salesforce。有关使用 Salesforce 的更多信息，请参阅 Sal [esforce 帮助](https://help.salesforce.com/s/)。

**Topics**
+ [一般问题](#general-questions)
+ [设置问题](#setup-issues)
+ [映射问题](#mapping-issues)
+ [同步和验证问题](#synchronization-validation)

## 一般问题
<a name="general-questions"></a>

展开以下部分，了解有关使用 AWS Partner CRM 连接器的更多信息。

### 如何开始使用 AWS Partner CRM 连接器？
<a name="how-to-get-started"></a>

请联系您的合作伙伴开发经理 (PDM) 或联系人。 AWS 您的 PDM 将验证资格，帮助设置身份验证所需的 IAM 用户，并在内部提交请求以设置交换文件所需的 Amazon S3 存储桶。访问 Amazon S3 存储桶后，您可以按照用户指南中的说明安装连接器并设置集成。

如果您已经有 AWS Partner ACE 集成，请[从 Salesforce 安装连接器 AppExchange](install-connector.md)，然后按照中的[为集成了 Amazon S3 的 CRM 配置连接器](s3-config.md)说明进行操作。

### 为什么要迁移到版本 3？
<a name="why-move"></a>

版本 3 提供实时机会更新，无需日程安排。它还提供了一组按钮，使合作伙伴能够接受或拒绝潜在客户和机会，对其进行更新，然后将其发送到 AWS。有关安装版本 3 的信息，请参阅本指南[可用的特征](crm-connector-feature-list.md)前面部分。

### 连接器的最新版本是什么？
<a name="latest-version"></a>

版本 3.0.0。你可以在 Salesforce App Exchange 中找到它。

### 设置 AWS Partner CRM 连接器需要多少费用？
<a name="setup-costs"></a>

 AWS Partner CRM 连接器可从 Salesforce App Exchange 免费获得。它提供了以下集成选项：
+ 基于合作伙伴中心 API 的集成， AWS 服务电话免费。
+ 一种基于 Amazon S3 的集成，其中 AWS 托管并承担亚马逊 S3 存储桶的成本。
**注意**  
只有在 2024 年之前创建了集成了 Amazon S3 的 CRM 时，您才能使用此选项。

Amazon EventBridge 也是免费的，因为活动来自一项 AWS 服务。但是，如果您将事件从主事件侦听器转发到其他事件总线以进行额外处理，则您的 AWS 账户可能会产生额外费用。

有关 AWS Partner CRM 连接器的更多信息，请参阅[CRM 连接器概述](connector-overview.md)。有关的更多信息 EventBridge，请参阅 [Amazon 是什么 EventBridge？](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) 在《*亚马逊 EventBridge 用户指南》*中。

### 版本 3 提供了哪些新功能？
<a name="new-features"></a>

有关 AWS Partner CRM 连接器提供的功能列表，请参阅本[合作伙伴中心 API 功能](crm-connector-feature-list.md#partner-central-api-features)指南前面的。

### 我能否以编程方式访问用于发送和接收文件的 Amazon S3 存储桶？
<a name="s3-programmatic-access"></a>

可以。使用 CRM [集成入职请求中的 IAM](https://partnercentral.awspartner.com/partnercentral2/s/acecrmintegration) 用户的`AccessKey`和`SecretAccessKey`证书。

请记住，将集成移植到基于 API 的方法后，将不再使用 Amazon S3 存储桶传输文件。但是，仍然使用基于 Amazon S3 存储桶的集成来共享潜在客户。

### 我还没转到 Salesforce Lightning 版本。我还能使用 AWS Partner CRM 连接器吗？
<a name="sf-lightning-version"></a>

 AWS Partner CRM 连接器专为 Salesforce Lightning 版本使用而设计，因此版本 2 可能无法按预期运行。

### 我可以直接在我的生产系统上使用该软件包吗？
<a name="prod-systems"></a>

我们建议只有在沙盒环境中进行全面测试后，才在生产系统上安装该软件包。

### 谁是 C AWS Partner RM 连接器的目标用户？
<a name="intended-users"></a>

AWS Partner CRM 连接器专为以下用户角色而设计：
+ 设置连接器的 Salesforce 管理员或推荐管理员。
+ 选择、接受和更新机会和潜在客户的销售运营用户。

### 我有一个 ACE 集成。我可以移到连接器吗？
<a name="move-connector"></a>

是的。 AWS Partner已与 ACE 集成的 s 可以移至连接器。由于连接器在后端使用相同的 Amazon S3 存储桶，因此请完成以下步骤：

1. 断开您的定制应用程序或解决方案与 Amazon S3 存储桶的连接。

1. 登录 AWS 账户以设置集成。为有权访问 Amazon S3 存储桶的 IAM 用户获取或创建密钥和访问密钥。用户名必须遵循以下格式：`apn-ace-{partnerName}-AccessUser-prod`。有关更多信息，请参阅用户*指南*中的[管理 IAM 用户的访问密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)。AWS Identity and Access Management 
**注意**  
如果您找不到 AWS 账户，请提交[支持请求](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)。

1. 要将连接器配置为指向 Amazon S3 存储桶，请依次选择**设置**、**命名凭证**和 **APN API 连接**。

1. 在连接器中安排任务之前，请提交[支持请求](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)以删除 Amazon S3 存储桶中的现有对象。
**重要**  
 在完成集成和设置同步计划之前，必须完成此步骤。

1. 如果目标对象与现有对象不同，请对现有的潜在客户和机会进行数据回填。有关更多信息，请参阅 CRM 集成*生产设置和回填指南*。
**注意**  
在集成切换期间，所有用户更新都会在 Amazon S3 存储桶的`Outbound`文件夹中排队。集成上线后，将同步用户更新记录。

### 在我的 Salesforce 组织中使用 AWS Partner CRM 连接器是否安全？
<a name="connector-safe"></a>

Salesforce 应用程序已通过 Salesforce 和内部 AWS 安全审查。Salesforce 安全审查扫描包括以下威胁：
+ Salesforce 对象查询语言 (SOQL) 和 SQL 注入
+ 跨站点脚本
+ 不安全的身份验证和访问控制协议
+ Salesforce 平台特有的记录共享违规行为和其他漏洞

代码审查使用 [Salesforce 代码分析器](https://forcedotcom.github.io/sfdx-scanner/)来检查 Salesforce 代码。Salesforce Code Analyzer 使用多个代码分析引擎，包括 PMD 和 Reti ESLint reJS。它发现了许多潜在的问题，从命名不一致到安全漏洞。

有关审核流程的更多信息，请参阅 Salesforce 文档中的[AppExchange 安全审查](https://developer.salesforce.com/docs/atlas.en-us.packagingGuide.meta/packagingGuide/security_review_overview.htm)。

**注意**  
合作伙伴应用程序是 Salesforce 主要服务协议中定义的非 Salesforce.com 应用程序。有关更多信息，请参阅 Salesforce [协议和条款](https://www.salesforce.com/company/legal/agreements/)。

尽管此处规定了任何安全要求或可能对合作伙伴应用程序进行任何安全审查，但Salesforce对任何合作伙伴应用程序的质量或安全性不作任何保证，客户应全权负责评估合作伙伴应用程序的质量、安全性和功能，以确定其是否适合客户的安装和使用。

虽然我们无法具体分享我们的内部安全审计涵盖的内容，但它面向集成架构的原生 AWS 组件，Salesforce应用程序与之相连，涵盖了许多不同的威胁建模场景，例如 man-in-the-middle攻击、分布式 denial-of-service缓解措施和加密标准。如需更多信息，请提交支持请求。

## 设置问题
<a name="setup-issues"></a>

展开以下部分，了解有关修复 AWS Partner CRM 连接器设置问题的信息。

### 使用 AWS Partner CRM 连接器的先决条件是什么？
<a name="set-up-prereqs"></a>

有关使用 CRM 连接器的先决条件的信息，请参阅本指南[集成先决条件](crm-integration-setting-up.md)前面的。

### 如何为软件包设置命名凭证？
<a name="set-up-named-credentials"></a>

请按照本指南[设置命名凭证](guided-setup-apis.md#api-named-credentials)后面列出的这些步骤进行操作。

### 从版本 2 迁移到版本 3 有什么影响？ 有什么重大变化吗？
<a name="moving-implications"></a>

从 AWS Partner CRM 连接器的版本 2 迁移到版本 3 不会产生直接影响。所有功能都向后兼容，并且可以不间断地运行。

对于机会管理，如果您计划使用新功能，则可能需要更改某些销售流程。您应该评估以下更改并制定过渡计划。
+ 版本 3 实时分享 AWS 机会。您不再需要创建向发送机会的时间表 AWS。合作伙伴的 Salesforce 实例上的机会所有者必须手动将数据发送到。 AWS Salesforce 用户需要权限才能将机会推送到。 AWS
+ 如果您计划使用多对象映射，则需要一个过渡计划，用于从 Salesforce 实例中的新对象获取和发布数据。作为 Salesforce 管理员，您应该意识到从将所有字段映射到单个对象中的对象映射与将其他对象的字段映射到单个对象的字段移动到单个对象的后果。

### 从 Amazon S3 连接（异步）迁移到基于 API 的连接（同步），还有其他设置步骤吗？
<a name="moving-from-s3"></a>

可以。您*必须*完成以下项目：
+ 在一般先决条件中，[关联您的 AWS 合作伙伴中心和 AWS Marketplace 账户](link-pc-mkt-accounts.md).
+  为新的合作伙伴中心创建指定凭证 APIs。有关更多信息，请参阅本指南前面部分的[设置命名凭证](guided-setup-apis.md#api-named-credentials)。

### 我们还没有移至 Salesforce Lightning 版本。我们还能使用 AWS Partner CRM 连接器吗？
<a name="no-lightning"></a>

不是。 该连接器专为与 Salesforce Lightning 版本配合使用而设计，如果没有它，应用程序可能无法按预期运行。

### 在我们的 Salesforce 环境中，我们已达到预定任务的上限。我们可以使用外部调度器来触发同步吗？ AWS
<a name="sf-job-limit"></a>

需要验证- AWS Partner CRM 连接器是托管包。您可以使用第三方应用程序针对`InboundSyncScheduler`和 `OutboundSyncScheduler` apex 类创建自定义计划调用。注意-使用新的基于 API 的集成，这些类可能无法运行。

## 映射问题
<a name="mapping-issues"></a>

根据需要展开以下各节，了解如何修复 AWS Partner CRM 连接器的对象映射问题。

### 多对象映射是如何工作的？
<a name="m-o-mapping"></a>

对于版本 3，合作伙伴可以在映射时向下选择引用对象的字段。例如，如果您的 Salesforce 标准机会对象具有指向账户对象和自定义 AWS 销售对象的内部引用，则可以选择标准机会作为父对象，然后映射账户和销售对象中的字段。

### 我能否在映射选项卡中选择多个对象？
<a name="select-multiple-objects"></a>

不是。 相反，您可以映射选定对象中的多个字段。

### 连接器如何跟踪其用于编组数据的对象？
<a name="track-objects"></a>

版本 3 使用该`APNCrmUniqueIdentifier`字段引用单个父对象进行映射。该字段包含 AWS 记录 ID。查询父对象后，将根据父对象的参考链接对所有其他相关对象的值进行编组或解组处理。

### 在哪里可以找到特定字段的类型字段？
<a name="find-types-field"></a>

连接器的版本 3 适用于版本 2 的数据模型。有关完整的有效负载信息，请参阅上的 Part [AWS ner CRM 集成示例](https://github.com/aws-samples/partner-crm-integration-samples) GitHub。

### 托管软件包是否有助于在我的标准 Salesforce 对象上设置验证规则？
<a name="validation-rule-help"></a>

不是。 该软件包附带 ACE 自定义机会对象，其中包括针对[标准 ACE 有效负载](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)运行的字段类型和验证规则。您可以从标准对象中的 ACE 自定义机会对象中复制验证规则和字段。 *NEED TO VALIDATE*-使用多对象映射，您可以尝试在标准机会对象中添加对 ACE 机会对象的引用，然后使用触发器将数据复制到这些字段中以启动验证。

### 为什么我无法编辑 “同步于” AWS 字段的映射？
<a name="cant-edit-mapping"></a>

“**同步**于 AWS” 复选框决定销售线索或机会是否与下一个计划任务的 AWS 运行时间同步。应用程序中包含 “**与合作伙伴中心同步**” 字段，用于显示标准机会和潜在客户。如果目标对象是自定义对象，则必须将 **Sync** with AWS字段映射到每个对象中的自定义非公式布尔字段。

### AWS 现场工作的 Has Updates 是如何进行的？
<a name="has-updates"></a>

“**有 AWS公式更新**” 字段确定是否在下一个计划作业 AWS Partner 中将记录发送到。满足以下条件时 AWS，“**有更新**” 设置**为** True：
+ 记录的@@ **上次修改日期**晚于**上次 APN 同步日期**。
+ **上次修改的用户**不是安排集成作业的用户。

### 为什么我无法映射必填的 APN CRM 唯一标识符字段？ 菜单不可用，我收到消息 “没有有效的映射字段”
<a name="map-unique-id-field"></a>

您必须使用长度为 18 个字符的**文本**数据类型才能与 **API** 字段的长度相匹配。
+ 配置：文本 (18)（外部 ID）（唯一不区分大小写）

### 连接器应用程序用于将出站文件从 Salesforce 推送到的故障排除检查点是什么？ AWS Partner
<a name="troubleshooting-checkpoints"></a>

该应用程序使用以下检查点：
+  AWS必须选中 “**同步到**” 才能与同步 AWS。
+ ** AWS必须选中 “更新**为” 才能与同步 AWS。
+ 用于创建计划作业的用户角色必须不同于用于创建和更新潜在客户或机会的用户角色。
+ 如果之前的检查属实，但出站批处理仍未运行，请检查 AWS Partner 同步日志并添加出**站 IDs**列。确认同步日志中包含您要推送的商机的 ID。如果同步日志停留在 **API 成功**状态，请删除同步日志记录并重试。

  当**预期月 AWS 收入**不是整数时，例如`1041.67`取而代之`1041`，则数据类型不匹配会导致处理错误。要解决此问题，请删除停留在 **API 成功**状态的同步日志，并在下一次作业运行之前更正数据。

### 我能否配置筛选条件和订阅来同步潜在客户和机会？ 我们能否在状态或阶段字段上添加自定义过滤器？
<a name="configure-syncs"></a>

在 Salesforce 中，您可以创建或更新公式字段，为特定值添加状态或阶段字段中的依赖关系。例如，您可以将 “**有更新” 设置 AWS为** **True**。您可以使用机会上的 “已包含” 字段作为参考。下面的示例演示了如何操作：

```
IF(
   OR( 
      AND
      (
         OR(LastModifiedDate > awsapn_Last_APN_Sync_Date_c,LastModifiedDate = awsapn_Last_APN_Sync_Date_c),
         awsapn_Sync_with_Partner_Central_c, 
         NOT(ISNULL(awsapn_Last_APN_Sync_Date_c))
      ),
      AND(ISNULL(awsapn_Last_APN_Sync_Date_c),awsapn_Sync_with_Partner_Central_c)
   )
   , true , false
)
```

### 我必须映射必填字段吗？
<a name="map-mandatory"></a>

可以。您必须映射所有必填字段才能安排入站或出站集成作业。

### 我可以映射查找字段吗？
<a name="map-lookup-fields"></a>

我们建议您查看您当前在 Partner Central 中输入的字段，以确定最相关的字段（除必填字段外）。有关可用字段及其用途的列表，请参阅 Partner Central 上的 [ACE CRM 开发套件](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0698a00000D11JsAAJ)中包含的*字段定义指南*。

### 我应该用派生字段更新记录还是在映射过程中创建它们？
<a name="use-derived-fields"></a>

复杂的逻辑和推导应根据您自己的业务逻辑在您的 Salesforce 组织中完成，然后根据该逻辑填充映射字段。

## 同步和验证问题
<a name="synchronization-validation"></a>

根据需要展开以下各节，了解如何修复 AWS Partner CRM 连接器的同步和验证问题。

### 是什么原因导致了 STORAGE\$1LIMIT\$1EXCHERED 错误？
<a name="storage-exceeded"></a>

当您在存储空间有限的开发组织中测试连接器时，就会发生此问题。要修复此问题，请运行以下查询从控制台清除同步日志：

`Listawsapn_Sync_Log_c syncLogs = [SELECT Id FROM awsapn_Sync_Log_c WHERE Status IN ('API Success', 'Processed') LIMIT 4000]; delete syncLogs;`

您也可以将同步日志保留期设置为自动清理早于保留期的同步日志记录。有关设置保留期限的更多信息，请参阅 

### AWS 推荐的潜在客户或机会不符合对我的自定义对象的验证。我该如何解决这个问题？
<a name="validation-compliance"></a>

一些潜在客户和 AWS 发起的机会不符合每个领域的验证规则。要允许合作伙伴接受或拒绝此类推荐，您可以在接受记录之前更正数据。要接受或拒绝不符合数据验证的对象，请完成以下步骤：

1. 导航到失败记录的同步日志详细信息。

1. 选择 “**编辑负载”** 以访问 JSON 视图。

1. 更新不合规字段的值。

1. 选择 S **ave Pay** load，为下一个作业设置同步记录。

如果记录被接受，则在收到来自的其余字段后，必须再次重复步骤 1-4。 AWS对于后续同步，将使用更正后的值。或者，您可以在 Partner Central 的 ACE 渠道管理器中更正这些值。

### 多久 AWS 上传一次潜在客户和机会？
<a name="upload-frequency"></a>

AWS 每小时将销售线索和机会上传到 Amazon S3 存储桶。因此，需要通过集成更新数据的操作最多可能需要一个小时才能同步。

### 为什么我在使用映射屏幕时会收到 setFieldLength警告消息？
<a name="field-length-warning"></a>

当执行对象映射的用户没有必填字段的读取权限时，会出现以下警告：

```
pe.setFieldLengthWarning()@ -
/modules/awsapn/fieldMappingRow.js:1:7831
set salesforceFields()@- /modules/awsapn/fieldMappingRow.js:1:5624
```

您必须使用具有源字段和目标字段权限的系统管理员用户，或者使用具有 [APN 集成权限集](crm-connector-pemissions-sets.md#integration-user)的用户。

### 同步日志中的 “状态” 和 “用途” 字段是什么意思？
<a name="status-purpose"></a>

要确定每条同步日志记录的状态和操作，请参阅中的表[同步日志](crm-connector-sync-logs-and-reports.md#sync-logs)。

### 你们提供审计或存档吗？
<a name="audit-archive"></a>

同步日志对象跟踪所有入站和出站交易。您还可以在应用程序配置中为日志记录指定保留期。

### 为什么会出现限制异常？
<a name="throttling"></a>

Partner Central APIs 有一[组配额](https://docs.aws.amazon.com/partner-central/latest/APIReference/quotas.html#understanding-and-managing-quotas)，可确保合理使用并避免滥用服务。达到配额后，当速率限制开始时，您可能会看到限制异常。每日配额以 24 小时的滚动周期重置。如果默认配额不符合您的要求，则可以使用 S [ervice Quotas 页面](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/dashboard)请求增加配额。

### 我在标准机会上看不到 “发送至 AWS ” 按钮
<a name="no-button"></a>

“**发送至 AWS**” 按钮仅针对**合作伙伴推荐**机会类型显示。