

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

# AWS Partner CRM 連接器常見問答集
<a name="crm-connector-faq"></a>

本節中的主題可協助回答有關 AWS Partner CRM 整合和使用 CRM 連接器的常見問題。

**注意**  
此常見問答集中的問題和答案假設您使用 Salesforce。如需使用 Salesforce 的詳細資訊，請參閱 [Salesforce 說明](https://help.salesforce.com/s/)。

**Topics**
+ [一般問題](#general-questions)
+ [設定問題](#setup-issues)
+ [映射問題](#mapping-issues)
+ [同步和驗證問題](#synchronization-validation)

## 一般問題
<a name="general-questions"></a>

如需使用 AWS 合作夥伴 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 免費取得。它提供下列整合選項：
+ 以 Partner Central API 為基礎的整合，服務 AWS 呼叫是免費的。
+ 以 Amazon S3 為基礎的整合，其中 AWS 託管和承擔 Amazon S3 儲存貯體的成本。
**注意**  
只有在 2024 年之前建立與 Amazon S3 整合的 CRM 時，才能使用此選項。

Amazon EventBridge 也是免費的，因為事件來自 AWS 服務。不過， AWS 如果您從主要事件接聽程式轉送事件至其他事件匯流排以進行額外處理，則您的帳戶可能會產生額外費用。

如需 AWS Partner CRM 連接器的詳細資訊，請參閱 [CRM 連接器概觀](connector-overview.md)。如需 EventBridge 的詳細資訊，請參閱*《Amazon EventBridge 使用者指南》*中的[什麼是 Amazon EventBridge？](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)。

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

如需 AWS Partner CRM 連接器提供的功能清單，請參閱本指南[Partner Central API 功能](crm-connector-feature-list.md#partner-central-api-features)稍早的 。

### 我可以以程式設計方式存取用於傳送和接收檔案的 Amazon S3 儲存貯體嗎？
<a name="s3-programmatic-access"></a>

是。使用 [CRM Integration 加入](https://partnercentral.awspartner.com/partnercentral2/s/acecrmintegration)請求中 IAM 使用者的 `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>

建議您只有在沙盒環境中徹底測試之後，才能在生產系統上安裝套件。

### AWS Partner CRM 連接器的預期使用者是誰？
<a name="intended-users"></a>

AWS Partner CRM 連接器專為下列使用者角色而設計：
+ 設定連接器的 Salesforce 管理員或推薦管理員。
+ 選取、接受和更新機會和潛在客戶的銷售營運使用者。

### 我有 ACE 整合。我可以移至連接器嗎？
<a name="move-connector"></a>

是。與 ACE 有現有整合 AWS Partner的 可以移至連接器。由於連接器在後端使用相同的 Amazon S3 儲存貯體，請完成下列步驟：

1. 從 Amazon S3 儲存貯體中斷連接您的自訂應用程式或解決方案。

1. 登入 AWS 帳戶以設定整合。為有權存取 Amazon S3 儲存貯體的 IAM 使用者取得或建立私密金鑰和存取金鑰。使用者名稱必須遵循此格式：`apn-ace-{partnerName}-AccessUser-prod`。如需詳細資訊，請參閱*AWS Identity and Access Management 《 使用者指南*》中的[管理 IAM 使用者的存取金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)。
**注意**  
如果您找不到 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`資料夾中的佇列。整合上線後，使用者更新記錄會同步。

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

Salesforce 應用程式已通過 Salesforce 和內部 AWS 安全性審查。Salesforce 安全性審查掃描包括下列威脅：
+ Salesforce 物件查詢語言 (SOQL) 和 SQL Injection
+ 跨網站指令碼
+ 不安全的身分驗證和存取控制通訊協定
+ Salesforce 平台特有的記錄共用違規和其他漏洞

程式碼檢閱使用 [Salesforce Code Analyzer](https://forcedotcom.github.io/sfdx-scanner/) 來檢查 Salesforce 程式碼。Salesforce Code Analyzer 使用多個程式碼分析引擎，包括 PMD、ESLint 和 RetireJS。它識別了許多潛在問題，從不一致的命名到安全漏洞。

如需檢閱程序的詳細資訊，請參閱 Salesforce 文件中的 [AppExchange Security Review](https://developer.salesforce.com/docs/atlas.en-us.packagingGuide.meta/packagingGuide/security_review_overview.htm)。

**注意**  
合作夥伴應用程式是 Salesforce 主要服務協議中定義的 non-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>

從第 2 版遷移到第 3 版的 AWS Partner CRM 連接器沒有立即影響。所有功能皆可回溯相容，運作時不會中斷。

對於機會管理，如果您計劃使用新功能，您可能需要變更一些銷售程序。您應該評估下列變更並建立轉換計畫。
+ 第 3 版與 AWS 即時共用機會。您不再需要建立傳送機會到 的排程 AWS。合作夥伴 Salesforce 執行個體上的機會擁有者必須手動傳送資料至 AWS。Salesforce 使用者需要許可才能將機會推送至 AWS。
+ 如果您打算使用多物件映射，則需要轉換計劃，才能從 Salesforce 執行個體中的新物件取得和張貼資料。身為 Salesforce 管理員，您應該知道從物件映射移動到在單一物件中映射的所有欄位與從映射到單一物件的不同物件的欄位的後果。

### 從 Amazon S3 連線 （非同步） 移至 API 型連線 （同步），是否有額外的設定步驟？
<a name="moving-from-s3"></a>

是。*您必須*完成下列項目：
+ 在一般先決條件中，[連結您的 AWS Partner Central 和 AWS Marketplace 帳戶](link-pc-mkt-accounts.md)。
+  為新的 Partner Central APIs建立具名憑證。如需詳細資訊，請參閱本指南[設定具名登入資料](guided-setup-apis.md#api-named-credentials)前面的 。

### 我們尚未移至 Salesforce Lightning 版本。我們仍然可以使用 AWS Partner CRM Connector 嗎？
<a name="no-lightning"></a>

否。連接器旨在與 Salesforce Lightning 版本搭配使用，如果沒有連接器，應用程式可能無法如預期般運作。

### 我們正在 Salesforce 環境中達到排程任務的限制。我們是否可以使用外部排程器來觸發與 的同步 AWS？
<a name="sf-job-limit"></a>

需要驗證 - AWS Partner CRM Connector 是受管套件。您可以針對 `InboundSyncScheduler`和 apex `OutboundSyncScheduler` 類別，使用第三方應用程式建立自訂排程調用。注意 - 使用新的 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 版資料模型。如需完整的承載資訊，請參閱 GitHub 上的[AWS 合作夥伴 CRM 整合範例](https://github.com/aws-samples/partner-crm-integration-samples)。

### 受管套件是否有助於在標準 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 自訂機會物件複製驗證規則和欄位。*需要驗證 *- 透過多物件映射，您可以嘗試將參考新增至標準機會物件內的 ACE 機會物件，然後使用觸發條件來啟動驗證，將資料複製到這些欄位中。

### 為什麼我無法編輯與 AWS 欄位同步的映射？
<a name="cant-edit-mapping"></a>

**使用 Sync AWS** 核取方塊會決定潛在客戶或機會在下一個排程任務執行 AWS 時是否與 同步。**Sync with Partner Central** 欄位包含在應用程式中，以取得標準機會和潛在客戶。如果您的目標物件是自訂物件，您必須將 **Sync with AWS** 欄位對應至每個物件中的自訂非公式布林值欄位。

### 具有 AWS 欄位更新的 如何運作？
<a name="has-updates"></a>

**Has Update for AWS** formula 欄位會判斷記錄是否傳送至下一個排程任務 AWS Partner 中的 。**當下列情況為 true 時， 的更新 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。
+ 建立排程任務的使用者角色必須與用於建立和更新潛在客戶或機會的使用者角色不同。
+ 如果先前的檢查為 true，但傳出批次仍無法執行，請檢查 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\$1EXCEEDEDED 錯誤？
<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. 選擇**儲存承載**，為下一個任務設定要同步的記錄。

如果記錄被接受，您必須在收到剩餘的欄位之後，再次重複步驟 1–4 AWS。對於後續同步，會使用更正的值。或者，您可以更正 Partner Central 的 ACE 管道管理器中的值。

### AWS 上傳潛在客戶和機會的頻率為何？
<a name="upload-frequency"></a>

AWS 每小時將潛在客戶和機會上傳至 Amazon S3 儲存貯體。因此，需要透過整合更新資料的動作最多可能需要一小時才能同步。

### 為什麼我在使用映射畫面時收到 setFieldLengthWarning 訊息？
<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 小時週期內重設。如果預設配額不符合您的需求，您可以使用 [Service Quotas 頁面](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/dashboard)來請求增加配額。

### 標準機會上沒有看到傳送至 AWS 按鈕
<a name="no-button"></a>

**傳送至 AWS**按鈕只會針對**合作夥伴推薦**機會類型顯示。