创建要导入的数据映射
发布日期： 2017年1月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
若要将数据导入到 Microsoft Dynamics 365 中，您必须提供适当的数据映射。
数据映射的示例包含在 SDK 中的以下位置：SDK\Resources\DataImportMaps\。下载 Microsoft Dynamics CRM SDK 包。
您可以使用数据映射将源文件中包含的数据映射到 Microsoft Dynamics 365 实体属性。 必须将源文件中的每一列都映射到适当的属性。 在数据导入操作期间不会导入未映射列中的数据。
数据映射由导入映射（数据映射）实体表示。 您可以使用 CreateRequest 消息创建新映射，或使用 IOrganizationService.Update 方法更新现有映射。 映射具有唯一的名称，该名称包含在 ImportMap.Name 属性中。 您可以指定使用 ImportMap.Source 属性创建此数据映射的导入源的名称。
本主题内容
列、列表值和查找映射
负责人映射
注释和附件
导入和导出数据映射
列、列表值和查找映射
若要将源文件中的列、列表值或查找值映射到 Microsoft Dynamics 365 属性，请使用以下映射：
列映射
将源文件中的列映射到 Microsoft Dynamics 365 实体属性。 对于列映射，请使用列映射 (ColumnMapping) 实体。 在源属性和目标属性之间可以使用 1:1（一对一）或 1:N（一对多）关系。 例如，可以将客户地址信息映射到订单中的帐单邮寄地址和送货地址。
列表值映射
将源文件中的列表值映射到 OptionSetValue 类型的 Microsoft Dynamics 365 属性。 对于列表值映射，请使用选择列表映射 (PicklistMapping) 实体。
如果源文件列中指定的某个值是列表值（如 OptionSetValue、Status、State 和 Boolean），则除了提供列映射外，还必须提供列表值映射。 例如，将源文件中的“帐单”和“送货”列表值映射到 OptionSetValue 类型的帐单和送货值。
查找映射
将源文件中的查找值映射到 EntityReference 类型的 Microsoft Dynamics 365 属性。 对于查找映射，请使用查找映射 (LookupMapping) 实体。
如果在源文件中指定的值引用某个实体，您必须为此值提供查找映射。 使用 LookupMapping.LookupSourceCode 属性可指定是要在源文件中还是在 Microsoft Dynamics 365 中搜索引用的实体。 如果您使用的是早期绑定类型，则可以使用 LookupSourceType 枚举来设置查找值。 若要在源文件中搜索，请使用 LookupSourceType.Source 值。 若要在 Microsoft Dynamics 365 中搜索，请使用 LookupSourceType.System 值。 有关 LookupSourceCode 值的列表，请参阅该实体的选择列表值。若要查看您的组织的实体元数据，请安装浏览组织的元数据中描述的元数据浏览器解决方案。 您还可以在一个名为 EntityMetadata.xlsx 的 Excel 文件中查看非自定义组织的元数据，该文件包含在 SDK 下载的顶级文件夹中。 您可以提供多个查找映射。 异步转换作业处理所有可用映射。 它会查找引用的记录并使用记录的唯一标识符更新解析表。 有关详细信息，请参阅运行数据导入。
负责人映射
使用负责人映射将源文件中指定的用户映射到 Microsoft Dynamics 365 中的用户。 有关日志记录的信息，请使用 Microsoft Dynamics 365 用户登录名。 对于负责人映射，请使用负责人映射 (OwnerMapping) 实体。
注释和附件
注释和附件的映射的处理方式与其他实体有所不同。 注释和附件用于将附加信息追加到 Microsoft Dynamics 365 中的记录。 在 Microsoft Dynamics 365 数据库中，注释存储为文本，而附件存储为文件。
若要在 Microsoft Dynamics 365 中创建注释，请将批注（注释）实体中的 Annotation.IsDocument 属性设置为 false。 若要创建附件，请将 IsDocument 设置为 true。
可将以下设置用于映射注释和附件：
将 ColumnMapping.SourceAttributeName 属性设置为“true”或“false”。 “true”值指示附件。 “false”值指示注释。
将 ColumnMapping.TargetAttributeName 属性设置为 IsDocument。
如果使用的是早期绑定的类型，请将 ColumnMapping.ProcessCode 属性设置为 ImportProcessCode.Internal 枚举的 ImportProcessCode 值。 有关 ProcessCode 值的列表，请参阅该实体的选择列表值。
如果源数据表示注释，请将注释的文本映射到 Annotation.NoteText 属性。 如果您使用的是 Salesforce 文件，这些文件通常存储在磁盘上的唯一标识号下。 若要导入附件，必须将源文件中包含的文件标识号映射到 Annotation.DocumentBody 属性。DocumentBody 属性存储附件的内容。
导入异步作业会检查将源属性名称设置为“true”和“false”的映射，以发现注释和附件。 如果找到附件映射，则会在磁盘中查找指定文件，并将文件内容作为附件上载到 Microsoft Dynamics 365 中。 如果找不到文件，则会返回错误。
如果未提供用于批注（注释）实体的映射，则导入作业会为注释生成默认映射。
备注
可以上载的最大文件大小由 Organization.MaxUploadFileSize 属性确定。 该属性在 Dynamics 365 应用程序的“系统设置”的“电子邮件”选项卡中设置。 此设置限制可以附加到电子邮件、注释和 Web 资源的文件大小。 默认设置为 5 MB。但是，附件大小不能超出最大的 HTTP 请求大小（默认为 16MB）。 若要使更改生效，请重置 Internet Information Services (IIS)。 为此，请单击“开始”，单击“运行”，键入 iisreset，然后单击“确定”。
导入和导出数据映射
您可以将现有的数据映射导出到 XML 文件中，并将 XML 数据映射导入到 Microsoft Dynamics 365 中。 若要从 Microsoft Dynamics 365 中导出数据映射，请使用 ExportMappingsImportMapRequest 消息。 若要导入 XML 数据映射并在 Microsoft Dynamics 365 中创建数据映射，请使用 ImportMappingsImportMapRequest 消息。
另请参阅
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权