本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 技术常见问题解答——线索和机会
## 发送和接收潜在客户和机会
**问：有文件命名约定吗？**
每个文件名都必须是唯一的。我们建议使用文件名`PartnerProvided FileName+{timestamp}.json`。
**问：结果的结构是什么？**
可以从以下位置下载结果（成功和错误）的示例文件：
+ [领先业绩成功示例 sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [机会结果成功示例 sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [有错误的潜在业绩 sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [存在错误的机会结果 sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**问：结果的命名惯例是什么？**
`PartnerProvidedFileName_result.json`
**问：如果我提交第二个同名的 JSON 文件会怎样？**
我们不会处理该文件，文件将移至存档文件夹。
**问：入站文件的大小限制是多少？**
入站文件大小限制为 1MB。
**问：可以批处理到一个 JSON 文件中的机会和潜在客户数量是否有上限？**
鉴于 1MB 的限制，我们建议您为每个文件提供一个机会或潜在客户。
**问：我收到了拒绝访问的错误消息，所以我无法上传文件。我应该怎么办？**
合作伙伴收到*拒绝访问*消息的原因有两个。
1. 您已将文件上传到文件`outbound`夹，而不是`inbound`文件夹。将文件上传到该文件`inbound`夹。
1. 您需要提供访问控制列表 (ACL)。使用以下 Amazon Web Services (AWS) CLI 命令上传数据文件：
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**问：如果上传了扩展名为`.pdf``.docx`、或其他扩展名的文件，`.json`会发生什么？**
我们拒绝这些文件并生成包含原因详细信息的`*.error.json`文件。
**问：在生产环境中收到数据问题错误消息后我该怎么做？**
1. 如果需要在合作伙伴的客户关系管理 (CRM) 系统中更正数据，请在更正数据后，将修改后的文件发送到亚马逊简单存储服务 (Amazon S3) Simple S3 Service。
1. 如果需要对数据进行任何澄清，请联系您的合作伙伴开发经理 (PDM)。
1. 如需任何其他技术支持，请在 APN 门户网站上提出 AWS Partner Network (APN) 支持案例。
**问：我在哪里可以找到结果文件以及它们有多长时间可用？**
结果文件位于`lead-inbound-results`和`opportunity-inbound-results`文件夹中。在您删除它们之前，它们一直可用。成功拉取后，您可以删除文件。
**问：如果我需要在删除结果文件后找到它，在哪里可以找到它？**
您可以在`lead-inbound-results-archive/YYYY/MM/DD`和`opportunity-inbound-results-archive/YYYY/MM/DD`文件夹中找到结果文件。
**问：如果 APN 处理文件时出现任何故障，如何通知我？**
APN 有警报，可自动创建 Sev2 票证以跟踪处理错误。我们会审核、解决这些问题并将其传达给合作伙伴。
**问：机会启动后可以更新哪些字段？**
以下字段只能由独立软件供应商 (ISV) Accelerate 合作伙伴更新：
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**问：我收到了 “*记录不可编辑*” 错误。这是什么意思？**
当您向合作伙伴发送推荐的新机会时，该机会将通过验证流程，APN 客户参与 (ACE) 团队必须批准或拒绝该机会。当机会正在审核中且尚未通过验证时，您无法更新记录，并且会收到此错误。
**问：如果我这边没有活动（例如：我没有处理文件或没有发送任何入库机会），会发生什么？**
如果您没有发送任何信息或没有处理我们提供的文件，则我们目前没有机制来提醒您。我们鼓励您监控您的系统，以确保信息流向 APN。
**问：提交 new/updated 入站机会/潜在客户后，JSON 结果多久才会出现在结果文件夹中？**
处理几乎是实时的。您应该在不到五分钟的时间内收到文件。
**问：如果我发送的入站机会 CRM 不符合 APN 标准的 format/length 限制，系统将如何处理？ 它会生成错误报告吗？**
如果文件不是字段定义格式，则 APN 的结果文件会调用该文件。
**问：启动时我还没有 AWS 账户 ID。我该怎么办？**
按照 ACE 流程，`Launched`表示工作负载已完成并开始计费。这需要一个 AWS 账户 ID。有关更多信息，请参阅 [ACE 计划 FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ)。
**问：在用户验收测试 (UAT) 之后，在转向生产的过程中应如何处理历史数据？**
默认情况下，当 ACE 中发生任何更新时，我们会将这些机会发送到 Amazon S3 存储桶。对于您不想处理的历史数据，您需要为提供虚拟值，例如`X0001, X0002….X000N`在数据提取中为不想在系统中处理的内容提供虚拟值。`partnerCrmUniqueIdentifier`你需要编写代码来识别这些标识符并相应地处理它们。其余的机会提供了正确的`partnerCrmUniqueIdentifier`价值。这可确保您完全控制系统中要处理的内容和不处理的内容。
**问：出站文件是否包含多条记录？**
是。出站文件可以包含多条记录。
**问：为什么某些字段的数据会发送 “*接受” 以供查看*？**
对于 AWS 推荐的机会或销售线索，所有 PII 字段都标有 “*接受” 标签以供查看*，直到您接受机会或潜在客户。接受后，您将在下一个同步周期中收到所有数据字段。
**问：首次同步新的 AWS 推荐机会或潜在客户时，我该怎么做？**
首次同步新的机会或潜在客户时，您需要接受或拒绝以获取更多数据（例如：客户联系人）。
## 创建和更新机会/潜在客户
**问：如何通过整合将新的*合作伙伴推荐（源自）*机会引入 ACE？**
要通过集成在 ACE 中创造新的机会，您需要将定义的 JSON 格式的所需机会信息提取到该`opportunity-inbound`文件夹中。 AWS 处理此信息，在 ACE 中创建新机会，并在`opportunity-inbound-processed-results`文件夹中共享 successful/failed 创建操作的结果。
**问：整合如何区分新机会提交和更新？**
每个机会`PartnerCrmUniqueIdentifier`上的字段都是必填的唯一标识符。此标识符必须在您的系统源 CRM 中定义。 AWS 使用它来确定 ACE 中是否已存在机会。如果在 ACE 中可用，我们会使用共享的信息来更新机会，但如果 ACE 中没有，我们会使用共享的信息来创造新的机会。
**问：如果我已经通过集成实现了更新功能，我需要做些什么才能使用集成提交（创造）新的机会？**
您需要对现有集成进行以下更改：
1. 开始在文件夹中获取新的创建机会。`opportunity-inbound`在同一文件夹中提供更新。
1. 确保创建所需的必填字段在共享的机会 JSON 中可用。
1. 确认每个新机会都有 ACE/Partn `PartnerCrmUniqueIdentifier` er Central 中不存在的唯一机会。一个重要的上线最佳实践是将 ACE 中的现有数据映射并更新到您的 CRM `PartnerCrmUniqueIdentifier` 中的每个数据，这样我们就不会在收到更新时创建重复数据。如需帮助，请联系 ACE。
**问：作为上线流程的一部分，如何使用我的 ACE 更新现有机会？`PartnerCrmUniqueIdentifier`**
ACE 团队为您提供所有开放机会的清单，以帮助您为产品发布做准备。您必须将 ACE 中的这些现有机会映射到相应的机会`PartnerCrmUniqueIdentifier`，并将更新后的文件返回给 ACE，以便集成到 AWS的 CRM 中。
如果您选择仅同步机会 AWS 提供的子集，则必须开发逻辑来绕过任何您不想处理的机会的 AWS 更新。这种方法还应应用于 future 入职后的机会。对于需要在两者之间`partnerCrmUniqueIdentifier`进行协调的机会，您必须提供相关信息 CRMs。此外，您还应指明哪些机会不会更新（例如：标记已关闭或已关闭的机会），以将其排除在更新之外。必须为所有 AWS 共享且您接受的未平仓/活跃机会分配一个。`partnerCrmUniqueIdentifier`
**问：我能否仅更新机会或潜在客户中的特定字段？**
是。您只能提供需要更新的字段以及必要的标识符。
**问：是否可以更改 *ApnCrmUniqueIdentifier***？
不是。 对于每个机会，此标识符保持不变 AWS ，并唯一标识每个机会。
**问：如果我提供的*partnerCrmUnique标识符*不正确**怎么办？
如果您提供的标识符不正确，则会创建一个新的机会。确保准确性以避免数据重复。
**问：我能否更新已 AWS 提交的商机？**
是。您可以使用正确的方法更新 AWS 提交的机会`partnerCrmUniqueIdentifier`。
**问：我预计多久能收到已提交的机会的结果？**
处理几乎是实时的，通常在几分钟之内即可在`opportunity-inbound-processed-results`文件夹中获得结果。
**问：如果提交的机会出现处理错误，我该怎么办？**
查看结果文件中的错误详情，解决问题，并向 ACE 支持团队寻求进一步帮助。
**问：我能否通过整合删除机会？**
不是。 不支持直接删除。您可以更新机会以反映 “*已关闭*” 状态。
**问：“*记录不可编辑*” 错误是什么意思？**
如果您尝试在 ACE 审核中更新机会，则会发生此错误。只有经过验证，才能编辑这些机会。
**问：如果不发送更新或新机会怎么办？**
如果您不通过集成发送更新或新机会，则不会收到和处理任何新数据。
**问：结果文件有多长时间可用？**
结果文件在合理的时间内可用。您应该及时检索并管理它们。