對應集概述
對應集是一組對應，可將資料從一個結構描述轉換為另一個結構描述。 本檔案提供有關對應集如何構成的資訊，包括輸入結構描述、輸出結構描述和對應。
快速入門
此概覽需要深入瞭解下列Adobe Experience Platform元件：
- 資料準備：資料準備可讓資料工程師對應、轉換和驗證進出體驗資料模型(XDM)的資料。
- 資料流：資料流能呈現資料處理作業在Platform上行動資料的情形。 資料流可跨不同服務進行設定，有助於將資料從來源聯結器移至目標資料集，以及 Identity 和 Profile，並至 Destinations.
- Adobe Experience Platform Data Ingestion：資料可以傳送至的方法 Experience Platform.
- Experience Data Model (XDM) System：作為依據的標準化架構 Experience Platform 組織客戶體驗資料。
對應集語法
對應集由ID、名稱、輸入結構描述、輸出結構描述和相關聯的對應清單組成。
以下JSON為典型對應集的範例：
{
"id": "cbb0da769faa48fcb29e026a924ba29d",
"name": "Demo Mapping Set",
"inputSchema": {
"id": "a167ff2947ff447ebd8bcf7ef6756232",
"version": 0
},
"outputSchema": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/6dd1768be928c36d58ad4897219bb52d491671f966084bc0",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"mappings": [
{
"sourceType": "ATTRIBUTE",
"source": "Id",
"destination": "_id",
"name": "Id",
"description": "Identifier field"
},
{
"sourceType": "ATTRIBUTE",
"source": "FirstName",
"destination": "person.name.firstName"
},
{
"sourceType": "ATTRIBUTE",
"source": "LastName",
"destination": "person.name.lastName"
}
]
}
idnameinputSchemaoutputSchemamappingssourceType對於每個列出的對應，其 sourceType attribute表示要對應的來源型別。 可以是其中一項 ATTRIBUTE， STATIC，或 EXPRESSION：
ATTRIBUTE用於來源路徑中找到的任何值。STATIC用於插入目的地路徑中的值。 此值會保持不變，不受來源結構描述的影響。EXPRESSION用於運算式，其將在執行階段中解析。 可用的運算式清單可在以下連結中找到： 對應函式指南.
sourcesource attribute表示您要對應的欄位。 有關如何設定來源的詳細資訊，請參閱 來源概觀.destinationmappings.namemappings.description設定對應來源
在對映中， source 可以是欄位、運算式或靜態值。 根據給定的來源型別，可以透過多種方式擷取值。
欄位資料中的欄位
在欄位資料（例如CSV檔案）中對應欄位時，請使用 ATTRIBUTE 來源型別。 如果欄位包含 . 在其名稱內，使用 \ 以逸出值。 此對應的範例可在以下找到：
範例CSV檔案：
Full.Name, Email
John Smith, js@example.com
範例對應
{
"source": "Full.Name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": {
"name": "John Smith"
}
}
巢狀資料中的欄位
在巢狀資料（例如JSON檔案）中對應欄位時，請使用 ATTRIBUTE 來源型別。 如果欄位包含 . 在其名稱內，使用 \ 以逸出值。 此對應的範例可在以下找到：
範例JSON檔案
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
範例對應
{
"source": "customerInfo.name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": {
"name": "John Smith"
}
}
陣列中的欄位
對映陣列中的欄位時，您可以使用索引來擷取特定值。 若要這麼做，請使用 ATTRIBUTE 來源型別和您要對應的值的索引。 此對應的範例可在以下找到：
範例JSON檔案
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
範例對應
{
"source": "customerInfo.emails[0].email",
"destination": "pi.email",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": {
"email": "js@example.com"
}
}
陣列到陣列或物件到物件
使用 ATTRIBUTE 來源型別，您也可以直接將陣列對應至陣列，或將物件對應至物件。 此對應的範例可在以下找到：
範例JSON檔案
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
範例對應
{
"source": "customerInfo.emails",
"destination": "pi.emailList",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": {
"emailList": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
陣列上的反複運算
使用 ATTRIBUTE 來源型別，您可以使用萬用字元索引([*])。 此對應的範例可在以下找到：
範例JSON檔案
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
範例對應
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
常數值
如果要對應常數或靜態值，請使用 STATIC 來源型別。 使用時 STATIC 來源型別， source 代表您要指派給的硬式編碼值 destination. 此對應的範例可在以下找到：
範例JSON檔案
{
"name": "John Smith",
"email": "js@example.com"
}
範例對應
{
"source": "CUSTOMER",
"destination": "userType",
"sourceType": "STATIC"
}
轉換的資料
{
"userType:": "CUSTOMER"
}
運算式
如果您想要對應運算式，請使用 EXPRESSION 來源型別。 接受的函式清單可在以下網址找到： 對應函式指南. 使用時 EXPRESSION 來源型別， source 代表您要解析的功能。 此對應的範例可在以下找到：
範例JSON檔案
{
"firstName": "John",
"lastName": "Smith",
"email": "js@example.com"
}
範例對應
{
"source": "concat(upper(lastName), upper(firstName), now())",
"destination": "pi.created",
"sourceType": "EXPRESSION"
}
轉換的資料
{
"pi": {
"created": "SMITHJOHNFri Sep 25 15:17:31 PDT 2020"
}
}
設定對應目的地
在對映中， destination 是從中擷取值的位置 source 將會插入。
根層級的欄位
當您想要對應 source 值轉換為轉換後資料的根層級，請遵循以下範例：
範例JSON檔案
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
範例對應
{
"source": "customerInfo.name",
"destination": "name",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"name": "John Smith"
}
巢狀欄位
當您想要對應 source 值轉換為轉換資料中的巢狀欄位，請遵循以下範例：
範例JSON檔案
{
"name": "John Smith",
"email": "js@example.com"
}
範例對應
{
"source": "name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": {
"name": "John Smith"
}
}
位於特定陣列索引的欄位
當您想要對應 source 值至轉換後資料中陣列中的特定索引，請遵循以下範例：
範例JSON檔案
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
範例對應
{
"source": "customerInfo.name",
"destination": "piList[0]",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"piList": ["John Smith"]
}
反複陣列操作
當您想要反複循環陣列並將值對應到目標時，可以使用萬用字元索引([*])。 其範例如下：
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
範例對應
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
轉換的資料
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
後續步驟
閱讀本檔案後，您現在應該瞭解對應集的建構方式，包括如何在對應集中設定個別對應。 如需其他「資料準備」功能的詳細資訊，請參閱 資料準備總覽. 若要瞭解如何在資料準備API中使用對應集，請參閱 資料準備開發人員指南.