本主题中的 XML 元素按类别分组:
本节显示了一个有助于您了解基础结构的示例数据映射。有关转换映射的示例,请参阅转换引用。有关其他示例,请参阅如何导入列表值和如何导入状态和状态描述数据。
<?xml version="1.0" encoding="utf-8"?>
<Map Name="Simple sample data map" Source="Sample">
<Description>Current Description: Sample data map with no lookups or transformations.</Description>
<UserIdentifier>
<SourceUserIdentifierForSourceDataSourceUserLink>Id</SourceUserIdentifierForSourceDataSourceUserLink>
<SourceUserIdentifierForSourceCRMUserLink>username</SourceUserIdentifierForSourceCRMUserLink>
<TargetUserIdentifierForSourceCRMUserLink>Primary Id</TargetUserIdentifierForSourceCRMUserLink>
</UserIdentifier>
<EntityMaps>
<EntityMap TargetEntityName="contact" SourceEntityName="contacts">
<AttributeMaps>
<AttributeMap>
<SourceAttributeName>Company Main Phone</SourceAttributeName>
<TargetAttributeName>NONE</TargetAttributeName>
<ProcessCode>Ignore</ProcessCode>
</AttributeMap>
<AttributeMap>
<SourceAttributeName>Preferred Method of Contact</SourceAttributeName>
<TargetAttributeName>preferredcontactmethodcode</TargetAttributeName>
<ProcessCode>Process</ProcessCode>
<PicklistMaps>
<PicklistMap>
<SourceValue>Email</SourceValue>
<TargetValue>6</TargetValue>
<ProcessCode>Process</ProcessCode>
</PicklistMap>
</PicklistMaps>
</AttributeMap>
</AttributeMaps>
</EntityMap>
<EntityMaps>
</Map>
|
对于当前 EntityMap 中映射的源文件,包含源数据中的列到 Microsoft Dynamics CRM 中的属性的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
EntityMap |
AttributeMap |
将源数据中的一列映射到 Microsoft Dynamics CRM 中的一个属性。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每列出现一次 |
AttributeMaps |
SourceAttributeName TargetAttributeName ProcessCode PicklistMaps LookupMaps |
源文件中使用的列标题。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
AttributeMap |
无 |
指定 Microsoft Dynamics CRM 中属性的名称 在 Microsoft Dynamics CRM 数据库架构中使用的名称。若要确定记录类型和属性的架构名称,请使用 Microsoft Dynamics CRM 中的“自定义”区域。。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
AttributeMap |
无 |
|
指定是忽略还是迁移此元素中的数据。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
EntityMap AttributeMap LookupMap PicklistMap TransformationMap |
无 |
|
数据映射文件的根节点。下表显示 映射 元素的参数。必需的参数以星号 (*) 标记。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
无 |
说明 UserIdentifier EntityMaps |
参数名称 |
说明 |
类型 |
---|---|---|
名称* |
此数据映射的名称,用于标识导入数据向导用户界面中的数据映射。 |
字符串 |
来源 |
从中导入数据的客户关系管理系统。该值用于标识导入数据向导用户界面中的数据源。 如果为空,您将无法在选择数据映射页上选择此数据映射。 |
字符串 |
数据映射的说明。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
映射 |
无 |
|
包含源数据中下拉列表值对当前 AttributeMap 中指定的 Microsoft Dynamics CRM 列表中的值的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个下拉列表(选择列表)出现一次 |
AttributeMap |
PicklistMap |
将源数据中的一个下拉列表值映射为相应的 Microsoft Dynamics CRM 列表中的一个值。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个列表值出现一次 |
PicklistMaps |
SourceValue TargetValue ProcessCode |
源文件中的一个列表值。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
PicklistMap |
无 |
Microsoft Dynamics CRM 中的一个列表值。
对于 <AttributeMap> 中指定的 Microsoft Dynamics CRM 下拉列表属性,该值必须是有效的选择列表整数。若要确定该整数,请执行以下操作之一:
如果此 <PicklistMap> 的 <ProcessCode> 元素的值是 流程,则此元素是必需的。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
PicklistMap |
无 |
|
包含 Microsoft Dynamics CRM 实体映射的源文件。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
映射 |
EntityMap |
包含单个源文件的所有属性和转换映射。下表显示 EntityMap 元素的参数。必需的参数以星号 (*) 标记。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个源文件出现一次 |
EntityMap |
AttributeMaps TransformationMaps |
参数名称 |
说明 |
类型 |
---|---|---|
TargetEntityName* |
Microsoft Dynamics CRM 实体名称。它必须是实体的名称,而不是显示名称。例如,如果要迁移案例记录,您必须使用事件而非案例。 |
字符串 |
源实体名称* |
一个源文件的实体名称。它通常是该源文件的文件名。 |
字符串 |
|
在某条源记录与另一个源文件或 Microsoft Dynamics CRM 中的另一条记录相关时,包含对解析引用的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个引用属性出现一次 |
AttributeMap OutputParameterMap |
LookupMap |
将源数据中的一列映射到其他源文件中的另一列或者映射到某个 Microsoft Dynamics CRM 属性以便解析对相关记录的引用。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对查找可以引用的每个实体类型出现一次 |
LookupMaps |
LookupType LookupEntityName LookupAttributeName ProcessCode |
指定是否在另一个源文件或 Microsoft Dynamics CRM 中查找引用。
有效值包括:
如果在源文件或 Microsoft Dynamics CRM 中可以找到引用的数据,则使用两个 LookupMap 元素。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次或两次。如果出现两次,则必须将其中一个设置为“来源”,将另一个设置为“系统”。 |
LookupMap |
无 |
应在其中解析此查找的源数据或 Microsoft Dynamics CRM 数据中的实体名称。在源数据中,它必须是文件名。在 Microsoft Dynamics CRM 数据中,它必须是实体名称而非显示名称。
如果 <ProcessCode> 设置为 流程,则此元素是必需的。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
LookupMap |
无 |
应在其中解析此查找的源数据或 Microsoft Dynamics CRM 数据中的属性名称。
该属性应提供唯一的值,因为如果无法将查找解析为单个记录,迁移记录将失败。
如果 ProcessCode 是 流程,则此元素是必需的。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
LookupMap |
无 |
|
用于标识源用户文件中的用户的列。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
映射 |
SourceUserIdentifierForSourceDataSourceUserLink SourceUserIdentifierForSourceCRMUserLink TargetUserIdentifierForSourceCRMUserLink |
SourceUserIdentifierForSourceDataSourceUserLink
源文件中引用用户的其他记录类型的列。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
UserIdentifier |
无 |
SourceUserIdentifierForSourceCRMUserLink
用户源文件中作为用户的唯一标识符的列。此列将映射到 Microsoft Dynamics CRM 用户实体中的值。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
UserIdentifier |
无 |
TargetUserIdentifierForSourceCRMUserLink
<SourceUserIdentifierForSourceDataSourceUserLink> 映射到的 Microsoft Dynamics CRM 属性。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
UserIdentifier |
无 |
|
有关必需的参数顺序和示例,请参阅转换引用。
包含源文件所需的任何转换的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
映射 |
TransformationMap |
包含有关某个转换的转换类型以及输入和输出参数的信息。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个转换出现一次 |
TransformationMaps |
TransformationTypeName ProcessCode InputParameterMaps OutputParameterMaps |
转换的类型。必须是以下某种类型:
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
TransformationMap |
无 |
包含转换的输入参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
TransformationMap |
InputParameterMap |
包含转换的一个输入参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
InputParameterMaps |
SingletonInputParameterMaps ArrayInputParameterMaps |
包含属于单个值参数的任何输入参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
InputParameterMap |
SingletonInputParameterMap |
包含转换的一个输入参数(作为单个值的参数)的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个单值输入参数出现一次 |
SingletonInputParameterMaps |
ParameterSequence DataTypeCode 数据 |
包含要求多个值的任何输入参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
InputParameterMap |
SingletonInputParameterMap |
包含转换的一个输入参数(要求多个值的参数)的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个多值输入参数出现一次 |
ArrayInputParameterMaps |
ParameterSequence 项 |
包含某个数组输入参数中的所有项的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个数组输入参数出现一次 |
ArrayInputParameterMap |
项 |
包含某个数组输入参数中的所有项的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个数组输入参数出现一次 |
项 |
ParameterArrayIndex DataTypeCode 数据 |
数组中的序列。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个数组项出现一次 |
项 |
DataTypeCode 数据 |
包含转换的输出参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
TransformationMap |
OutputParameterMap |
包含转换的一个输出参数的映射。
出现的次数 |
父元素 |
子元素 |
---|---|---|
对每个输出参数出现一次 |
OutputParameterMaps |
ParameterSequence 数据 LookupMaps |
指定输入参数或输出参数的顺序。必须是整数。若要查看每个转换类型所需的参数顺序,请参阅转换引用。
数据映射中的参数并非通过名称进行引用,而是通过 ParameterSequence 的值确定使用哪个参数。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
OutputParameterMap |
无 |
指定用作转换的输入参数的数据是固定字符串还是对同一源文件中另一列的引用。
有效值包括:
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
SingletonInputParameterMap ParameterArrayIndex |
无 |
在其中放置输出数据的 Microsoft Dynamics CRM 属性。
出现的次数 |
父元素 |
子元素 |
---|---|---|
一次 |
OutputParameterMap SingletonInputParameterMap ParameterArrayIndex |
无 |
|
相关主题 |