新增用於匯入的轉換對應
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
在匯入資料之前，使用轉換對應來修改資料。 例如，將來源檔案中包含的全名分割為名字和姓氏，以符合實體的目標屬性。
為了實作轉換對應，請使用轉換對應 (TransformationMapping) 實體與轉換參數對應 (TransformationParameterMapping) 實體。
已轉換的資料必須與 Microsoft Dynamics 365 實體屬性類型相容。
轉換類型是由 TransformationMapping.TransformationTypeName 屬性描述。 下表列出此屬性的有效值：
欄位 |
值 |
|---|---|
AddToCurrentDate |
"Microsoft.Crm.Transformations.AddToCurrentDate" |
AddToDate |
"Microsoft.Crm.Transformations.AddToDate" |
AdvancedAddToCurrentDate |
"Microsoft.Crm.Transformations.AdvancedAddToCurrentDate" |
AssignValue |
"Microsoft.Crm.Transformations.AssignValue" |
Concatenate |
"Microsoft.Crm.Transformations.Concatenate" |
Replace |
"Microsoft.Crm.Transformations.Replace" |
Split |
"Microsoft.Crm.Transformations.Split" |
Substring |
"Microsoft.Crm.Transformations.Substring" |
下節說明可用的轉換。
本主題內容
串連
分割
子字串
取代
指派值
新增至日期
調整目前日期與設定時間
進階新增至目前日期
串連
串連字串以及使用分隔符號分隔字串。
輸入參數 |
描述 |
|---|---|
首碼 |
串連字串中做為首碼的字串。 |
稱謂 |
串連字串中做為尾碼的字串。 |
分隔符號 |
一個字元或字元組合，分隔串連字串中的子字串。 在首碼及子字串之間或在尾碼及子字串之間，分隔符號未使用。 請勿使用退格鍵 (\b)、新行 (\n) 和歸位 (\r) 字元做為分隔符號。 |
<Variable> |
包含子字串的可變長度陣列。 |
輸出參數 |
描述 |
|---|---|
字串 |
串連的字串。 |
分割
將包括分隔符號的字串分隔成子字串。 最多可有十個子字串。
輸入參數 |
描述 |
|---|---|
輸入字串 |
字串，包含一個子字串或多個以分隔符號分隔的子字串。 |
分隔符號 |
一個字元或字元組合，分隔字串中的子字串。 請勿使用退格鍵 (\b)、新行 (\n) 和歸位 (\r) 字元或空字串做為分隔符號。 |
輸出參數 |
描述 |
|---|---|
變數 |
字串 1 到最大值 10。 |
例如，如果輸入字串包含 11 個子字串，輸出包含 10 個子字串，如下列範例所示：
輸入字串：a;b;c;d;e;f;g;h;i;j;k
輸出：
a
b
c
d
e
f
g
h
i
j;k
子字串
從字串中指定點開始，傳回指定長度的子字串。
輸入參數 |
描述 |
|---|---|
輸入字串 |
包含子字串的字串。 |
開始索引 |
子字串的開始位置。 |
長度 |
子字串的長度。 如果長度為 null，會從開始索引傳回完整字串。 |
輸出參數 |
描述 |
|---|---|
子字串 |
傳回的子字串。 |
取代
以另一個指定的字串取代出現的所有指定字串。
輸入參數 |
描述 |
|---|---|
輸入字串 |
包含搜尋字串的字串。 |
搜尋字串 |
搜尋字串。 請勿使用退格鍵 (\b)、新行 (\n) 和歸位 (\r) 字元做為搜尋字串。 |
取代字串 |
取代字串。 使用空字串移除搜尋字串。 請勿使用退格鍵 (\b)、新行 (\n) 和歸位 (\r) 字元做為取代字串。 |
輸出參數 |
描述 |
|---|---|
值 |
取代值 (和指派值相同)。 |
指派值
以指定的值取代所有值。
輸入參數 |
描述 |
|---|---|
值 |
要指派的值。 |
輸出參數 |
描述 |
|---|---|
值 |
取代值 (和指派值相同)。 |
注意
資料轉換只能用於格式正確的日期。 如需如何格式化日期的資訊，請參閱 Microsoft Dynamics 365 說明。
新增至日期
將指定的年、月、日的數字新增至日期。
輸入參數 |
描述 |
|---|---|
日期 |
要修改的日期字串。 |
年差距 |
加入至輸入日期的年元件的正或負值。 |
月差距 |
加入至輸入日期的月元件的正或負值。 |
日差距 |
加入至輸入日期的日元件的正或負值。 |
輸出參數 |
描述 |
|---|---|
新日期 |
包含日、月與年，以此順序新增的新資料字串。 |
調整目前日期與設定時間
將指定的日數、月數、年數新增至目前的日期並設定指定的時間。 差距只能是整數。
輸入參數 |
描述 |
|---|---|
年差距 |
加入至目前日期的年元件的正或負值。 |
月差距 |
加入至目前日期的月元件的正或負值。 |
日差距 |
加入至目前日期的日元件的正或負值。 |
小時 |
值，用來設定目前日期的小時元件。 |
分鐘 |
值，用來設定目前日期的分鐘元件。 |
秒 |
值，用來設定目前日期的秒元件。 |
一週的某天 |
一週的某天可以是星期一、星期二、星期三、星期四、星期五、星期六或星期日。 一週的某天以整數表示，從十進位數字 1 開始表示星期一。 一週的某天值包含在 DayOfWeek 列舉中。 如需此列舉的詳細資訊，請參閱 MSDN 主題 DayOfWeekEnumeration。 |
輸出參數 |
描述 |
|---|---|
新日期 |
包含日、月與年，以此順序新增的新資料字串。 |
進階新增至目前日期
將指定的年、月、日數字新增成目前的日期。 您可以指定差距是相對於目前的日期或是絕對值。 差距只能是整數。
例如，如果為月差距使用絕對值 3，新計算的月份是三月。 如果設定相對於目前日期月差距為 3，而且目前月份為四月，新計算的月份是七月。
輸入參數 |
描述 |
|---|---|
年差距 |
加入至目前日期的年元件或絕對年的正或負值。 |
年差距模式 |
使用 TransformationParameterMapping.Data 屬性，指定差距是相對於目前的日期或是絕對值。 如果您使用早期繫結類型，可使用 TransformationOffsetMode 列舉指定相對或是絕對差距。 對於 DataTypeCode 值的清單，請參閱此實體的挑選清單值。若要檢視組織的實體中繼資料，請安裝瀏覽組織的中繼資料中敘述的中繼資料瀏覽器解決方案。 您也可以下載 SDK 後開啟其頂層資料夾內所附名為 EntityMetadata.xlsx 的 Excel 檔案，從中檢視未經自訂組織的中繼資料。 |
月差距 |
加入至目前日期的月元件或絕對月的正或負值。 |
月差距模式 |
使用 TransformationParameterMapping.Data 屬性，指定差距是相對於目前的日期或是絕對值。 如果您使用早期繫結類型，可使用 TransformationOffsetMode 列舉指定相對或是絕對差距。 對於 DataTypeCode 值的清單，請參閱此實體的挑選清單值。 |
日差距 |
加入至目前日期的日元件或絕對日的正或負值。 |
日差距模式 |
使用 TransformationParameterMapping.Data 屬性，指定差距是相對於目前的日期或是絕對值。 如果您使用早期繫結類型，可使用 TransformationOffsetMode 列舉指定相對或是絕對差距。 對於 DataTypeCode 值的清單，請參閱此實體的挑選清單值。 |
小時 |
值，設定目前日期的小時元件。 |
分鐘 |
值，設定目前日期的分鐘元件。 |
秒 |
值，設定目前日期的秒元件。 |
輸出參數 |
描述 |
|---|---|
新日期 |
包含日、月與年，以此順序新增的新資料字串。 先加入相對元件，然後使用絕對值形成日期。 |
另請參閱
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權