Microsoft Dynamics CRM:如何以编程的方式导入附件

CRM import SDK APIs提供以编程的方式导入附件的功能,在这片博客中将会解释如何使用CRM import SDK的自动匹配特性来导入附件,并且提供一些APIs相关的样例代码。

样例代码详解

总体上所需步骤如下:

  1. 新建一个包含所需导入附件详情的CSV文件。
  2. 新建根导入记录。
  3. 为包含真正内容的附件新建导入文件记录。
  4. 新建包含附件记录映射的导入文件记录。
  1. 调用import SDK APIs

让我们开始通过样例代码来解释如上每个步骤。

  1. 新建一个包含所需导入附件详情的CSV文件

首先在内存中新建一个包含所需导入附件详情的CSV文件。你还可以使用已创建的CSV文件并且把它从磁盘中读取出来,出于简单明了起见我们将会在内存中新建。为使用导入的自动匹配特性,CSV文件第一行需包含目标导入实体的属性的显示名称。第一行以后的行需包含这些属性的真正值。

如下样例代码第一行包含用逗号隔开的Annotation实体的属性显示名称,随后行的每列包含真正属性值。Annotation实体是一个特殊实体,因此“Document”列包含文件名而不是文件内容,接下来将会讲述在哪里指定真正文件内容。

  1. 新建根导入记录

根导入记录用于绑定需要一起导入的不同文件。

  1. 为包含真正内容的附件新建导入文件记录。

现在你需要新建一个包含真正包含附件内容的导入文件记录。如下代码展示如何做到这步:

  1. 新建包含附件记录映射的导入文件记录。

现在新建另一个导入文件记录,此记录包含我们第一步所建清单数据。

  1. 调用import SDK APIs

当导入用所有记录都准备完毕。Import
SDK提供Parse,Transform和Import SDK APIs用于完成这项工作。提醒,这些APIs通过提交异步作业来完成导入工作。

这些APIs会返回异步作业的唯一id。你可以通过这些id来监控作业状态。

当所有3个作业都完成,你的数据就被导入到系统中了。你可以在应用中打开导入作业记录并检查它。

如下代码展示如何调用APIs。

 

完整样例代码

更多参考信息:

Import Data in Microsoft Dynamics CRM

Data Import Entities

Sample: Import Data Using Complex Data Map

 

谢谢!

Wilson Lou(娄森伟)

原文地址:https://blogs.msdn.com/b/crm/archive/2012/08/06/how-to-import-attachments-programmatically.aspx