本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 技術常見問答集 - 領導和機會
<a name="technical-faq-leads-and-opps"></a>

## 傳送和接收潛在客戶和機會
<a name="send-and-receive-leads-and-opportunities"></a>

 **問：是否有檔案命名慣例？**

每個檔案名稱都必須是唯一的。我們建議使用檔案名稱 `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) 
+  [Errors 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 Simple Storage Service (Amazon S3)。

1. 如果需要對資料進行任何釐清，請聯絡您的 Partner Development Manager (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 Partners 更新：
+ `isThisForMarketplace` 
+ `isNetNewBusinessForCompany` 
+ `deliveryModel` 
+ `awsFieldEngagement` 
+ `additionalComments` 

 **問：我收到*無法編輯的記錄*錯誤。這是什麼意思？**

當您傳送新的合作夥伴推薦機會時，它會經歷驗證程序，且 APN Customer Engagement (ACE) 團隊必須核准或拒絕該機會。當機會仍在審核中且尚未經過驗證時，您無法更新記錄，而且會收到此錯誤。

 **問：如果我這方面沒有活動，會發生什麼情況 （例如：我未處理檔案或未傳送任何傳入機會）？**

如果您未傳送任何資訊或未處理我們提供的檔案，我們目前沒有可提醒您的機制。建議您監控系統，以確保資訊流向 APN。

 **問：在提交新的/更新的傳入機會/領導之後，結果資料夾中的 JSON 結果多快可用？**

處理幾乎是即時的。您應該會在五分鐘內收到檔案。

 **問：如果我傳送的傳入機會 CRM 不符合 APN 標準的格式/長度限制，系統如何處理它？ 是否產生錯誤報告？**

如果檔案不是欄位定義格式，則 APN 的結果檔案會呼叫檔案。

 **問：我在啟動時沒有 AWS 帳戶 ID。我該怎麼做？**

根據 ACE 程序， `Launched`表示工作負載已完成並開始計費。這需要 AWS 帳戶 ID。如需詳細資訊，請參閱 [ACE 計劃FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ)。

 **問：在使用者接受測試 (UAT) 之後，在移至生產環境期間應如何處理歷史資料？**

根據預設，當 ACE 發生任何更新時，我們會將這些機會傳送至 Amazon S3 儲存貯體。對於您不想處理的歷史資料，您需要為 提供`partnerCrmUniqueIdentifier`虛擬值，例如`X0001, X0002….X000N`擷取中您不想在系統中處理的內容。您需要編寫程式碼來識別這些識別符，並相應地處理它們。其餘的機會會提供正確的`partnerCrmUniqueIdentifier`值。這可確保您可以完全控制要處理哪些項目，以及在系統中不處理哪些項目。

 **問：傳出檔案是否包含多個記錄？**

是。傳出檔案可以包含多個記錄。

 **問：為什麼資料傳送*接受以檢視*某些欄位？**

對於 AWS 參考的機會或潛在客戶，所有 PII 欄位都會以標籤 *Accept to view* 遮罩，直到您接受機會或潛在客戶為止。接受後，您會在下一個同步週期收到所有資料欄位。

 **問：第一次同步新的 AWS 推薦機會或潛在客戶時，該怎麼辦？**

第一次同步新機會或潛在客戶時，您需要接受或拒絕它，才能取得其他資料 （例如：客戶聯絡人）。

## 建立和更新機會/領導
<a name="creating-and-updating-opportunitiesleads"></a>

 **問：如何透過整合將新的*合作夥伴推薦 （來源）* 機會導入 ACE？**

若要透過整合在 ACE 中建立新的機會，您需要將定義 JSON 格式的必要機會資訊擷取至 `opportunity-inbound` 資料夾。 會 AWS 處理此資訊、在 ACE 中建立新的機會，並在 `opportunity-inbound-processed-results` 資料夾中分享成功/失敗建立操作的結果。

 **問：整合如何區分新的機會提交和更新？**

每個機會`PartnerCrmUniqueIdentifier`上的 欄位都是必要的唯一識別符。此識別符必須在您的系統來源 CRM 中定義。 AWS 會使用此識別符來判斷 ACE 中是否已有機會。如果可在 ACE 中使用，我們會使用共用的資訊來更新機會，但如果無法在 ACE 中使用，則會使用共用的資訊來建立新的機會。

 **問：如果我已經透過整合實作更新功能，我需要做什麼才能使用整合來提交 （建立） 新的機會？**

您需要對現有的整合進行下列變更：

1.  開始在 `opportunity-inbound` 資料夾中擷取新的建立機會。在相同的資料夾中提供更新。

1.  確保建立所需的必要欄位可在共用機會 JSON 中使用。

1.  確認每個新機會都有 ACE/Partner Central 中`PartnerCrmUniqueIdentifier`不存在的唯一機會。一個重要的上線最佳實務是將 ACE 中的現有資料映射並更新至 CRM `PartnerCrmUniqueIdentifier`中的每個資料，以便我們在收到更新時不會建立重複項目。如需協助，請聯絡 ACE。

 **問：在上線程序中，如何使用我的 更新 ACE 中的現有機會`PartnerCrmUniqueIdentifier`？** 

 ACE 團隊會為您提供所有開放機會的清單，以協助準備生產啟動。您必須在 ACE 中將這些現有機會映射至其各自的 `PartnerCrmUniqueIdentifier`，並將更新的檔案傳回至 ACE 以整合到 AWS CRM。

 如果您選擇只同步提供的機會 AWS 子集，則必須開發邏輯，以略過您不想處理的任何機會的 AWS 更新。此方法也應該套用至未來加入後的機會。您必須`partnerCrmUniqueIdentifier`為需要跨兩個 CRMs 保持一致的機會提供相關聯的 。此外，您應該指出哪些機會不會更新 （例如：標記閉鎖或閉鎖的機會），以排除更新的機會。請務必為所有與您接受 AWS 的公開/主動機會指派一個 `partnerCrmUniqueIdentifier`。

 **問：我可以只更新機會或潛在客戶中的特定欄位嗎？**

是。您只能提供需要更新的欄位，以及必要的識別符。

 **問：是否可以變更 *ApnCrmUniqueIdentifier***？

否。此識別符對於 保持不變， AWS 並唯一識別每個機會。

 **問：如果我提供不正確的 *partnerCrmUniqueIdentifier*，該怎麼辦**？

如果您提供不正確的識別符，則會建立新的機會。確保準確性，以避免資料重複。

 **問：我可以更新 AWS 提交的機會嗎？**

是。您可以使用正確的 來更新提交的機會 AWS `partnerCrmUniqueIdentifier`。

 **問：我可以預期提交機會的結果多久？**

處理幾乎是即時的，結果通常可在幾分鐘內在 `opportunity-inbound-processed-results` 資料夾中取得。

 **問：如果提交的機會發生處理錯誤，該怎麼辦？**

檢閱結果檔案中的錯誤詳細資訊、解決問題，並尋求 ACE 支援團隊的進一步協助。

 **問：我可以透過整合刪除機會嗎？**

否。不支援直接刪除。您可以更新機會以反映*已關閉*狀態。

 **問：*記錄無法編輯*的錯誤是什麼意思？**

如果您嘗試更新 ACE 檢閱中的機會，就會發生此錯誤。在驗證之前，無法編輯這些機會。

 **問：如果不傳送更新或新機會該怎麼辦？**

如果您未透過整合傳送更新或新機會，則不會接收和處理新資料。

 **問：結果檔案的可用時間有多長？**

結果檔案在合理的持續時間內可供使用。您應該立即擷取和管理它們。