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

# 映射 ACE 物件
<a name="crm-connector-mapping"></a>

CRM 連接器提供 **ACE 映射**頁面。此頁面可讓您在 Salesforce 組織與 AWS Partner Network (APN) 之間映射物件和欄位。

下列各節說明如何建立物件映射。

**Topics**
+ [使用 ACE 映射頁面](mapping-page.md)
+ [多物件映射](multi-object-mappings.md)
+ [挑選清單映射](picklist-mapping.md)
+ [映射 ACE 和 Salesforce 物件](#mapping-guidance)
+ [同步日誌和報告](crm-connector-sync-logs-and-reports.md)

# 使用 ACE 映射頁面
<a name="mapping-page"></a>

AWS Partner Central 提供下列方式來導覽至 **ACE 映射**頁面：
+ 從應用程式啟動器中，搜尋並選擇**AWS 合作夥伴 CRM 連接器**。
+ 選擇 **ACE 映射**索引標籤。

  -或是-

  選擇**引導式設定**索引標籤，然後在**映射潛在客戶和機會**區段中，選擇**開始**或**檢閱**。

在 **ACE 映射**頁面上，使用左側導覽窗格來切換機會映射和潛在客戶映射。使用**物件選取器**來選擇來源物件，以對應 APN 線索和機會。物件選取器支援映射標準機會、領導物件和自訂物件。使用**映射檢視**和**類型檢視**篩選條件，在映射欄位、未映射欄位、必要欄位和選用欄位之間切換。

在 **ACE 映射**頁面上，物件**AWS 的欄位**欄指出對應的目標 APN 欄位。**Salesforce 欄位**是合作夥伴組織中所選物件的來源欄位。**Salesforce 欄位**會經過篩選，僅顯示組織中可用的適用資料類型，以映射至對應的 APN 欄位。例如，APN 中的文字欄位只能映射到合作夥伴組織中的文字 （字串） 欄位。

如果合作夥伴不希望 APN 更新欄位，則可以控制映射欄位的傳入更新。若要這樣做，請將**啟用傳入更新**切換為 **False**。

針對one-to-one映射，選取相關的來源欄位，然後選擇**儲存**。

# 多物件映射
<a name="multi-object-mappings"></a>

多物件映射可讓合作夥伴將 AWS 欄位映射至主要來源物件，例如機會或潛在客戶，以及與主要來源相關的 Salesforce 物件。

**注意**  
使用多物件映射時，請記住下列事項：  
使用 Salesforce `Account` 物件搭配機會物件進行multi-object-mapping時，您必須在 [ACE 自訂設定](guided-setup-apis.md#api-sys-config-settings)`Default Account`中設定 以接收機會。
收到機會時，如果您映射到所選物件以外的`Opportunity`物件，您必須確保將相關物件連結至您的機會記錄。  
例如，首次收到 AWS 推薦時，插入的機會沒有映射物件的相關 IDs，*除非您*在 ACE 自訂設定`Default Account`中設定 。如果您設定預設帳戶，推薦會具有所選機會或帳戶物件IDs。否則，不會插入映射的欄位值。在這種情況下，您必須修改新增相關物件 ID 的機會，然後選擇**與 同步 AWS**。當 將機會 AWS 推回 Salesforce 時，映射物件的欄位會更新，因為它參考物件的相關 ID。
在自訂設定中選取**複製預設帳戶**選項。這允許 在必要時 AWS 複製預設帳戶，特別是當您將帳戶欄位映射到主要物件時。

**映射相關物件**

1. 在 Salesforce 中，導覽至 **ACE 映射**索引標籤，然後選擇機會或潛在客戶。

1. 從**物件**選取器中，選擇來源物件。

   **Salesforce 欄位**欄隨即出現，並在任何包含相關物件的欄位結尾顯示 **>** 符號。

1. 選取 **>** 符號以展開該欄位的相關物件清單。

1. 選擇您要映射到欄位 AWS 的欄位。

1. 選擇**儲存**。

# 挑選清單映射
<a name="picklist-mapping"></a>

挑選清單對話方塊允許合作夥伴挑選清單欄位與 APN 之間的有限和延伸映射。如果使用提供的**自訂 ****ACE 機會物件 ，則 ACE 映射**頁面也具有 Auto Map 函數。如需物件的詳細資訊，請參閱本指南[使用標準 Salesforce 物件或自訂物件](crm-connector-mapping.md#custom-ace-opportunity-object)稍後的 。

如果在合作夥伴的欄位值和 APN 之間找到完全相符，則會自動對應這些值。延伸映射的選項可讓合作夥伴將單一 APN 值映射至多個來源、設定其他目標映射，以及設定預設映射。

## 有限映射
<a name="limited-mapping"></a>

1. 在 **ACE 映射**頁面上，選取來源欄位，然後選擇**映射值**。

   映射對話方塊隨即出現。

1. 針對**步驟 1：主要 APN 值**，選擇 **Auto Map** 或對應 ACE 管道管理員的 Salesforce 值，然後選擇**儲存**。

1. 視需要重複步驟 1 和 2，以映射所有 ACE 管道管理員值。

1. 若要關閉映射對話方塊，請選擇**關閉**。

合作夥伴會收到確認訊息，指出已儲存值映射。

## 延伸映射
<a name="extended-mapping"></a>

1. 如果相同的來源值映射到多個 APN 值，請如先前所述繼續進行映射。

1. 在**主要 APN 值**索引標籤上，為多個 APN 值選擇相同的值映射。

1. 如果合作夥伴的組織中存在未映射的值，**則其他 APN 值**索引標籤可讓您將其他值映射到 APN。這有助於合作夥伴確保組織中所有適用的值都對應到適當的 APN 值。

1. 如果合作夥伴組織中的單一值對應到多個 APN 值，請使用**次要 APN 值**索引標籤來設定傳出整合的預設值。

## 映射 ACE 和 Salesforce 物件
<a name="mapping-guidance"></a>

下列各節說明如何在物件映射中映射 ACE 和 Salesforce 自訂物件。

### 使用 ACE AWS 機會自訂物件
<a name="ace-opportunity-custom-object"></a>

CRM 連接器的 2.0 版和更新版本包含 ACE 自訂機會物件。您可以使用 物件來管理 Salesforce 中 AWS 的機會。

在 **ACE 映射**頁面上使用自訂物件時，合作夥伴可以自動將 AWS 欄位映射至 Salesforce 欄位。此外，自訂機會物件會與新的 ACE 資料模型保持一致，並在使用者介面中內建驗證，以協助使用者提交新機會。

若要使用自訂 ACE 機會物件，請完成下列步驟：

1. 在 Salesforce 中，導覽至 **ACE 映射**頁面，然後從左側導覽窗格中選擇**機會**。

1. 在**物件選取器**下，選擇 **ACE 機會 **。

1. 若要將 Salesforce 欄位映射至 AWS 欄位，請選擇 **Auto Map ACE 物件**按鈕。

### 使用標準 Salesforce 物件或自訂物件
<a name="custom-ace-opportunity-object"></a>

合作夥伴可以使用 Salesforce 標準機會物件或其自訂機會物件。若要避免 ACE 同步失敗，請確定自訂機會物件包含所有相關 ACE 必要欄位或條件必要欄位。映射 AWS 欄位的資料類型必須與自訂物件中建立的 Salesforce 欄位的資料類型相同。如果資料類型不相符，則 欄位將不會出現在 ACE 映射畫面中。例如，文字欄位 **customerCompanyName** 只能映射至標準或自訂機會物件中的文字 （字串） 欄位。如需必要的資料類型，請參閱 ACE 機會欄位。

若要使用標準 Salesforce 物件或自訂物件，請完成下列步驟：

1. 導覽至 **ACE 映射**頁面，然後從左側導覽窗格中選擇**機會**。

1. 在**物件選取器**下，選擇您的物件。

1. 根據對應的欄位選取必要的 Salesforce AWS 欄位，然後選擇**儲存**，以完成映射。

**注意**  
Auto Map 功能僅適用於 ACE 機會自訂物件。

# 同步日誌和報告
<a name="crm-connector-sync-logs-and-reports"></a>

下列主題說明如何在 AWS Partner CRM 連接器應用程式中使用同步日誌和報告。這些主題也會列出日誌和報告類型，以及其中包含的資料。

**Topics**
+ [同步日誌](#sync-logs)
+ [報告](#reports)

## 同步日誌
<a name="sync-logs"></a>

在連接器應用程式中，**同步日誌**索引標籤會顯示傳入和傳出 APN 同步的同步記錄狀態。您可以使用 索引標籤來驗證成功的同步和疑難排解同步錯誤。

使用包含的清單檢視，在**傳入**和**傳出**同步日誌之間切換。
+ **傳入協調** – 指出檢查來自 APN 之可用傳入記錄的任務。
+ **傳入協調記錄擷取** – 指出從 APN 挑選和處理待處理傳入記錄的任務。
+ **傳出協同運作** – 指出將待定傳出交易從組織傳送至 APN 的任務。

**同步日誌**記錄頁面會顯示同步任務的狀態、承載中的記錄數目、成功處理的記錄數目，以及錯誤的記錄數目。

相關的**同步日誌**詳細資訊會顯示作為同步任務一部分處理的個別記錄詳細資訊，以及其個別狀態。下表說明每種類型的日誌檔案及其相關內容。

### 日誌類型
<a name="log-types"></a>


| **用途** | **定義** | 
| --- | --- | 
| 傳出檔案擷取  | 當傳出任務根據頻率執行，以及是否必須與一組新的待定記錄同步時建立 AWS。只有在記錄必須符合下列傳出同步篩選條件規格時，才會建立日誌： `Updates for AWS` 為 `true`且 `Last Sync Date` 為 null，或在 之前`Last Modified Date`，且 `Last Sync Date` `Last Modified By`是排程同步任務的使用者。 | 
| 傳入檔案擷取  | 根據您的傳入同步排程建立。日誌會列出檢查來自 的待定傳入交易的標註 AWS。 | 
| 傳入記錄擷取  | 僅在父系傳入檔案擷取任務識別來自 的待定傳入交易時建立 AWS。日誌包含 檔案的詳細資訊 AWS ，其中包含機會或潛在客戶記錄。 | 

### 傳出檔案擷取結果
<a name="outbound-file-retrieval-results"></a>


| **Direction (方向)**  | **用途**  | **狀態**  | **定義**  | 
| --- | --- | --- | --- | 
| 從 AWS  | 傳入檔案擷取 | API Success  | 對儲存貯體的清單呼叫成功。 呼叫會檢查必須處理的待處理傳入記錄。 | 
| 從 AWS  | 傳入檔案擷取 | Error  | 清單呼叫失敗，通常是因為登入資料無效或許可問題。 | 

### 傳入檔案擷取結果
<a name="inbound-file-retrieval-results"></a>


| **Direction (方向)**  | **用途**  | **狀態**  | **定義**  | 
| --- | --- | --- | --- | 
| 從 AWS  | 傳入記錄擷取  | API success  | 如果一或多個檔案存在並等待處理，則會get呼叫 從 Inbound File Retrieval操作中擷取列出的檔案。 | 
| 從 AWS  | 傳入記錄擷取 | Partial  | 已擷取檔案，但部分記錄的處理失敗。檢閱同步日誌以疑難排解失敗。 | 
| 從 AWS  | 傳入記錄擷取 | Error  |  由於下列其中一個原因，所有記錄的處理失敗： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html)  | 
| 從 AWS  | 傳入記錄擷取 | API success  | 如果一或多個檔案存在並正在等待處理，則會get呼叫 從 Inbound File Retrieval操作中擷取列出的檔案。 | 
| 從 AWS  | 傳入記錄擷取 | Partial  | 已擷取檔案，但部分記錄的處理失敗。檢閱同步日誌以疑難排解失敗。 | 
| 從 AWS  | 傳入記錄擷取  | Error  | 由於下列其中一個原因，所有記錄的處理失敗： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html)  | 
| 從 AWS  | 傳入記錄擷取  | Processed  | 處理成功，並將記錄插入映射的物件。 | 

## 報告
<a name="reports"></a>

 AWS Partner CRM 連接器套件包含的報告可讓您追蹤組織與 APN 之間的同步狀態。<a name="view-reports-synchronization"></a>

**檢視同步的報告**

1. 在 AWS Partner CRM 連接器應用程式中，選擇**報告**索引標籤。

1. 選擇**所有資料夾**，然後選擇 **AWS Partner CRM 連接器**。

可用的報告包括下列項目：
+ **傳入同步日誌 – **每天`Error: Inbound`同步記錄失敗。
+ **傳入同步日誌 – **每天`Success: Inbound`同步記錄成功。
+ **傳出同步日誌 – **每天`Error: Outbound`同步記錄失敗。
+ **傳出同步日誌 – **每天`Success: Outbound`同步記錄成功。
+ **同步摘要** – 每天傳入和傳出同步任務的摘要。