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

# Amazon Connect Customer Profiles 中的物件類型映射定義詳細資訊
<a name="object-type-mapping-definition-details"></a>

物件類型對應定義有兩個部分：欄位定義和索引鍵定義。

**提示**  
若要了解如何建立物件類型對應器，請參閱此部落格文章：[Unify and organize customer information with Amazon Connect Customer Profiles with the pre-built Amazon S3 connector](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/)。或者，您也可以在 YouTube 上觀看這部影片：[How to Integrate Customer Profile Data into your Contact Center Experiences](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s)。

## 欄位定義詳細資訊
<a name="field-definition-details"></a>

欄位定義會定義欄位的來源、目的地 (目標) 和類型。例如：

```
"Fields": {
        "{fieldName}": {
            "Source": "{source}",
            "Target": "{target}",
            "ContentType": "{contentType}"
        }, ...
    }, ...
```
+ `Source`：這可以是欄位的 JSON 存取子，也可以是用於產生欄位值的 Handlebar 巨集。

  被解析的來源物件被命名為 ` _source`，因此來源欄位中的所有欄位都需要以此字串開頭。僅支援 `_source` 物件。

  使用 Handlebar 巨集解決方案來產生常數，並將多個來源物件欄位合併為單一欄位。這對於索引非常有用。
+ `Target`：指定標準物件類型中此欄位資料的對應位置。

  填入標準設定檔可讓您將從任何資料來源擷取的資料與以客戶設定檔為基礎建置的應用程式一起使用，而無需對所擷取資料的格式有任何特定知識。

  此欄位為選用欄位。您可能只想要定義欄位，以便將它們包含在索引鍵中。

  此欄位的格式永遠是 JSON 存取子。唯一支援的目標物件是 `_profile`。
+ `ContentType`：支援以下各值：STRING、NUMBER、PHONE\_NUMBER、EMAIL\_ADDRESS、NAME。如果沒有指定 `ContentType`，則假設為 STRING。

  `ContentType` 用於決定如何為值建立索引，以便客服人員可以搜尋該值。例如，如果設定 `ContentType` 為 PHONE\_NUMBER，則會處理電話號碼，以便客服人員可以使用任何格式進行搜尋：字串「\+15551234567」與「(555) -123-4567」相符。

## 索引鍵定義詳細資訊
<a name="key-definition-details"></a>

索引鍵包含一個或多個欄位，這些欄位共同定義一個索引鍵，該索引鍵可用於使用 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 搜尋物件 (或它們所屬的設定檔)。也可以定義索引鍵，以唯一識別設定檔或唯一識別物件本身。

```
"Keys": {
        "{keyName}": [{
            "StandardIdentifiers": [...],
            "FieldNames": [ "{fieldname}", ...]
        }], ...
    }, ...
```

索引鍵名稱是網域的全域名稱。如果您有兩個索引鍵，在兩個不同的物件類型對應中具有相同名稱：
+ 這些索引鍵應該佔用相同的命名空間
+ 它們可用於將不同物件之間的設定檔連結在一起。如果它們在物件之間相符，則客戶設定檔會將這兩個物件放在同一個設定檔中。

以另一種方式來表達：索引鍵在網域中應具有相同的索引鍵名稱，若且唯若相同的值意味著它們是相關的。例如，某種物件類型中指定的電話號碼會與另一種物件類型中指定的相同電話號碼相關。針對從 Salesforce 匯入的物件指定的內部識別符可能與從 Marketo 匯入的另一個物件無關，即使它們具有完全相同的值也一樣。

索引鍵定義的使用方式有兩種：
+ 在擷取期間，Customer Profiles 內部會使用這些索引鍵找出物件應指派給哪些設定檔。
+ 它們允許您使用 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來搜索鍵值並尋找設定檔。

## 預設搜尋索引鍵
<a name="object-type-mapping-default-search-keys"></a>

預設搜尋索引鍵 (例如 `_phone` 和 `_email`) 是由[標準設定檔](standard-profile-definition.md)、[標準資產](standard-asset-definition.md)、[標準訂單](standard-order-definition.md)和[標準案例](standard-case-definition.md)物件範本預先定義。您可以使用預設搜尋索引鍵作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找設定檔。