本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 常見問答集
使用這些常見問題和答案來協助自訂整合。
**Topics**
+ [一般常見問答集](general-faq.md)
+ [技術常見問答集 - 欄位](technical-faq-fields.md)
+ [技術常見問答集—Amazon S3](technical-faq-s3.md)
+ [技術常見問答集 - 領導和機會](technical-faq-leads-and-opps.md)
+ [技術常見問答集 - 版本控制和回溯相容性](technical-faq-versioning.md)
# 一般常見問答集
## 整合如何運作？
**問：我是否可以存取用於傳送和接收檔案的 Amazon Simple Storage Service (Amazon S3) 儲存貯體？**
是。合作夥伴可以使用可存取儲存貯體之 AWS Identity and Access Management (IAM) 的私密/存取金鑰，以程式設計方式存取 Amazon S3 儲存貯體。合作夥伴將無法存取 Amazon S3 儲存貯體的主控台，因為這些儲存貯體位於 Amazon Web Services (AWS) 自己的帳戶中。
**問：合作夥伴的開發人員需要哪些技能集？**
合作夥伴的開發人員需要熟悉其客戶關係管理 (CRM) 系統和 Amazon S3。
**問：範例程式碼檔案是否包含完整的程式碼，還是合作夥伴必須撰寫程式碼？**
合作夥伴需要根據提供的範例程式碼檔案撰寫程式碼。
**問：如果合作夥伴以 Python、Golang 或任何其他語言開發其解決方案， 是否會 AWS Partner Network (APN) Customer Engagement (ACE) 為整合提供這些語言的任何軟體開發套件 (SDK)？**
否。
**問：從 Amazon S3 儲存貯體到內部 ACE 的同步程序是什麼？**
批次程序會每小時執行一次，以挑選檔案並同步資訊。 AWS 銷售團隊對記錄所做的任何更新，最多可能需要一小時才會傳送至合作夥伴的儲存貯體。合作夥伴可能會立即收到有關更新的電子郵件通知，但來自 的更新仍 AWS 可能會延遲一小時。
**問：ACE 上傳潛在客戶和機會檔案的頻率為何？**
ACE 每一小時傳送一次潛在客戶和機會資料。
**問：是否有 ACE 的沙盒環境？**
是。我們確實有 ACE 的沙盒環境，但基於安全考量，我們無法為合作夥伴提供存取權。如果您想要將新機會或潛在客戶推送到您的儲存貯體，請在 Partner Central 上提出支援案例。
**問：如何維護合作夥伴 CRM 和 APN 的識別符？**
為了為我們的合作夥伴提供更多彈性，我們在系統中使用兩組識別符。
1. `apnCrmUniqueIdentifier`： AWS 管理此識別符。它從`OXXXXXX`機會和潛在客戶`LXXXXXX`的 開始。
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`：合作夥伴會在其 CRM 中分別管理機會和潛在客戶的此識別符。合作夥伴應新增此識別符，同時導入新機會，以追蹤其 CRM 的更新。
在沒有 `apnCrmUniqueIdentifier`或 的情況下傳送機會時`partnerCrmUniqueIdentifier`， 會將其 AWS 視為新的機會，並為`apnCrmUniqueIdentifier`機會指派新的 。
使用 `apnCrmUniqueIdentifier`或 傳送機會時`partnerCrmUniqueIdentifier`， 會將其 AWS 視為更新動作，並使用承載資料更新現有的機會。
**問：如何防止在兩個系統中建立重複的記錄？**
從合作夥伴 CRM 端，傳送至 ACE 的每個記錄都必須有唯一的識別符，稱為 `partnerCrmUniqueIdentifier`。同樣地，ACE 也會維護每個記錄的唯一識別符，稱為 `apnCrmUniqueIdentifier`。傳送資料時，ACE 和合作夥伴都必須包含這兩個欄位，這有助於識別記錄是新的機會 （如果空白） 還是現有的機會 （如果填入）。
# 技術常見問答集 - 欄位
**問：整合是否支援 CSV 格式？**
否。整合只接受 JSON 檔案格式。
**問：何時必須從傳出資料夾刪除檔案？**
只有在您成功處理檔案後，才能刪除這些檔案。
**問：如果我不小心從傳出資料夾刪除檔案，在哪裡可以找到原始檔案？**
這些檔案可在 `opportunity-outbound-archive`和 `lead-outbound-archive` 資料夾中使用。
**問：我在開發期間應如何提供支援？**
如需開發期間的協助，請聯絡 Partner Central 上的 AWS Partner Network (APN) 支援。
**問： `opportunityOwnerName`和 之間的差異是什麼`opportunityOwnerEmail`？**
+ `opportunityOwnerName`：合作夥伴組織中的機會擁有者名稱。這必須是 Partner Central 使用者。
+ `opportunityOwnerEmail`：合作夥伴組織中的機會擁有者的電子郵件。這必須是 Partner Central 使用者。如果未提供，則會使用 Partner Central Alliance Lead 做為擁有者來建立機會。
**問：所有日期欄位 (`targetCloseDate`、`createdDate`、 `lastModifiedDate`和 ) 的時區為何`acceptBy`？**
日期欄位的時區是格林威治標準時間 (GMT)。
**問：傳入 JSON 檔案是否已版本控制？**
否。Amazon Web Services (AWS) 不支援檔案的版本控制。APN Customer Engagement (ACE) 會在接收後立即處理檔案，然後在成功處理後刪除檔案。如果我們再次收到相同的檔案名稱，則會遭到拒絕。
**問：Amazon Simple Storage Service (Amazon S3) JSON 檔案中的哪些欄位表示特定潛在客戶和機會的建立和最新更新日期？**
`createdDate` 與 `lastModifiedDate`。
**問：如何判斷機會是新的還是現有的？**
欄位`PartnerCrmUniqueIdentifier`是我們要求合作夥伴提供的每個機會的唯一識別符。此識別符必須在合作夥伴系統的來源 CRM 中定義。我們使用它來判斷機會是否存在 AWS。如果存在，我們會使用共用資訊更新機會。如果沒有，我們會建立新的機會。
將資料傳送給合作夥伴時，我們會同時包含 `PartnerCrmUniqueIdentifier`和 `apnCrmUniqueIdentifier`。如果 AWS 共用的機會是第一次傳送，您就不會看到 的任何值`PartnerCrmUniqueIdentifier`。這可協助您將機會視為來自 ACE 的新機會。將其擷取到您的 CRM 後，您可以使用 `PartnerCrmUniqueIdentifier`和 將更新傳回給我們`apnCrmUniqueIdentifier`。
**問：Amazon S3 中是否可以有多個傳出和結果 JSON 檔案？**
是。有時，我們可能會在傳出資料夾中產生更多檔案。同樣地，如果您將檔案傳送到傳入資料夾，我們會處理這些檔案，並將結果檔案保留在結果資料夾中。您必須在處理後標記或刪除結果檔案。
**問：傳出檔案是否包含多個記錄？**
是。傳出檔案可以包含多個記錄。
**問：如果在機會區段下的單一輸入 JSON 檔案中傳送 20 個傳入機會，且其中一個機會不符合 APN 標準，會發生什麼情況？**
如果格式不正確，無論大小寫為何，都會拒絕整個檔案。如果格式正確，但我們無法處理一個機會，則結果檔案會包含所有 20 個機會及其狀態，以及失敗機會的錯誤訊息。
**問：要驗證 JSON 檔案是否已成功處理的關鍵屬性是什麼？**
這些是關鍵屬性，可協助您了解 JSON 檔案是否已成功處理。
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**問：如果我傳送無效的 JSON，會發生什麼情況？**
您收到此錯誤回應："`[{input JSON}]` 不是類型 `object`"。
**問：單一傳入 JSON 檔案中可以包含多少潛在客戶/機會記錄？**
一個檔案中最多可有 50 筆記錄。
# 技術常見問答集—Amazon S3
**問：我可以在哪裡取得 Amazon Simple Storage Service (Amazon S3) REST API 文件？**
如需詳細資訊，請參閱 [Amazon S3 REST API 簡介](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html)。
**問：如何取得 Amazon Web Services AWS Key Management Service (AWS KMS) 金鑰詳細資訊以驗證存取 Amazon S3 儲存貯體？**
AWS Partner Network (APN) 共用包含金鑰名稱的政策。
**問：如何從 Salesforce.com (SFDC) 驗證 Amazon S3？**
使用範例程式碼檔案 [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) 從 SFDC 驗證 Amazon S3。
**問：如何將檔案從軟體開發套件 AWS (SDK) 上傳至 S3？**
使用下列 AWS CLI 命令將檔案上傳至 S3。
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
範例程式碼檔案 [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) 包含從 SFDC 上傳資料檔案的程式碼。
**問：誰擁有 Amazon S3 儲存貯體？**
AWS 擁有和管理 Amazon S3 儲存貯體。您可以使用 AWS Identity and Access Management (IAM) 使用者以程式設計方式存取自己的 Amazon S3 儲存貯體。
**問：是否有用於接收和傳送檔案的個別資料夾或儲存貯體？**
有一個儲存貯體具有不同的資料夾，可用來接收和傳送檔案。如需資料夾的進一步詳細資訊，請參閱 使用者指南。
**問：我是否需要使用 存取 Amazon S3 儲存貯體 AWS Lambda，還是可以使用客戶關係管理 (CRM) 系統直接存取它？**
您可以雙向存取它。
**問：Amazon S3 儲存貯體是否受到保護或加密？**
是。我們啟用 Amazon S3 提供的預設加密機制。
**問：是否可以啟用 Amazon Simple Notification Service (Amazon SNS) 接聽 Amazon S3 儲存貯體，因此我只能對事件採取行動，而不是定期輪詢？**
否。目前，APN Customer Engagement (ACE) 不支援此功能。
**問：我可以存取哪些資料夾？每個資料夾的目的是什麼？**
您可以在 中找到 Amazon S3 資料夾的清單[整合的先決條件](crm-integration-setting-up.md)。
# 技術常見問答集 - 領導和機會
## 傳送和接收潛在客戶和機會
**問：是否有檔案命名慣例？**
每個檔案名稱都必須是唯一的。我們建議使用檔案名稱 `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 推薦機會或潛在客戶時，該怎麼辦？**
第一次同步新機會或潛在客戶時，您需要接受或拒絕它，才能取得其他資料 （例如：客戶聯絡人）。
## 建立和更新機會/領導
**問：如何透過整合將新的*合作夥伴推薦 （來源）* 機會導入 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 檢閱中的機會，就會發生此錯誤。在驗證之前，無法編輯這些機會。
**問：如果不傳送更新或新機會該怎麼辦？**
如果您未透過整合傳送更新或新機會，則不會接收和處理新資料。
**問：結果檔案的可用時間有多長？**
結果檔案在合理的持續時間內可供使用。您應該立即擷取和管理它們。
# 技術常見問答集 - 版本控制和回溯相容性
**問：什麼是 Amazon Web Services (AWS) 資料交換中的承載？**
承載是以 JSON 格式的結構化資料片段，可傳入 AWS 或傳出 AWS。此 JSON 結構中的每個索引鍵稱為 *欄位*，且每個欄位都有相關聯的*值。*
**問：承載版本是如何決定的？**
承載版本是在承載本身的 `version` 欄位中指定。遵循欄位定義 v13 的承載會被視為承載版本 1.0，而遵循欄位定義 v14 或更高版本中定義格式的承載則稱為承載版本 2.0。
**問：在這種情況下，回溯相容性意味著什麼，以及如何處理它？**
回溯相容性可確保在較新的承載版本中引入新的和強制性欄位時，現有的機會不會失敗。 會透過自動將預設值指派給新版本中所需的欄位來 AWS 維持此狀態。您可能會在 AWS Partner Network (APN) 客戶參與 (ACE) UI 中發現值，而您並未透過客戶關係管理 (CRM) 整合明確提供這些值。每個欄位的詳細資訊和條件會在欄位描述或 欄位的其他詳細資訊中說明。
**問：回溯相容性是否為永久功能？**
否。回溯相容性有時間限制，旨在為您提供規劃和實作近期變更的彈性。它在指定的截止日期之後停止運作，這將在今年稍後作為更廣泛啟動的一部分宣布。
**問：當我開始使用 2.0 版傳送承載時，會發生什麼情況？**
使用 2.0 版傳送承載後，系統會假設已實作所有必要的變更，而新承載版本的驗證會套用至所有後續變更。請務必不要在 1.0 版和 2.0 版承載之間部分實作功能。
**問：更新至 2.0 版後，我可以還原至承載 1.0 版嗎？**
否。轉換為承載版本 2.0 是單向程序。更新至 2.0 版之後，您就無法還原至 1.0 版的承載。