本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用舊版 CRM 搭配 Amazon S3 整合
**重要**
AWS Partner Central 在 2024 年停止接受這類整合的新請求。本節僅適用於使用 Amazon S3 的合作夥伴。
若要開始使用新的自訂 CRM 整合，請參閱 [AWS Partner Central API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)。
**Topics**
+ [從具有 Amazon S3 整合的 CRM 升級到 Partner Central API](upgrade-crm-api.md)
+ [使用 Amazon S3 整合設定 CRM 的連接器](s3-config.md)
+ [整合資源](resources.md)
+ [潛在客戶共享](custom-lead-sharing.md)
+ [機會共享](custom-opportunity-sharing.md)
+ [欄位映射](custom-field-mapping.md)
+ [建立同步排程](crm-connector-scheduling.md)
+ [最佳實務](best-practices.md)
+ [配額](quotas.md)
+ [版本歷史記錄](version-history.md)
+ [常見問答集](faqs.md)
# 從具有 Amazon S3 整合的 CRM 升級到 Partner Central API
**注意**
本節中的主題假設您已完成 AWS Partner Central 整合、 AWS Market Marketplace 整合或兩者的先決條件。如需詳細資訊，請參閱本指南[開始使用](crm-integration-getting-started.md)前面的 [整合的先決條件](crm-integration-setting-up.md)和 。
以下各節中的步驟說明如何從具有 Amazon S3 整合的舊版 CRM 升級到 AWS Partner Central API。升級不需要數個 ACE 需求，例如整合使用者的需求，以及設定同步排程的需求。
**Topics**
+ [升級功能](api-upgrade-features.md)
+ [設定具名登入資料](set-up-api-credentials.md)
+ [將核准狀態按鈕新增至機會閃電記錄頁面](add-approval-status-button.md)
+ [新增其餘按鈕](add-remaining-buttons.md)
+ [重新整理解決方案方案索引標籤](refresh-the-solutions-from-the-solution-offerings-tab.md)
# 升級功能
升級提供下列功能：
+ 您不再需要 Salesforce 中的 ACE 整合使用者許可集。
+ 您不再需要為 Salesforce 中的 ACE 機會建立排程。
+ Partner Central API 也提供一組按鈕，可在**機會閃電記錄**頁面上啟用下列動作：
+ **核准狀態** – 接受或拒絕被 AWS 推薦機會。
**注意**
此按鈕會取代**合作夥伴接受狀態**清單。您必須使用 按鈕來接受 AWS來源的機會。
+ **與 共用 AWS** – 建立和更新機會。
+ **關聯或取消關聯** – 在整個機會生命週期中，將機會與合作夥伴解決方案、 AWS 產品和 AWS Marketplace 優惠建立關聯或取消關聯。
+ **指派** – 將機會重新指派給您 Partner Central 帳戶中的另一個使用者。
您可以在設定具名登入資料後新增按鈕。下列主題說明如何完成這些任務。
# 設定具名登入資料
若要升級至 Partner Central API，您必須先設定具名登入資料。CRM 連接器使用您的 Salesforce 組織登入資料向 Partner Central 進行身分驗證。
**設定登入資料**
1. 以系統管理員身分登入 Salesforce。
1. 在**具名憑證**下，選擇稍**早新增**。
1. 在**新增具名憑證**表單中，輸入下表中的值。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/set-up-api-credentials.html)
1. 選擇**儲存**。
1. 返回**AWS引導式設定**頁面。在**身分驗證詳細資訊**區段中，選擇**檢閱**並確認憑證。
# 將核准狀態按鈕新增至機會閃電記錄頁面
下列步驟說明如何將**核准狀態**按鈕新增至 Opporuntiy Lightning 記錄頁面。按鈕可讓您在機會通過核准程序時查看機會的狀態。
**新增按鈕**
1. 以系統管理員身分登入 Salesforce 組織。
1. 導覽 至**機會閃電記錄**頁面。
1. 選擇反白顯示的面板以開啟屬性窗格。
1. 選取**立即升級**。
1. 選取**遷移現有動作**，然後選取您要從中升級動作的頁面配置。
-或是-
從頭開始，並手動新增動作。
1. 從**動作**清單中，選擇**核准狀態**。
1. 選擇**儲存**。
**注意**
您只需要完成步驟 4 和步驟 5 一次。
**核准狀態**按鈕只會出現在**機會閃電記錄**頁面 AWS中，以取得所參考的機會。
# 新增其餘按鈕
您可以新增下列步驟中列出的部分或全部按鈕。
**新增按鈕**
1. 以系統管理員身分登入 Salesforce 組織。
1. 導覽 至**機會閃電記錄頁面**。
1. 選擇反白顯示的面板以開啟屬性窗格。
1. 選擇**從動作指派**，然後選取以下部分或全部項目：
+ **與 共用 AWS**
+ **關聯或取消關聯**
+ **指派**
如需每個按鈕功能的詳細資訊，請參閱本指南[升級功能](api-upgrade-features.md)稍早的 。
1. 選擇**儲存**。
# 重新整理解決方案方案索引標籤
下列步驟說明如何重新整理**解決方案方案**索引標籤上的資料。
1. 以系統管理員身分登入 Salesforce 組織。
1. 導覽至**解決方案方案**索引標籤。
1. 選取**重新整理解決方案**。
# 使用 Amazon S3 整合設定 CRM 的連接器
**重要**
從 2024 年開始，AWS Partner Central 讓新使用者無法使用此整合類型。
**注意**
本節中的主題假設您已完成 AWS Partner Central 整合、 AWS Marketplace 整合或兩者的先決條件。如需詳細資訊，請參閱本指南[開始使用](crm-integration-getting-started.md)前面的 [整合的先決條件](crm-integration-setting-up.md)和 。
已取代的 CRM 與 Amazon S3 整合會使用 Amazon S3 儲存貯體來轉移潛在客戶和機會。我們建議您使用 Partner Central API 整合，如上一節所示來建立和管理機會。不過，如果您想要使用連接器來管理 Salesforce 中的潛在客戶，則可以使用此組態。
**Topics**
+ [輸入連線身分驗證詳細資訊](#apn-s3-authentication-details)
+ [輸入系統組態設定](#apn-s3-config-settings)
+ [測試連線](#apn-s3-testing)
+ [傳送和接收機會和潛在客戶](#sending-receiving-opportunities-leads)
+ [生產檢查清單](ace-production-checklist.md)
+ [將 AWS Partner CRM 連接器升級至新的資料模型](connector-upgrade-plan.md)
+ [使用自訂 ACE 機會和 ACE 領導物件進行沙盒測試](custom-ace-opportunity.md)
+ [將 AWS Marketplace 私有優惠連結至 ACE 機會](#linking-private-offers-to-ace)
## 輸入連線身分驗證詳細資訊
合作夥伴透過輸入連線至其 Amazon S3 端點所需的詳細資訊來啟動整合程序。按照列出的順序遵循每組步驟，並完成每組步驟，然後再繼續進行下一個步驟。
下列任務是從**AWS 引導式設定**索引標籤執行。如需有關使用 標籤的資訊，請參閱本指南[使用引導式設定](use-guided-setup.md)前面的 。
**輸入身分驗證詳細資訊**
1. 在 Salesforce 中，開啟**AWS 引導式設定**索引標籤。如需有關開啟該標籤的資訊，請參閱本指南[使用引導式設定](use-guided-setup.md)前面的 。
1. 展開**步驟 1： AWS 連線身分驗證詳細資訊**，然後選擇**開始。**
1. 在**具名憑證**頁面上，選擇**稍早新增**。
1. 在**新增具名登入**資料表單中，輸入下表中的值。
| **欄位** | **Value** |
| --- | --- |
| 標籤 | APN API 連線 |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| 身分類型 | 具名委託人 |
| 身分驗證通訊協定 | AWS 簽章第 4 版 |
| AWS 存取金鑰 ID | Cloud-Ops 在先決條件步驟期間提供 ID |
| AWS 私密存取金鑰 | Cloud-Ops 在先決條件步驟期間提供存取金鑰 |
| AWS 區域 | us-west-2 |
| AWS 服務 | s3 |
| 產生授權標頭 | checked |
| 允許 HTTP 標頭中的合併欄位 | 未核取 |
| 允許 HTTP 內文中的合併欄位 | 未核取 |
1. 選擇**儲存**。
1. 返回**AWS引導式設定**頁面。在**身分驗證詳細資訊**區段中，選擇**檢閱**並確認憑證。
1. 保持**AWS引導式設定**頁面開啟，並前往後續步驟。
## 輸入系統組態設定
下列步驟說明如何為整合輸入正確的系統組態設定。
1. 展開**步驟 2：系統組態設定**，然後選擇**開始。**
1. 找到**AWS 合作夥伴 CRM 連接器設定**，然後選擇**管理**。
1. 選擇**新增**，然後從下表輸入所需的值。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/s3-config.html)
1. 選擇**儲存**。
1. 返回**AWS引導式設定**頁面。在**身分驗證詳細資訊**區段中，選擇**檢閱**並確認憑證。
## 測試連線
在測試連線之前，請確定您已完成先前章節中的步驟。
**測試連線**
1. 展開**步驟 3：測試 APN API 的組態**。
1. 選擇**測試**。
如果連線成功，您會收到確認訊息。
## 傳送和接收機會和潛在客戶
您可以透過與 Partner Central 同步傳送和接收機會和潛在客戶。若要同步機會或潛在客戶，您必須將 **Sync with Partner Central** 欄位設定為 **True**。用於整合的其他金鑰欄位包括**上次 APN 同步日期**和**有資格與 APN 同步**的欄位。
這些欄位包含在標準機會和潛在客戶中。不過，您必須為任何自訂來源物件建立並映射它們。
+ **與 Partner Central 同步** – 包含在應用程式中以取得標準機會和潛在客戶。如果 AWS Partner 選擇映射到自訂物件，則必須分別在機會和潛在客戶映射中建立和映射自訂布林值欄位。
+ **與 APN 的上次同步日期** – 表示記錄上次成功傳送至 APN 或從 APN 接收的時間。當記錄成功傳送至 APN 或從 APN 接收更新時，此欄位會自動設定。
+ **有資格與 APN 同步** – 公式欄位，可判斷記錄是否在下一個排程任務中被設為傳送至 APN。根據自上次執行傳出排程以來是否修改記錄，並且由 AWS Partner組織指定整合使用者以外的使用者更新記錄。
# 生產檢查清單
請依照下列步驟完成 AWS Partner CRM 連接器的生產安裝。
1. 確認您已完成 CRM 整合的[加入程序](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html)。在此程序的第 [6 階段](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html)中，您會設定生產環境並執行資料遷移，以便管理機會並領導整合。
1. 安裝和設定 CRM 連接器。如需詳細資訊，請參閱 [安裝連接器](install-connector.md)。
1. 選擇下列其中一個映射選項來映射機會和領導物件。如需參考，請參閱 GitHub 上的此[必要欄位](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)清單。
+ 使用 AWS Partner CRM 連接器隨附的 AWS ACE 機會自訂物件來記錄和共用機會 AWS。使用此選項，您可以自動將 AWS 欄位映射至 Salesforce 欄位。
+ 使用標準 Salesforce 物件並映射必要 AWS 欄位。
+ 使用 ACE 自訂機會物件。您首先建立一個工作流程來填入 ACE 機會物件的中繼資料表，然後將 Salesforce 欄位映射至 AWS。
1. 如需映射選項的其他詳細資訊和指引，請參閱 [映射 ACE 物件](crm-connector-mapping.md)。
1. （選用） 設定網路和 Salesforce AWS Partner 之間的傳入和傳出同步排程。如需詳細資訊，請參閱 [建立同步排程](crm-connector-scheduling.md)。
1. 若要驗證生產環境中的合作夥伴來源機會，請在您的 Partner Central 帳戶中向 Partner Central Operations (PCO) 提出[支援案例](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting)。在此程序中，您會建立虛擬機會、與 同步 AWS，並要求 AWS 支援客服人員確認 AWS 已收到機會。在測試結束時，請您的 AWS 支援代理程式拒絕機會請求，以便您能夠將其從旁邊刪除。
1. （選用） 執行資料回填。此程序可確保在未來更新期間可以識別 AWS 來源和合作夥伴來源的機會推薦。如需詳細資訊，請參閱 CRM 加入程序中的[階段 6：生產核准](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html)。
1. 啟用生產整合，以允許透過 Amazon S3 儲存貯體交換檔案。如需詳細資訊，請參閱[階段 7：啟動](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html)。
# 將 AWS Partner CRM 連接器升級至新的資料模型
**重要**
升級生產環境之前，請在沙盒 Salesforce 組織中測試並核准新的資料模型升級。如需新資料模型和新模型之間的變更，請參閱 GitHub 上的下列 [aws-samples/partner-crm-integration-samples](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples)：
**Opportunity-FieldsAndStandardValues-DiffWithPrevVersion-V14.3.xlsx**
**Opportunity-Fields.xlsx**
**Opportunity\$1-\$1StandardValues.xlsx**
## 先決條件
+ 將欄位定義用於 ACE CRM 整合的新資料模型準則，並遷移任何必要的開啟機會，並導致新的資料模型。
+ 新增或移除自訂或標準物件中的資料欄 （用於映射的物件）。
+ 請確定您使用的是 2.0 版或更新版本的 AWS Partner CRM 連接器。
**升級到新的資料模型**
1. 以系統管理員身分登入 Salesforce 組織。
1. 停用任何作用中排程。
1. 選擇**設定**、**自訂設定**、**AWS Partner CRM 連接器設定**，然後將版本更新為 **2.0 **或更新版本。
**注意**
從 2.0 版開始，**版本**欄位為必要欄位。此欄位指定合作夥伴用來與 CRM 整合互動的承載版本。當合作夥伴移至 2.0 版時，他們必須完全採用其規格。不允許還原至先前的版本。
1. 選擇 **ACE 映射**索引標籤。
1. 建立、檢閱和更新所有必要的欄位映射和詳細資訊。針對沙盒測試，請使用自訂 ACE 機會和 ACE 潛在客戶物件來測試新的資料模型功能。如需詳細資訊，請參閱 [使用自訂 ACE 機會和 ACE 領導物件進行沙盒測試](custom-ace-opportunity.md)。
1. 啟用機會和潛在客戶的排程。
1. 檢閱 ACE 同步日誌是否有同步錯誤，並進行任何更正。
1. 檢閱同步的機會並引導，以確保資料轉換的準確性。或者，檢閱 ACE 中的機會和潛在客戶，以確保準確擷取新的資料模型變更。
1. 遵循您的產品部署程序，將變更遷移至您的生產 Salesforce 環境。
**注意**
如果您需要協助，請參閱 [取得說明](getting-help.md)。
# 使用自訂 ACE 機會和 ACE 領導物件進行沙盒測試
**注意**
如果您是現有的 CRM 連接器使用者，請參閱 [將 AWS Partner CRM 連接器升級至新的資料模型](connector-upgrade-plan.md)。
1. 以系統管理員身分登入 Salesforce 組織。
1. 選擇**設定**、**自訂設定**、**AWS Partner CRM 連接器設定**，並將版本更新為 **2**。
1. 選擇 **ACE 映射**索引標籤。
1. 對於**機會**，將其映射到 **ACE 機會**自訂物件。
1. 選擇 **Auto Map ACE 物件**。
**注意**
如果您想要升級到想要使用自訂 ACE 機會的新版本 CRM 連接器和連接器的 ACE 潛在客戶物件進行沙盒測試，建議您在使用 Auto Map ACE 物件功能之前，從資料庫手動刪除 `Field Mappings`和 `Field Mapping Details` 物件中的任何可用記錄。您只需要執行一次此操作。
1. 檢閱挑選清單和多重挑選清單的欄位映射和欄位映射值。
1. 啟用機會和潛在客戶的排程。
1. 檢閱 ACE Sync Logs 是否有同步錯誤，並進行任何必要的更正。
1. 檢閱同步的機會和潛在客戶，以確保資料轉換的準確性。或者，檢閱 ACE 中的機會和潛在客戶，以確保已準確擷取新的資料模型變更。
## 檢視 ACE 機會的同步日誌詳細資訊記錄
您可以在 ACE 機會記錄的相關****索引標籤上檢視已交付 AWS ACE 機會的同步日誌詳細資訊。
**注意**
這些步驟僅適用於交付的 AWS ACE 機會物件。如果您映射到 Salesforce 組織中的標準或自訂物件，您可以在 **ACE Sync Log 索引標籤上檢視同步日誌**詳細資訊。
1. 登入您的 Salesforce 組織。
1. 在**應用程式啟動器**中，選擇 **AWS Partner CRM 連接器**。
1. 選擇 **ACE 機會**索引標籤。
1. 選擇 ACE 機會記錄。
1. 選擇**相關**索引標籤以檢視詳細資訊，包括**同步日誌名稱**、**狀態**、**錯誤訊息**和**建立日期**。
## 將 AWS Marketplace 私有優惠連結至 ACE 機會
您可以直接從 AWS 交付的 ACE 機會記錄頁面連結私有優惠。
1. 登入您的 Salesforce 組織。
1. 在**應用程式啟動器**中，選擇 **AWS Partner CRM 連接器**。
1. 選擇 **ACE 機會**索引標籤。
1. 選擇 ACE 機會記錄。
1. 選擇**連結私有優惠**。
1. 在**優惠 ID 查詢**中，選擇私有優惠。
1. 選擇**儲存**。
# 整合資源
AWS 提供下列資源，協助您建立自訂整合。
**Topics**
+ [欄位定義](#custom-field-definitions)
+ [標準值](#standard-values)
+ [傳入檔案範例](#sample-inbound-files)
+ [範例傳出檔案](#sample-outbound-files)
+ [處理結果範例](#sample-processed-results)
+ [範例測試案例](#sample-test-cases)
+ [程式碼片段範例](#sample-code-snippets)
## 欄位定義
下列各節中的連結會列出所有欄位，說明其資料類型、用量，以及任何適用的限制或格式規則。它們可做為參考，以確保當合作夥伴和 AWS 交換資料時，其格式正確且受到理解。
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## 標準值
這些清單概述了各種欄位的標準值和列舉。它們有助於維持交換資料中的一致性，並確保雙方對所使用的值有共識。
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## 傳入檔案範例
下列範例檔案顯示從合作夥伴傳送至之檔案的 JSON 承載結構 AWS。
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## 範例傳出檔案
下列範例檔案顯示從 傳送至 AWS 合作夥伴之檔案的 JSON 承載結構。
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## 處理結果範例
下列檔案顯示 AWS 處理合作夥伴傳送的承載後的一般結果。
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## 範例測試案例
以下連結將帶您前往 GitHub。
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## 程式碼片段範例
以下連結將帶您前往 GitHub。
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC apex s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1from\$1s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# 潛在客戶共享
## AWS 共用如何領導
1. **增量匯出**：Amazon Web Services (AWS) AWS每小時匯出由 參考的新潛在客戶 （和更新）。
1. **檔案建立**： AWS 產生符合特定格式的潛在客戶檔案。如需詳細的檔案規格，請參閱 [欄位定義](resources.md#custom-field-definitions)。
1. **檔案上傳**：潛在客戶檔案會上傳到 `lead-outbound` 資料夾。
## 從 取用潛在客戶 AWS
若要有效地使用 的潛在客戶 AWS，請使用下列功能建置自訂整合。
1. **檔案擷取**：
+ 定期以您選擇的間隔使用排程任務掃描`lead-outbound`資料夾。
+ 擷取主要檔案以進行處理。
1. **資料轉換和映射**：
+ 讀取每個檔案的內容之後，請將資料轉換並映射至客戶關係管理 (CRM) 系統中的潛在客戶記錄。
+ 如需欄位映射的指引，請參閱 [欄位映射](custom-field-mapping.md)。
1. **潛在客戶識別**：
+ 使用 `partnerCrmLeadId`或 唯一識別每個潛在客戶`apnCrmUniqueIdentifier`。
+ 如果 `partnerCrmLeadId` 為空白且`apnCrmUniqueIdentifier`存在，則潛在客戶是來自 AWS Partner Network (APN) Customer Engagement (ACE) 的新推薦。
+ 如果兩個識別符都存在，則會將記錄視為來自 ACE 的更新。
1. **潛在客戶擷取**：
+ 在 CRM 系統中擷取新的潛在客戶或更新現有的潛在客戶。
1. **檔案管理**：
+ 成功處理每個潛在客戶和完整檔案資料後，請從傳出資料夾刪除檔案。
+ 每個檔案都會自動封存在 `lead-outbound-archive` 資料夾中。
**整合和程式碼參考**：
+ 若要讀取上傳至 Amazon Simple Storage Service (Amazon S3) 儲存貯體的檔案，您可以使用 AWS Lambda 或直接從 CRM 系統讀取。
+ 使用下列 Lambda 和 Salesforce REST API 的範例代碼來驗證和更新 CRM 記錄。
+ **用於驗證檔案的 Lambda**：[ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)。
+ **Salesforce REST API**：[Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)。
+ 如果您使用 Salesforce 以外的 CRM 系統，則必須提供專屬於您系統的程式碼來更新資料。
## 與 共用潛在客戶的更新 AWS
1. **識別潛在客戶**：使用要共用的更新來尋找潛在客戶 AWS。
1. **資料轉換**：將資料轉換為 AWS 格式，如 中所述[欄位定義](resources.md#custom-field-definitions)。
1. **檔案建立**：
+ 產生 JSON 格式的潛在客戶檔案。
+ 將時間戳記附加到每個檔案，確保所有檔案名稱都是唯一的，並遵循格式：`{name}_MMDDYYYY24HHMMSS.json`。
1. **驗證和上傳**：
+ 驗證為 ACE Amazon S3 儲存貯體。
+ 將檔案上傳至 `lead-inbound` 資料夾。與 共用的所有檔案 AWS 都會自動封存在 `lead-inbound-archive` 資料夾中。
+ 當您將檔案上傳至 S3 時，請確定您提供儲存貯體擁有者的完整存取權。
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
請參閱[「結果範例 file.json」](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)中執行此命令的範例結果。
1. **檔案處理**：
+ 收到檔案時， AWS 會自動處理檔案。
+ 處理的結果會上傳至 Amazon S3 儲存貯體中的 `lead-inbound-processed-results` 資料夾。這包括成功和錯誤的狀態，以及每個潛在客戶的任何錯誤訊息。
+ 這些處理的結果也會封存在 `lead-inbound-processed-results-archive` 資料夾中。
+ 如需詳細資訊，請參閱 [技術常見問答集 - 領導和機會](technical-faq-leads-and-opps.md)。
1. **回應處理**：
+ 您必須開發邏輯來取用這些回應、檢閱錯誤記錄、更正任何錯誤，以及將資料重新傳送至 ACE。
+ 您可以在常見問答集和疑難排解區段中找到範例錯誤。
+ 若要從 CRM 將檔案上傳至 Amazon S3：
+ 參考 AWS 簽章的版本。
+ 使用 HTTPS 請求上傳檔案。
+ 如需參考，請使用下列檔案將檔案上傳至 Amazon S3 儲存貯體：
+ **驗證 S3 儲存貯體**時：[S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **將檔案上傳至 S3 儲存貯體**：[Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **注意：**檔案的大小不得超過 1 MB，而且不會處理重複的檔案。
# 機會共享
## 如何 AWS 分享機會
1. **增量匯出**：Amazon Web Services (AWS) 每小時匯出由 參考的新機會 AWS（和更新）。
1. **檔案建立**： AWS 產生符合特定格式的機會檔案。如需詳細的檔案規格，請參閱[機會欄位定義](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)。
1. **檔案上傳**：機會檔案會上傳到 `opportunity-outbound` 資料夾。
## 從 取用機會 AWS
若要有效利用來自 的機會 AWS，您需要建立與這些功能的自訂整合。
1. **檔案擷取**：
+ 使用排程任務，以您選擇的間隔定期掃描`opportunity-outbound`資料夾。
+ 擷取要處理的機會檔案。
1. **資料轉換和映射**：
+ 讀取每個檔案的內容之後，請將資料轉換並映射至客戶關係管理 (CRM) 系統中的機會記錄。
+ 如需欄位映射的指引，請參閱 [欄位映射](custom-field-mapping.md)。
1. **機會識別**：
+ 使用 `partnerCrmOpportunityId`或 唯一識別每個機會`apnCrmUniqueIdentifier`。
+ 如果 `partnerCrmOpportunityId` 為空白且`apnCrmUniqueIdentifier`存在，則機會是來自 AWS Partner Network (APN) Customer Engagement (ACE) 的新推薦。
+ 如果兩個識別符都存在，則會將記錄視為來自 ACE 的更新。
1. **機會擷取**：擷取新機會或更新 CRM 系統中的現有機會。
1. **檔案管理**：
+ 成功處理每個機會和完整的檔案資料後，請從傳出資料夾刪除檔案。
+ 每個檔案都會自動封存在 `opportunity-outbound-archive` 資料夾中。
**整合和程式碼參考**：
+ 若要讀取上傳至 Amazon Simple Storage Service (Amazon S3) 儲存貯體的檔案，您可以使用 AWS Lambda 或直接從 CRM 系統讀取。
+ 使用下列 Lambda 和 Salesforce REST API 的範例代碼來驗證和更新 CRM 記錄。
+ **用於驗證檔案的 Lambda**：[ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)。
+ **Salesforce REST API**：[Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)。
+ 如果您使用 Salesforce 以外的 CRM 系統，則必須提供專屬於您系統的程式碼來更新資料。
## 與 共用機會的更新 AWS
1. **識別機會**：找到要與 共用更新的機會 AWS。
1. **資料轉換**：將資料轉換為 AWS 格式，如 中所述[欄位定義](resources.md#custom-field-definitions)。
1. **檔案建立**：
+ 產生 JSON 格式的機會檔案。
+ 將時間戳記附加到每個檔案，確保所有檔案名稱都是唯一的，並遵循格式：`{name}_MMDDYYYY24HHMMSS.json`。
1. **驗證和上傳**：
+ 驗證為 ACE Amazon S3 儲存貯體。
+ 將檔案上傳至 `opportunity-inbound` 資料夾。與 共用的所有檔案 AWS 都會自動封存在 `opportunity-inbound-archive` 資料夾中。
+ 當您將檔案上傳至 S3 時，請確定您提供儲存貯體擁有者的完整存取權：
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
請參閱在[機會結果成功 Sample.json 中執行此命令的範例結果。](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
1. **檔案處理**：
+ 收到檔案時， AWS 會自動處理檔案。
+ 處理結果會上傳至 Amazon S3 儲存貯體中的 `lead-inbound-processed-results` 資料夾。這包括成功和錯誤的狀態，以及每個機會的任何錯誤訊息。
+ 這些處理的結果也會封存在 `opportunity-inbound-processed-results-archive` 資料夾中。
+ 如需詳細資訊，請參閱 [技術常見問答集 - 領導和機會](technical-faq-leads-and-opps.md)。
1. **回應處理**：
+ 您必須開發邏輯來取用這些回應、檢閱錯誤記錄、更正任何錯誤，以及將資料重新傳送至 ACE。
+ 您可以在常見問答集和疑難排解區段中找到範例錯誤。
+ 若要從 CRM 將檔案上傳至 Amazon S3：
+ 參考 AWS 簽章的版本。
+ 使用 HTTPS 請求上傳檔案。
+ 如需參考，請使用下列檔案將檔案上傳至 Amazon S3 儲存貯體：
+ **驗證 S3 儲存貯體**時：[S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **將檔案上傳至 S3 儲存貯體**：[Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **注意：**檔案的大小不得超過 1 MB，而且不會處理重複的檔案。
# 欄位映射
欄位映射是整合程序中的重要步驟，其中合作夥伴會將其客戶關係管理 (CRM) 系統的欄位與 Amazon Web Services () 定義的欄位保持一致AWS。這可確保雙方準確交換和了解資料。以下是協助此程序的指導方針。
## 必要欄位映射
+ 將每個必要欄位映射至 CRM 系統中對應的欄位。當您確保所有必要欄位都映射時，成功進行資料交換至關重要。如需詳細資訊，請參閱 [欄位定義](resources.md#custom-field-definitions)
+ [機會](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [潛在客戶](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## 處理選用欄位
+ 了解整合程序中選用欄位的角色。決定您是否要根據您的業務需求對應這些欄位，並注意讓它們保持未映射的任何可能影響。
## 值映射
+ 將 CRM 中的每個欄位值與必要的 AWS Partner Network (APN) 客戶互動 (ACE) 清單值對齊，如 中所指定[欄位定義](resources.md#custom-field-definitions)。這對於維持資料一致性和完整性很重要。
## 資料類型和格式驗證
+ 確認 CRM 系統中欄位的資料類型和格式與 AWS *欄位定義*中指定的資料類型和格式相符。請務必維持資料類型和格式的一致性，以防止資料損毀並確保無縫整合。
## 欄位長度和限制
+ 請注意欄位長度限制和其他限制。確保 CRM 系統的資料符合 中的對應欄位， AWS 而不會遭到截斷或導致錯誤。
## 資料類型和格式驗證
+ 確認 CRM 系統中的欄位資料類型和格式與 中指定的資料類型和格式相符[欄位定義](resources.md#custom-field-definitions)。防止資料損毀並確保與資料類型和格式的一致性無縫整合至關重要。
## 定期審查和更新
+ 定期檢閱和更新欄位映射，以適應 CRM 系統或 AWS 需求中的變更。這種主動方法可確保持續的資料交換準確性和效率。
## 欄位映射文件
+ 維護全面的欄位映射文件。此實務有助於疑難排解、未來更新，並確保系統之間資料傳輸方式的清晰度。
## 測試和驗證
+ 進行徹底的欄位映射測試，以驗證資料是否準確傳輸和轉換。立即解決任何差異或問題，以確保資料完整性。
## 處理不需要的覆寫
+ 若要防止 AWS 資料覆寫特定 CRM 欄位，請考慮下列事項：
+ 為您要保護的資料建立自訂 CRM 欄位。
+ 讓銷售代表檢閱此自訂欄位。
+ 核准自訂欄位後，將其新增至機會記錄和管道。
+ 這對於 `MRR`或 等欄位特別重要`Stage`，特別是當它們表示產品已啟動時。
## 管理下游相依性
+ 如果您的系統中有依賴資料交換的下游相依性，請考慮下列事項：
+ 在 CRM 中建立新欄位以容納 AWS 資料。
+ 視需要重新調整您的業務流程，以確保無縫整合和資料流程。
# 建立同步排程
**注意**
本節中的主題假設您已完成 AWS Partner Central 整合、 AWS Marketplace 整合或兩者的先決條件。如需詳細資訊，請參閱本指南[開始使用](crm-integration-getting-started.md)前面的 [整合的先決條件](crm-integration-setting-up.md)和 。
您可以在 Salesforce 和 AWS Partner Central 之間建立傳入和傳出同步排程。以下各節中的步驟說明如何進行。
**Topics**
+ [先決條件](#scheduling-prerequisites)
+ [建立排程](#creating-a-schedule)
+ [停用排程任務](#deactivating-a-scheduled-job)
+ [檢視所有排程](#viewing-all-schedules)
## 先決條件
在建立同步排程之前，請確定您已完成下列動作：
+ 在至少一個物件、機會或潛在客戶上[映射](crm-connector-mapping.md)所有必要欄位。
+ 在 Salesforce 中建立[系統整合使用者](#system-integration-user)。
### 建立系統整合使用者
您必須先使用 Salesforce 建立具有 APN 整合許可的系統整合使用者，才能建立同步排程。若要建立同步排程，您必須以系統整合使用者身分登入 Salesforce。建立沒有 APN 整合使用者許可的排程可能會中斷 APN 整合。
**建立系統整合使用者**
1. 以系統管理員身分登入 Salesforce 組織。
1. 在 Salesforce 組織中建立使用者。將設定檔指派給可存取 Salesforce 組織中必要物件的使用者。如需詳細資訊，請參閱[新增單一使用者](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm)。
1. 將 **APN 整合使用者**許可集指派給使用者。如需詳細資訊，請參閱[將許可集指派給使用者](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm)。
## 建立排程
完成[先決條件後](#scheduling-prerequisites)，您可以在 Salesforce 和 APN 之間建立同步排程。
**使用 APN 建立同步排程**
1. 以具有系統整合使用者許可的使用者身分登入 Salesforce。
1. 在**排程**索引標籤上，選擇**新增**。
1. 選擇要排程的物件。您可以為潛在客戶和機會或單一物件設定排程。
1. 選擇排程頻率，從最少每五分鐘到最多每天一次。
1. 選擇 **Schedule (排程)**。
**注意**
每個物件一次只能有一個排程處於作用中狀態。為相同物件建立新的排程會停用現有的排程。
若要在建立排程時停用傳入整合，請選擇**停用傳入整合、排程**。
建立沒有 APN 整合使用者許可的排程可能會中斷 APN 整合。
## 停用排程任務
1. 在**排程**頁面上，選擇**停用所有任務**以關閉任何作用中的排程。
1. 繼續進行確認畫面以停用同步排程。
## 檢視所有排程
從**排程**索引標籤中，使用清單檢視篩選條件在**作用中**、**非作用中**和**所有同步**排程之間切換。
# 最佳實務
使用這些最佳實務來最佳化您的自訂整合開發和維護。
## 一般最佳實務
1. 映射所有*必填欄位*，因為它們是 AWS Partner Network (APN) 客戶互動 (ACE) 提交表單中的必要欄位。
1. 與您目前的 ACE Pipeline Manager 使用者連線，以了解程序的外觀。擷取任何獨特的程序/欄位使用，以便您可以將其建置到您的體驗中。
1. 考慮為 Amazon Web Services (AWS) 報告的銷售階段建立單獨的銷售管道階段 （例如：階段、目標結束日期、預期每月 AWS 收入、後續步驟）。如果我們有不同的階段定義，我們可能會覆寫您的銷售階段。當您建立個別的銷售階段時，它可讓您適當地管理管道，但仍可查看正在 AWS 投影的內容。
1. 對於合作夥伴推薦的機會，ACE 團隊必須先核准/拒絕他們，我們才能接受任何更新。
1. 對於 AWS 參考的機會，合作夥伴必須接受或拒絕機會。
## 資料交換通訊協定
1. **輸入慣例**：使用分號分隔多選選項清單項目並省略空格。
1. **注意細節**：欄位名稱和值區分大小寫，因此請保持準確性。
1. **刪除程序**：透過傳輸`null`所選欄位的值來執行欄位移除。
1. **同步：**同步程序每小時運作一次，導致資料反射的潛在延遲。更新 最多 AWS 可能需要一小時才能反映在 AWS 客戶關係管理 (CRM) 中。避免每小時傳送多個文件。
## 欄位特定的最佳實務
1. **傳入修改**：為了保護資料的完整性，請停用對 `stage`、 `closedDate`和 等欄位的修改`closedLostReason`。若要在不影響本機 Salesforce 值的情況下追蹤 AWS 值，請使用這些唯讀欄位：`awsStage`、 `awsCloseDate`和 `awsClosedLostReason`。
1. **客戶映射和驗證**：確保客戶網站的準確性，因為它對於 AWS CRM 映射至關重要。將其與客戶名稱配對，以獲得卓越的 CRM 帳戶映射。
1. **專案描述清晰度**：提供詳細說明客戶挑戰和解決方案一致性的明確描述。 AWS 使用此描述來驗證機會。
1. **佈建**：（選用） 當您佈建終端客戶聯絡詳細資訊時，它 AWS 可讓 恢復潛在客戶和行銷活動。這會導致強化的資金決策。
## 其他最佳實務
1. 遵循最新的承載欄位定義準則。
1. 維持沙盒儲存貯體命名與指定格式的一致性。
1. 使用建議的生產儲存貯體命名模式。
1. 在即時部署之前，優先進行沙盒環境測試。
1. 維護 AWS 和 合作夥伴 CRMs之間記錄的不同識別符。
1. 處理後，刪除傳出 Amazon Simple Storage Service (Amazon S3) 資料夾中的檔案。OEM 會保留在封存中。
1. 若要防止錯誤，請在來源設定欄位層級驗證。
# 配額
## 傳入檔案至 Amazon Web Services (AWS)
| 作業 | 限制 |
| --- | --- |
| 最大機會 | 每個檔案 500 個 |
| 檔案大小上限 | 1 MB |
| 同步的頻率 | 近乎即時 |
| 提交檔案的數量上限 | 每 24 小時期間 10，000 個 |
## 傳出檔案給合作夥伴
| 作業 | 限制 |
| --- | --- |
| 檔案大小上限 | 5 MB |
| 同步的頻率 | 每小時 |
# 版本歷史記錄
目前欄位版本：14 (2023 年 11 月 15 日）
下表說明 2020 年之後潛在客戶和機會的自訂整合欄位的重要變更。若要收到未來更新的通知，請訂閱 RSS 摘要。
| 變更 | 版本 | 日期 |
| --- | --- | --- |
| 更新 Amazon S3 配額 | 14 | 1/17/2024 |
| **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 14 | 11/15/2023 |
| **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 13 | 03/29/2023 |
| **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) **機會的標準值變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) **機會欄位的標準值變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 11 | 03/21/2022 |
| **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) **機會的標準值變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 10 | 01/26/2022 |
| **領導欄位的標準值變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) **整合潛在客戶欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) **整合機會欄位的變更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/version-history.html) | 9 | 9/16/2021 |
| 更新已關閉的遺失原因代碼 | 8 | 6/24/2021 |
# 常見問答集
使用這些常見問題和答案來協助自訂整合。
**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 版的承載。