EAS自定義引入引出模板使用指南

EAS自定義引入引出模板使用指南[EAS導(dǎo)讀本文檔對(duì)EAS引入引出治理中的自定義模板使用進(jìn)展具體說明并對(duì)常見問題進(jìn)展解答。適用對(duì)象需要引入引出功能的二次開發(fā)人員，實(shí)施人員，客戶引入引出功能測(cè)試人員、開發(fā)人員第1頁(yè)共16頁(yè) 1目 錄簡(jiǎn)介 2\l“_TOC_250011“目的 2\l“_TOC_250010“適用對(duì)象 2參考資料 錯(cuò)誤!未定義書簽。背景 2功能描述 2自定義模板使用說明 3\l“_TOC_250009“制作模板 3\l“_TOC_250008“引出模板 6\l“_TOC_250007“使用模板 7\l“_TOC_250006“公布自定義模板 7\l“_TOC_250005“導(dǎo)出自定義模板腳本 8\l“_TOC_250004“分發(fā)部署自定義模板 9\l“_TOC_250003“使用導(dǎo)入的自定義模板 9自動(dòng)引入數(shù)據(jù) 9\l“_TOC_250002“制定自動(dòng)引入打算 9\l“_TOC_250001“自動(dòng)執(zhí)行引入任務(wù) 10\l“_TOC_250000“馬上執(zhí)行引入任務(wù) 11常見問題解答 11116頁(yè)1. 1. 簡(jiǎn)介目的本文檔對(duì)EAS引入引出治理中的自定義模板使用進(jìn)展具體說明并對(duì)常見問題進(jìn)展解答。適用對(duì)象適用于：需要引入引出功能的二次開發(fā)人員，實(shí)施人員，客戶引入引出功能測(cè)試人員、開發(fā)人員2. 2. 背景引入功能。因此存在如下兩種系統(tǒng)標(biāo)準(zhǔn)數(shù)據(jù)引入引出功能處理不了的狀況：系統(tǒng)中有些業(yè)務(wù)對(duì)象沒有開發(fā)對(duì)應(yīng)的數(shù)據(jù)引入引出功能；業(yè)務(wù)對(duì)象開發(fā)了引入功能，但客戶針對(duì)此業(yè)務(wù)對(duì)象做了二次開發(fā)，增加了字段，以前的引入功能將不能滿足增字段的內(nèi)容引入；此時(shí)可以考慮利用自定義引入實(shí)現(xiàn)上面兩類業(yè)務(wù)對(duì)象的引入。3. 3. 功能描述〔ormappin數(shù)據(jù)文件中的一行記錄轉(zhuǎn)化為EAS中的一個(gè)對(duì)象，然后通過對(duì)象-關(guān)系映射〔ormapping〕將對(duì)象長(zhǎng)期化到數(shù)據(jù)庫(kù)中。關(guān)系以注釋形式放在模板文件中，便利使用。同時(shí)考慮到了某些字段的非空特性，在制作模板時(shí)可以設(shè)置非空屬性，設(shè)置非空屬性的字段將在引入時(shí)進(jìn)展是否為空的檢查；此功能考慮的映射關(guān)系包括了現(xiàn)有的各個(gè)類型字段的引入，可以將簡(jiǎn)潔屬性的字段設(shè)置映射關(guān)系；也可以將連接屬性的字段設(shè)置映射關(guān)系，一個(gè)實(shí)體的連接屬性有兩種類型，即引用類型，合成類型，引用類型即說明一個(gè)對(duì)象中引用了另一個(gè)對(duì)象，如對(duì)象‘省份’中有一個(gè)引用屬性‘國(guó)家定義模板時(shí)可以將‘國(guó)家’屬性下的‘編碼’設(shè)置為映射字段，在錄入時(shí)錄入國(guó)家的編碼將依據(jù)此編碼找到對(duì)應(yīng)的國(guó)家對(duì)象，并設(shè)置為省份的國(guó)家屬性的值；合成類型的屬性一般對(duì)應(yīng)著分錄，系統(tǒng)也支持合成屬性的引入。引入中不限制屬性的層次。此功能的操作格外簡(jiǎn)便，可以分為三個(gè)步驟；123下面分別描述第216頁(yè)4. 自定義模板使用說明4. 自定義模板使用說明制作模板administratorEAS系統(tǒng)，選擇菜單系統(tǒng)平臺(tái)-引入引出治理--引入引出模板治理，選擇維護(hù)自定義模板，消滅界面如以以下圖：其中增模板針對(duì)系統(tǒng)中還沒有供給引入功能的業(yè)務(wù)對(duì)象；字段實(shí)現(xiàn)數(shù)據(jù)引入引出功能。選擇維護(hù)模板將要求選擇一個(gè)現(xiàn)有系統(tǒng)模板。選擇下一步，設(shè)置根本信息。消滅界面如以以下圖：316頁(yè)體，在公布元數(shù)據(jù)后還需要在治理把握臺(tái)中執(zhí)行同步伐系統(tǒng)樹操作后才能夠在這里選擇到。“引出查詢對(duì)象”是跟“引入實(shí)體對(duì)象”對(duì)應(yīng)的查詢對(duì)象，用于獵取引出數(shù)據(jù)。假設(shè)二次開發(fā)增加字段后需要實(shí)現(xiàn)數(shù)據(jù)引入引出功能，那么要先修改對(duì)應(yīng)的查詢對(duì)象，增加相關(guān)的查詢字段。選擇下一步，字段設(shè)置。416頁(yè)點(diǎn)擊‘增加字段’按鈕在實(shí)體屬性樹上選擇需要的引入引出字段。選擇字段后，可以對(duì)選擇的字段進(jìn)展設(shè)置：查詢對(duì)象”中定義的查詢結(jié)果字段進(jìn)展綁定。。假設(shè)不存在則往數(shù)據(jù)庫(kù)增數(shù)據(jù)。516頁(yè)內(nèi)值的對(duì)應(yīng)關(guān)系。選擇完成，完成制作模板在模板列表中找到剛剛維護(hù)的模板，設(shè)置引入方式。的數(shù)據(jù)，則會(huì)引起數(shù)據(jù)引入失敗。把數(shù)據(jù)庫(kù)中原來的非空值置空。假設(shè)不存在則往數(shù)據(jù)庫(kù)增數(shù)據(jù)。值，則不會(huì)更數(shù)據(jù)庫(kù)中的非空值。假設(shè)不存在則往數(shù)據(jù)庫(kù)增數(shù)據(jù)。引出模板保存在本地，形成模板文件如以以下圖：616頁(yè)在模板文件中錄入數(shù)據(jù)。使用模板選擇菜單系統(tǒng)平臺(tái)-引入引出治理--引入引出工具，消滅界面如以以下圖：選擇維護(hù)的自定義模板，選擇引入的文件，并運(yùn)行。引入完畢掃瞄界面查看數(shù)據(jù)是否正常引入。公布自定義模板功能按鈕，但是這個(gè)“引入模板”功能只是在二次開發(fā)創(chuàng)立指定數(shù)據(jù)轉(zhuǎn)換實(shí)現(xiàn)類時(shí)便利錄入模板字段信息使用的。716頁(yè)為了實(shí)現(xiàn)自定義模板的公布，可以利用“引入引出模板治理”中的“數(shù)據(jù)導(dǎo)出工具”導(dǎo)出自定義模板腳本，然后在名目效勞器上執(zhí)行該腳本就到達(dá)公布自定義模板的目的。下面具體描述操作步驟。導(dǎo)出自定義模板腳本在“引入引出模板”界面中按“F11”顯示“數(shù)據(jù)導(dǎo)出工具”界面。816頁(yè)選擇“數(shù)據(jù)類型”為“數(shù)據(jù)引入引出腳本引出錄入“導(dǎo)出數(shù)據(jù)編碼“sql文件的分隔符”指定為“EAS的治理點(diǎn)擊“導(dǎo)出數(shù)據(jù)”按鈕，系統(tǒng)提示成功創(chuàng)立文件，及文件保存位置。這里提示的文件保存位置是指文件在效勞端的保存位置。分發(fā)部署自定義模板將自定義模板腳本拷貝到需要部署的效勞器。EAS治理把握臺(tái)中使用“執(zhí)行腳本文件”功能添加自定義模板腳本。檢查“引入引出模板”中是否增加了剛導(dǎo)入的自定義模板。使用導(dǎo)入的自定義模板使用通過執(zhí)行腳本導(dǎo)入的自定義模板與手工創(chuàng)立的自定義模板一樣，也是先導(dǎo)出模板Excel文件，將數(shù)據(jù)錄入Excel文件，通過“數(shù)據(jù)引入引出”功能引入數(shù)據(jù)。6. 6. 自動(dòng)引入數(shù)據(jù)能類似于Windows系統(tǒng)中的打算任務(wù)，只有客戶端翻開“自動(dòng)引入”功能，才會(huì)按打算執(zhí)行引入任務(wù)。制定自動(dòng)引入打算在“自動(dòng)引入列表”界面點(diǎn)擊“增”按鈕，顯示“自動(dòng)引入編輯”界面。第916頁(yè)設(shè)置調(diào)度周期后，點(diǎn)擊“完成自動(dòng)執(zhí)行引入任務(wù)任務(wù)的相關(guān)信息，向效勞端發(fā)起數(shù)據(jù)引入調(diào)用。執(zhí)行完畢后把處理結(jié)果寫到一個(gè)日志文件中〔保存名目為C:\importlo，并將被子引入的數(shù)據(jù)文件改名。1016頁(yè)馬上執(zhí)行引入任務(wù)在“自動(dòng)引入列表”界面選擇一條自動(dòng)引入打算記錄，然后點(diǎn)擊工具欄中的“馬上執(zhí)行”按鈕，系統(tǒng)強(qiáng)制執(zhí)行選中的引入打算。執(zhí)行完畢后顯示執(zhí)行結(jié)果保存在一個(gè)日志文件中〔保存名目為C:\importlo改名。7. 7. 常見問題解答1、問：在運(yùn)行過程中提示找不到模板？答：請(qǐng)檢查solutionName是否設(shè)置正確；2、問：引入引出窗口在窗口切換后不見了？答：需要設(shè)置引入引出窗口的父窗口。如DatataskCaller.setParentComponent3、問：運(yùn)行日志提示某數(shù)據(jù)行消滅了錯(cuò)誤，卻沒有具體錯(cuò)誤信息？答：一般是實(shí)現(xiàn)了AbstractDataTransmission抽象類的類中拋出了NullPointException特別，特別信息為空。4、問：提示文件定義錯(cuò)誤？答：請(qǐng)檢查數(shù)據(jù)文件格式是否與模板文件全都；5、問：引出數(shù)據(jù)時(shí)報(bào)以下特別java.lang.NoSuchMethodError:org.apache.poi.hssf.usermodel.HSSFSheet.setDefaultColumnStyle(SLorg/apache/poi/hssf/usermodel/HSSFCellStyle;)Vatcom.kingdee.eas.tools.datatask.export.ExternalExcelDataWriter.addOrgStructCell1(ExternalExcelDataWriter.java:159)atcom.kingdee.eas.tools.datatask.export.ExternalExcelDataWriter.writeStruct(ExternalExcelDataWriter.java:51116頁(yè)30)atcom.kingdee.eas.tools.datatask.task.TaskExportEASDataRunner.onInitResources(TaskExportEASDataRunner.java:114)atcom.kingdee.eas.tools.datatask.task.TaskAbstractRunnerAdapter.run(TaskAbstractRunnerAdapter.java:86)atcom.kingdee.eas.tools.datatask.app.DatataskRunServerControllerBean.runOnExportMode(DatataskRunServerControllerBean.java:92)atcom.kingdee.eas.tools.datatask.app.DatataskRunServerControllerBean._runSingleTask(DatataskRunServerControllerBean.java:751)atcom.kingdee.eas.tools.datatask.app.AbstractDatataskRunServerControllerBean.runSingleTask(AbstractDatataskRunServerControllerBean.java:211)答：?jiǎn)栴}緣由。補(bǔ)丁或者二次開發(fā)中包含一個(gè)POI包(如Jakarta-poi-2.5.jar)，而引入引出中使用的POIpoi-bin-3.0-alpha2-20230616.jarJakarta-poi-2.5.jar中沒有對(duì)應(yīng)的方法，所以報(bào)特別。解決方法：把其它版本的POI包如Jakarta-poi-2.5.jar備份后刪除，換成poi-bin-3.0-alpha2-20230616.jar，檢查引入引出功能和業(yè)務(wù)功能能否正常執(zhí)行。6、問：使用自定義模板引出數(shù)據(jù)時(shí)為什么報(bào)“沒有供給引出功能”？答：請(qǐng)檢查自定義模板的“引出查詢對(duì)象”是否為空，假設(shè)為空就會(huì)報(bào)“沒有供給引出功能第1216頁(yè)7、問：使用自定義模板引出數(shù)據(jù)，引出的數(shù)據(jù)文件中沒有記錄數(shù)據(jù)，事實(shí)上系統(tǒng)中是有數(shù)據(jù)的。字段綁定將數(shù)據(jù)寫入引出數(shù)據(jù)文件中。8用戶把握數(shù)據(jù)引入的執(zhí)行。界面上?！白詣?dòng)引入”的執(zhí)行模式固定為“更引入模式由用戶定制。9、問：為什么屢次點(diǎn)擊“自動(dòng)引入列表”界面上的“馬上執(zhí)行”按鈕都是顯示“執(zhí)行完成”？答：點(diǎn)擊“馬上執(zhí)行”按鈕后顯示的“執(zhí)行完成并不表示成功或失敗。執(zhí)行結(jié)果保存在日志文件中〔保存名目為C:\importlo。10、問：創(chuàng)立自定義模板時(shí)在一個(gè)關(guān)聯(lián)實(shí)體中選擇了多個(gè)屬性，在引入數(shù)據(jù)時(shí)報(bào)1316頁(yè)于獵取被引入實(shí)體與關(guān)聯(lián)實(shí)體的關(guān)聯(lián)信息。通常是依據(jù)關(guān)聯(lián)實(shí)體的編碼查詢出對(duì)應(yīng)記錄的FID，然后將這個(gè)FID填入被引入實(shí)體的對(duì)應(yīng)關(guān)聯(lián)屬性?！睩I會(huì)引入到數(shù)據(jù)庫(kù)中。選擇的關(guān)聯(lián)實(shí)體屬性越多，定位到的關(guān)聯(lián)實(shí)體標(biāo)志就越準(zhǔn)確，但是同時(shí)用戶可能精簡(jiǎn)，通常選擇關(guān)聯(lián)實(shí)體的編碼作為關(guān)聯(lián)實(shí)體屬性就可以了。11、問：創(chuàng)立模板后執(zhí)行引入操作，執(zhí)行失敗。在效勞端后臺(tái)報(bào)創(chuàng)立實(shí)例特別。答：跟蹤代碼發(fā)出是在DatataskRunServerControllerBean的isBatchImportOperate方法中的Objecto=classDefinition.newInstance;AbstractDataTransmission的實(shí)現(xiàn)類聲明成是抽象類，所以不能實(shí)例化。12、問：引出數(shù)據(jù)時(shí)失敗，提示‘獵取數(shù)據(jù)集失敗’答：引出數(shù)據(jù)量超出EAS限制，EAS對(duì)查詢結(jié)果集作了約束。配置信息保存在效勞端\server\profiles\server1\config\bosconfig.xml<configitemname=“DebugOptions“><attributekey=“cacheLazyLoad“value=“false“/><attributekey=“criticalCollection“value=“10000“/><attribut