CRM导入工具配置

1、CRM 4.0导入工具配置导入工具配置孙张昊高级顾问JackS瑞泰信息技术有限公司 Agenda 导入工具配置 Entity结点属性定义 Field结点属性定义 CrmType属性说明 RefFieldName属性说明 IsKey和nullAction属性说明 eval和subStr属性说明 导入工具配置 导入工具配置满足客户需求，将客户Excel整理的数据通过界面的方式导入到系统中，免去重复的做单过程。 配置说明配置文件：config/RekTec.Crm.ExcelImport.DataMapping.xml数据导入之前，需要先对文件进行编辑，设定Excel中列与CRM中实体属性之间的关系

2、，只有设定正确，数据才能正确导入。文件格式 配置文件的内容必须按照固定的格式进行设置。所有属性及属性对应的值都区分大小写。样本如下图所示: Entity结点属性定义该结点用来配置Excel与CRM实体之间的对应关系。结点名称属性名称说明EntitynameExcel导入工具左侧映射列表中显示的名称。如客户档案、产品资料。crmEntityNameExcel中数据所要导入到的CRM实体名称。如account。checkUnique填1。readType程序读取数据时所采用的方式。默认为jet。jet一般为excel2003之前的版本。tab文本文件。数据之间需用tab键分隔。ace一般为exce

3、l2007版本。 clear在导入数据之前是否需要将CRM中该实体的记录清空。需要则填1，否则填0。默认为1。isCreate用于判断是不是需要向CRM插入数据。0代表只对CRM已有的记录根据设定的主键(见2.7说明)进行更新，Excel中有但CRM没有的记录不做处理，0代表对CRM已有的记录进行更新，CRM没有的记录则新增。默认为1。sheetName需导入的数据在Excel中的Sheet的名称。建议都统一叫Sheet1。whereSql用于数据导入时根据该值对从Excel取出的数据进行筛选。该属性中值的语法要符合C#中DataTable.Select(string filterExpres

4、sion)中参数的规则。另外一些特殊符号需转成编码后的字符。如”应写成” <”等。 Field结点属性定义该结点针对Excel中的每个单独的列进行设置，用来配置Excel中各列名(表头)与CRM相应实体中字段的映射关系以及数据之间的关联关系。结点名称属性名称是否必填说明FieldcrmName是CRM中实体的属性名称(不是显示名称)。excelName是Excel中列的名称。与crmName属性相对应。crmType是crmName配置的属性在CRM中的类型。crmType属性说明refTypeName否crmType为CrmLookup或CrmOwner时必填。crmType值

5、为Lookup或Owner类型时所关联的CRM实体的名称。refFieldName否refFieldName属性说明retFieldName否通过refFieldName查找后返回的refTypeName实体中的字段名称。不填写此值默认返回refTypeName中实体ID字段。isKey否isKey和nullAction属性说明nullAction否isKey和nullAction属性说明isConst否用于指示该列是否为固定值。是填1，且要填写conseValue属性的值，否填0。constValue否isConst为1时必填。如constValue=是。eval否见eval和subStr属

6、性说明subStr否见eval和subStr属性说明 CrmType属性说明crmName中配置的属性在CRM中的类型。该项对应值有如下几种：CrmString：对应CRM中类型为nvarchar、ntext类型的字段。CrmMoney：对应CRM中类型为money类型的字段。CrmBoolean：对应CRM中类型为bit类型的字段。Excel中对应列的内容为(是和否)或(有和无);CrmDateTime：对应CRM中类型为datetime的字段。CrmDecimal：对应CRM中类型为decimal的字段。CrmFloat：对应CRM中类型为float的字段。CrmInteger：对应CRM

7、中类型为int的字段。CrmNumber：同CrmInteger。CrmPickList：对应CRM中类型为picklist的字段。Excel中对应列的内容应是picklist的显示值，而不是value。CrmLookup：对应CRM中类型为lookup的字段。Excel中对应列的内容应是lookup的显示值。crmType为此值时必须填写refTypeName和refFieldName这两个属性，见下面(4)和(5)的说明。CrmOwner：对应CRM中owner类型的字段。Excel中对应列的内容应是owner的显示值。crmType配置为此值时必须填写refTypeName和refFie

8、ldName这两个属性(见下面(4)和(5)的说明)。CrmStatus：对应CRM中类型为status的字段。Excel中对应列的内容应是status的显示值(即可用、不可用)，而不是value。.CrmLookupConst：对应CRM中类型为lookup的字段，并且 值为常量，此处应填写lookup的GUID值。 RefFieldName属性说明CrmType为CrmLookup或CrmOwner时必填。数据导入时会根据此配置项的值到CRM中查找Lookup关联实体对应记录中retFieldName(见2.6)配置字段的值。若查找到多个符合条件的记录，取第一条记录。 如果根据一个字段(如

9、主属性名称)就能唯一确定一条记录，则该项值填写该字段的名称。示例1：refTypeName=”new_province” refFieldName=new_name说明1：Lookup关联的实体(省份)的new_name(省份名称)值都是不重名 的，所以Excel中该列的值根据new_name可以查找到唯一的记录。 RefFieldName属性说明如果需要根据多个字段组合才能确定一条记录，则该项值的配置格式应为CRM属性名称1: Excel列名1, CRM属性名称2:Excel列名2, 。 示例2：refTypeName=”new_site” refFieldName=new_productt

10、ypename:产品组,new_name:网点名称,new_sitetype:网点类型说明2：在查找网点时，有可能产品组不同，但网点名称相同，也有可能网点类型不同，但产品组和网点名称相同 ，因此要通过三个值组合才能确定唯一一个Lookup。 IsKey和nullAction属性说明isKey:当前字段是不是”主键”，是填1，否填0，用于导入时判断是新增还是更新。程序会根据所有isKey=”1”的字段检查CRM已有记录中是否有和当前导入记录相同的记录，有则进行更新，没有就新增。nullAction:当Excel中某行的当前配置列的值为空时，程序所要执行的动作。该项对应值有三种： error：当前

11、行的数据不会被导入，并且导入工具界面会给出错误提示。当某列的值要求不能为空时，应配置为此值。 ignorerow：当前行的数据不会被导入，并且系统不会给出错误提示。 ignorefield：当前行的数据会被导入，但该列的值在CRM中为空。 eval和subStr属性说明eval:用于定义一些对Excel列内容处理的脚本，可以对Excel中数据进行规范化，用法跟JavaScript中的eval ()函数一样。当前列的值在表达式中用f代替。示例1：eval=f.substring(0,1)说明1：表示取当前列的值的第一个字。比如取Excel中联系人姓名的第一个字作为CRM中Contact实体lastname的值。示例2：eval=f.replace(,-)说明2：表示将Exc