CRM導(dǎo)入工具配置

1、CRM 4.0導(dǎo)入工具配置導(dǎo)入工具配置孫張昊高級顧問JackS瑞泰信息技術(shù)有限公司 Agenda 導(dǎo)入工具配置 Entity結(jié)點(diǎn)屬性定義 Field結(jié)點(diǎn)屬性定義 CrmType屬性說明 RefFieldName屬性說明 IsKey和nullAction屬性說明 eval和subStr屬性說明 導(dǎo)入工具配置 導(dǎo)入工具配置滿足客戶需求，將客戶Excel整理的數(shù)據(jù)通過界面的方式導(dǎo)入到系統(tǒng)中，免去重復(fù)的做單過程。 配置說明配置文件：config/RekTec.Crm.ExcelImport.DataMapping.xml數(shù)據(jù)導(dǎo)入之前，需要先對文件進(jìn)行編輯，設(shè)定Excel中列與CRM中實(shí)體屬性之間的關(guān)系

2、，只有設(shè)定正確，數(shù)據(jù)才能正確導(dǎo)入。文件格式 配置文件的內(nèi)容必須按照固定的格式進(jìn)行設(shè)置。所有屬性及屬性對應(yīng)的值都區(qū)分大小寫。樣本如下圖所示: Entity結(jié)點(diǎn)屬性定義該結(jié)點(diǎn)用來配置Excel與CRM實(shí)體之間的對應(yīng)關(guān)系。結(jié)點(diǎn)名稱屬性名稱說明EntitynameExcel導(dǎo)入工具左側(cè)映射列表中顯示的名稱。如客戶檔案、產(chǎn)品資料。crmEntityNameExcel中數(shù)據(jù)所要導(dǎo)入到的CRM實(shí)體名稱。如account。checkUnique填1。readType程序讀取數(shù)據(jù)時(shí)所采用的方式。默認(rèn)為jet。jet一般為excel2003之前的版本。tab文本文件。數(shù)據(jù)之間需用tab鍵分隔。ace一般為exce

3、l2007版本。 clear在導(dǎo)入數(shù)據(jù)之前是否需要將CRM中該實(shí)體的記錄清空。需要?jiǎng)t填1，否則填0。默認(rèn)為1。isCreate用于判斷是不是需要向CRM插入數(shù)據(jù)。0代表只對CRM已有的記錄根據(jù)設(shè)定的主鍵(見2.7說明)進(jìn)行更新，Excel中有但CRM沒有的記錄不做處理，0代表對CRM已有的記錄進(jìn)行更新，CRM沒有的記錄則新增。默認(rèn)為1。sheetName需導(dǎo)入的數(shù)據(jù)在Excel中的Sheet的名稱。建議都統(tǒng)一叫Sheet1。whereSql用于數(shù)據(jù)導(dǎo)入時(shí)根據(jù)該值對從Excel取出的數(shù)據(jù)進(jìn)行篩選。該屬性中值的語法要符合C#中DataTable.Select(string filterExpres

4、sion)中參數(shù)的規(guī)則。另外一些特殊符號需轉(zhuǎn)成編碼后的字符。如”應(yīng)寫成” <”等。 Field結(jié)點(diǎn)屬性定義該結(jié)點(diǎn)針對Excel中的每個(gè)單獨(dú)的列進(jìn)行設(shè)置，用來配置Excel中各列名(表頭)與CRM相應(yīng)實(shí)體中字段的映射關(guān)系以及數(shù)據(jù)之間的關(guān)聯(lián)關(guān)系。結(jié)點(diǎn)名稱屬性名稱是否必填說明FieldcrmName是CRM中實(shí)體的屬性名稱(不是顯示名稱)。excelName是Excel中列的名稱。與crmName屬性相對應(yīng)。crmType是crmName配置的屬性在CRM中的類型。crmType屬性說明refTypeName否crmType為CrmLookup或CrmOwner時(shí)必填。crmType值

5、為Lookup或Owner類型時(shí)所關(guān)聯(lián)的CRM實(shí)體的名稱。refFieldName否refFieldName屬性說明retFieldName否通過refFieldName查找后返回的refTypeName實(shí)體中的字段名稱。不填寫此值默認(rèn)返回refTypeName中實(shí)體ID字段。isKey否isKey和nullAction屬性說明nullAction否isKey和nullAction屬性說明isConst否用于指示該列是否為固定值。是填1，且要填寫conseValue屬性的值，否填0。constValue否isConst為1時(shí)必填。如constValue=是。eval否見eval和subStr屬

6、性說明subStr否見eval和subStr屬性說明 CrmType屬性說明crmName中配置的屬性在CRM中的類型。該項(xiàng)對應(yīng)值有如下幾種：CrmString：對應(yīng)CRM中類型為nvarchar、ntext類型的字段。CrmMoney：對應(yīng)CRM中類型為money類型的字段。CrmBoolean：對應(yīng)CRM中類型為bit類型的字段。Excel中對應(yīng)列的內(nèi)容為(是和否)或(有和無);CrmDateTime：對應(yīng)CRM中類型為datetime的字段。CrmDecimal：對應(yīng)CRM中類型為decimal的字段。CrmFloat：對應(yīng)CRM中類型為float的字段。CrmInteger：對應(yīng)CRM

7、中類型為int的字段。CrmNumber：同CrmInteger。CrmPickList：對應(yīng)CRM中類型為picklist的字段。Excel中對應(yīng)列的內(nèi)容應(yīng)是picklist的顯示值，而不是value。CrmLookup：對應(yīng)CRM中類型為lookup的字段。Excel中對應(yīng)列的內(nèi)容應(yīng)是lookup的顯示值。crmType為此值時(shí)必須填寫refTypeName和refFieldName這兩個(gè)屬性，見下面(4)和(5)的說明。CrmOwner：對應(yīng)CRM中owner類型的字段。Excel中對應(yīng)列的內(nèi)容應(yīng)是owner的顯示值。crmType配置為此值時(shí)必須填寫refTypeName和refFie

8、ldName這兩個(gè)屬性(見下面(4)和(5)的說明)。CrmStatus：對應(yīng)CRM中類型為status的字段。Excel中對應(yīng)列的內(nèi)容應(yīng)是status的顯示值(即可用、不可用)，而不是value。.CrmLookupConst：對應(yīng)CRM中類型為lookup的字段，并且 值為常量，此處應(yīng)填寫lookup的GUID值。 RefFieldName屬性說明CrmType為CrmLookup或CrmOwner時(shí)必填。數(shù)據(jù)導(dǎo)入時(shí)會(huì)根據(jù)此配置項(xiàng)的值到CRM中查找Lookup關(guān)聯(lián)實(shí)體對應(yīng)記錄中retFieldName(見2.6)配置字段的值。若查找到多個(gè)符合條件的記錄，取第一條記錄。 如果根據(jù)一個(gè)字段(如

9、主屬性名稱)就能唯一確定一條記錄，則該項(xiàng)值填寫該字段的名稱。示例1：refTypeName=”new_province” refFieldName=new_name說明1：Lookup關(guān)聯(lián)的實(shí)體(省份)的new_name(省份名稱)值都是不重名 的，所以Excel中該列的值根據(jù)new_name可以查找到唯一的記錄。 RefFieldName屬性說明如果需要根據(jù)多個(gè)字段組合才能確定一條記錄，則該項(xiàng)值的配置格式應(yīng)為CRM屬性名稱1: Excel列名1, CRM屬性名稱2:Excel列名2, 。 示例2：refTypeName=”new_site” refFieldName=new_productt

10、ypename:產(chǎn)品組,new_name:網(wǎng)點(diǎn)名稱,new_sitetype:網(wǎng)點(diǎn)類型說明2：在查找網(wǎng)點(diǎn)時(shí)，有可能產(chǎn)品組不同，但網(wǎng)點(diǎn)名稱相同，也有可能網(wǎng)點(diǎn)類型不同，但產(chǎn)品組和網(wǎng)點(diǎn)名稱相同 ，因此要通過三個(gè)值組合才能確定唯一一個(gè)Lookup。 IsKey和nullAction屬性說明isKey:當(dāng)前字段是不是”主鍵”，是填1，否填0，用于導(dǎo)入時(shí)判斷是新增還是更新。程序會(huì)根據(jù)所有isKey=”1”的字段檢查CRM已有記錄中是否有和當(dāng)前導(dǎo)入記錄相同的記錄，有則進(jìn)行更新，沒有就新增。nullAction:當(dāng)Excel中某行的當(dāng)前配置列的值為空時(shí)，程序所要執(zhí)行的動(dòng)作。該項(xiàng)對應(yīng)值有三種： error：當(dāng)前

11、行的數(shù)據(jù)不會(huì)被導(dǎo)入，并且導(dǎo)入工具界面會(huì)給出錯(cuò)誤提示。當(dāng)某列的值要求不能為空時(shí)，應(yīng)配置為此值。 ignorerow：當(dāng)前行的數(shù)據(jù)不會(huì)被導(dǎo)入，并且系統(tǒng)不會(huì)給出錯(cuò)誤提示。 ignorefield：當(dāng)前行的數(shù)據(jù)會(huì)被導(dǎo)入，但該列的值在CRM中為空。 eval和subStr屬性說明eval:用于定義一些對Excel列內(nèi)容處理的腳本，可以對Excel中數(shù)據(jù)進(jìn)行規(guī)范化，用法跟JavaScript中的eval ()函數(shù)一樣。當(dāng)前列的值在表達(dá)式中用f代替。示例1：eval=f.substring(0,1)說明1：表示取當(dāng)前列的值的第一個(gè)字。比如取Excel中聯(lián)系人姓名的第一個(gè)字作為CRM中Contact實(shí)體lastname的值。示例2：eval=f.replace(,-)說明2：表示將Exc