添加要导入的转换映射
发布日期： 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) 字符作为分隔符。 |
<变量> |
包含子串的可变长度的数组。 |
输出参数 |
说明 |
|---|---|
字符串 |
串联字符串。 |
拆分
将包括分隔符的字符串分隔为子串。 最多可以有 10 个子串。
输入参数 |
说明 |
|---|---|
输入字符串 |
包含一个或多个子串（用分隔符分隔）的字符串。 |
分隔符 |
一个字符或字符组合，用于在字符串中分隔子串。 请勿使用退格 (\b)、换行 (\n) 和回车 (\r) 字符或空字符串作为分隔符。 |
输出参数 |
说明 |
|---|---|
变量 |
子串 1 到子串 n（最大为 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
子字符串
返回字符串中从指定位置开始的指定长度的子串。
输入参数 |
说明 |
|---|---|
输入字符串 |
包含子串的字符串。 |
起始索引 |
子串的起始位置。 |
长度 |
子串的长度。 如果长度为空，则从起始索引开始返回整个字符串。 |
输出参数 |
说明 |
|---|---|
子字符串 |
返回的子串。 |
替换
将出现的所有指定字符串替换为另一个指定的字符串。
输入参数 |
说明 |
|---|---|
输入字符串 |
包含搜索字符串的字符串。 |
搜索字符串 |
搜索字符串。 请勿使用退格 (\b)、换行 (\n) 和回车 (\r) 字符作为搜索字符串。 |
替换字符串 |
替换字符串。 使用空字符串可移除搜索字符串。 请勿使用退格 (\b)、换行 (\n) 和回车 (\r) 字符作为替换字符串。 |
输出参数 |
说明 |
|---|---|
值 |
替换值（与已分派的值相同）。 |
分派值
将所有值替换为指定值。
输入参数 |
说明 |
|---|---|
值 |
要分派的值。 |
输出参数 |
说明 |
|---|---|
值 |
替换值（与已分派的值相同）。 |
备注
日期转换只能用于格式正确的日期。 有关如何设置日期格式的信息，请参阅 Microsoft Dynamics 365 帮助。
添加到日期
向日期中添加指定的天数、月数和年数。
输入参数 |
说明 |
|---|---|
日期 |
需要修改的日期字符串。 |
年偏移量 |
添加到输入日期的年部分中的正值或负值。 |
月偏移量 |
添加到输入日期的月部分中的正值或负值。 |
日偏移量 |
添加到输入日期的日部分中的正值或负值。 |
输出参数 |
说明 |
|---|---|
新日期 |
包含日、月和年（按此顺序添加）的新日期字符串。 |
调整当前日期和设置时间
向当前日期中添加指定的天数、月数和年数，并设置指定时间。 偏移量只能为整数。
输入参数 |
说明 |
|---|---|
年偏移量 |
添加到当前日期的年部分中的正值或负值。 |
月偏移量 |
添加到当前日期的月部分中的正值或负值。 |
日偏移量 |
添加到当前日期的日部分中的正值或负值。 |
小时 |
用于设置当前日期的小时部分的值。 |
分钟 |
用于设置当前日期的分钟部分的值。 |
秒 |
用于设置当前日期的秒部分的值。 |
星期几 |
星期几，可为星期一、星期二、星期三、星期四、星期五、星期六或星期日。 “星期几”用整数表示，从表示星期一的十进制数 1 开始。 “星期几”的值包含在 DayOfWeek 枚举中。 有关此枚举的详细信息，请参阅 MSDN 主题，DayOfWeekEnumeration。 |
输出参数 |
说明 |
|---|---|
新日期 |
包含日、月和年（按此顺序添加）的新日期字符串。 |
高级 - 添加到当前日期
向当前日期中添加指定的天数、月数和年数。 您可以指定偏移量是相对于当前日期还是绝对值。 偏移量只能为整数。
例如，如果使用绝对值 3 作为月偏移量，则新计算的月份将为 3 月。 如果将相对于当前日期月份的偏移量设置为 3 并且当前月份为 4 月，则新计算的月份为 7 月。
输入参数 |
说明 |
|---|---|
年偏移量 |
添加到当前日期的年部分中的正值或负值，或绝对年份。 |
年偏移量模式 |
通过使用 TransformationParameterMapping.Data 属性来指定偏移量相对于当前日期还是绝对值。 如果您使用的是早期绑定类型，则可以使用 TransformationOffsetMode 枚举来指定相对或绝对偏移量。 有关 DataTypeCode 值的列表，请参阅该实体的选择列表值。若要查看您的组织的实体元数据，请安装浏览组织的元数据中描述的元数据浏览器解决方案。 您还可以在一个名为 EntityMetadata.xlsx 的 Excel 文件中查看非自定义组织的元数据，该文件包含在 SDK 下载的顶级文件夹中。 |
月偏移量 |
添加到当前日期的月部分中的正值或负值，或绝对月份。 |
月偏移量模式 |
通过使用 TransformationParameterMapping.Data 属性来指定偏移量相对于当前日期还是绝对值。 如果您使用的是早期绑定类型，则可以使用 TransformationOffsetMode 枚举来指定相对或绝对偏移量。 有关 DataTypeCode 值的列表，请参阅该实体的选择列表值。 |
日偏移量 |
添加到当前日期的日部分中的正值或负值，或绝对日期。 |
日偏移量模式 |
通过使用 TransformationParameterMapping.Data 属性来指定偏移量相对于当前日期还是绝对值。 如果您使用的是早期绑定类型，则可以使用 TransformationOffsetMode 枚举来指定相对或绝对偏移量。 有关 DataTypeCode 值的列表，请参阅该实体的选择列表值。 |
小时 |
设置当前日期的小时部分的值。 |
分钟 |
设置当前日期的分钟部分的值。 |
秒 |
设置当前日期的秒部分的值。 |
输出参数 |
说明 |
|---|---|
新日期 |
包含日、月和年（按此顺序添加）的新日期字符串。 先添加相对部分，然后使用绝对值形成日期。 |
另请参阅
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权