工業(yè)管理軟件物料功能開發(fā)案例-實(shí)訓(xùn)指導(dǎo)書

工業(yè)管理軟件物料功能開發(fā)案例實(shí)訓(xùn)指導(dǎo)書一、實(shí)訓(xùn)目的本課程的教學(xué)目的是讓學(xué)生掌握工業(yè)管理軟件物料功能的開發(fā)流程和關(guān)鍵技術(shù)。從系統(tǒng)的需求分析出發(fā)，了解到開發(fā)需要實(shí)現(xiàn)和滿足的實(shí)際業(yè)務(wù)功能點(diǎn)；然后根據(jù)功能點(diǎn)之間的邏輯關(guān)系，使用Modelfirst工具繪制UML關(guān)系圖。再根據(jù)每一個(gè)功能點(diǎn)，繪制對(duì)應(yīng)的功能界面以及使用VisualStudio2019及以上開發(fā)工具補(bǔ)充對(duì)應(yīng)的后臺(tái)邏輯，最后形成一個(gè)完整的物料功能。通過綜合實(shí)訓(xùn)幫助學(xué)生全面牢固地掌握教學(xué)內(nèi)容、培養(yǎng)學(xué)生的實(shí)踐動(dòng)手能力，提高學(xué)生綜合運(yùn)用專業(yè)知識(shí)和專業(yè)技能解決實(shí)際問題的能力，強(qiáng)化課堂教學(xué)與實(shí)踐教學(xué)相結(jié)合，鍛煉學(xué)生的職業(yè)能力。二、實(shí)訓(xùn)準(zhǔn)備1、掌握C#編程開發(fā)技能。2、了解工業(yè)管理軟件開發(fā)的基礎(chǔ)開發(fā)。3、事先要能夠根據(jù)實(shí)訓(xùn)工程源代碼，配置環(huán)境，搭建項(xiàng)目工程。4、安裝好實(shí)訓(xùn)開發(fā)環(huán)境，下載實(shí)訓(xùn)工程源代碼。5、物料的開發(fā)依賴于單位功能，需要先完成單位功能的開發(fā)。三、實(shí)訓(xùn)環(huán)境Windows10或以上操作系統(tǒng)(不能是Windows11家庭版)、Visual

Studio2019或以上開發(fā)工具安裝、數(shù)據(jù)庫可以選擇SqlServer數(shù)據(jù)庫（安裝VS時(shí)將VS自帶的SqlServer安裝上，就可以不用單獨(dú)安裝SqlServer的數(shù)據(jù)庫）或者Oracle數(shù)據(jù)庫（安裝ODAC、安裝Oracle客戶端、安裝PLSQL）、安裝EAP.Modelfirst。四、實(shí)訓(xùn)步驟任務(wù)描述本實(shí)訓(xùn)讓學(xué)生體驗(yàn)一個(gè)完整帶關(guān)系單表功能從設(shè)計(jì)到開發(fā)的全過程，包括系統(tǒng)的需求分析到功能設(shè)計(jì)、數(shù)據(jù)庫設(shè)計(jì)、頁面設(shè)計(jì)及功能實(shí)現(xiàn)等。通過本指導(dǎo)書展開詳細(xì)的開發(fā)步驟。任務(wù)：物料功能實(shí)現(xiàn)邏輯包括：主列表列屬性：編碼、名稱、描述、單位、物料類型、創(chuàng)建人、創(chuàng)建時(shí)間、修改人、修改時(shí)間。操作命令：查詢、添加、復(fù)制新增、修改、刪除、保存、導(dǎo)出、導(dǎo)入、配置項(xiàng)；編輯模式：行內(nèi)編輯；主列表顯示配置：編碼、名稱為固定列；描述列顯示問號(hào)，鼠標(biāo)移到問號(hào)處顯示“物料信息詳情”；當(dāng)物料類型為產(chǎn)品時(shí)，行背景色顯示為橙色；查詢命令：查詢條件：編碼、名稱、單位、物料類型；單位：下拉操作；物料類型：枚舉下拉操作，可以選擇查詢?nèi)繑?shù)據(jù)；添加命令：編碼根據(jù)配置項(xiàng)自動(dòng)生成，只讀；名稱非空；描述可空；單位下拉選擇，非空，顯示為名稱，下來操作的數(shù)據(jù)為可用的數(shù)據(jù)，能夠根據(jù)編碼和名稱模糊查詢單位下拉框的數(shù)據(jù)進(jìn)行篩選；物料類型：非空，枚舉下拉選擇，枚舉值包括：物料和產(chǎn)品，默認(rèn)為物料；復(fù)制新增命令：編碼根據(jù)配置項(xiàng)自動(dòng)生成，只讀；名稱、描述、單位、物料類型默認(rèn)為復(fù)制行的內(nèi)容；修改命令：編碼只讀；名稱非空，描述可空；單位下拉選擇，非空，顯示為名稱，下來操作的數(shù)據(jù)為可用的數(shù)據(jù)，能夠根據(jù)編碼和名稱模糊查詢單位下拉框的數(shù)據(jù)進(jìn)行篩選；物料類型：非空，枚舉下拉選擇，枚舉值包括：物料和產(chǎn)品；刪除按鈕物料刪除按鈕不做限制；單位功能的刪除按鈕增加校驗(yàn)：?jiǎn)挝槐晃锪弦貌辉试S刪除；保存按鈕驗(yàn)證邏輯：編碼、名稱、單位、物料類型非空；導(dǎo)入按鈕：編碼根據(jù)配置項(xiàng)生成；名稱非空；描述可空；單位非空，需要驗(yàn)證數(shù)據(jù)，在單位中存在的數(shù)據(jù)才能導(dǎo)入，否則提示異常，導(dǎo)入失??；物料類型非空，需要驗(yàn)證數(shù)據(jù)，在類型枚舉中存在的值才能導(dǎo)入成功，否則提示異常，導(dǎo)入失?。或?yàn)證通過的數(shù)據(jù)保存成功，失敗的數(shù)據(jù)提示失敗的原因；配置項(xiàng)配置物料編碼的生成規(guī)則；物料功能界面實(shí)現(xiàn)效果：圖1-1物料功能詳細(xì)開發(fā)步驟需求清單分析：表1-1需求清單序號(hào)功能功能需求描述備注1查詢根據(jù)編碼、名稱、單位、類型查詢物料信息，其中單位下拉查詢，類型枚舉下拉支持輸入%模糊查詢2添加添加物料，編碼根據(jù)配置項(xiàng)自動(dòng)生成且只讀，名稱非空，單位選擇單位功能可用的數(shù)據(jù)且非空，類型默認(rèn)為物料且非空3復(fù)制新增編碼根據(jù)配置項(xiàng)自動(dòng)生成，只讀名稱、描述、單位、類型默認(rèn)為復(fù)制行的內(nèi)容4修改修改物料，編碼不允許修改，名稱非空，單位選擇單位功能可用的數(shù)據(jù)且非空，類型非空，枚舉選擇5刪除能成功刪除一筆或多筆數(shù)據(jù)6保存驗(yàn)證通過的數(shù)據(jù)能成功保存，不通過提示具體的異常7導(dǎo)入1）編碼根據(jù)配置項(xiàng)生成，名稱非空2）單位非空，需要驗(yàn)證數(shù)據(jù)，在單位中存在的數(shù)據(jù)才能導(dǎo)入3）類型非空，需要驗(yàn)證數(shù)據(jù)，在類型枚舉中存在的值才能導(dǎo)入成功8導(dǎo)出能夠?qū)С鲞x中和導(dǎo)出全部9配置項(xiàng)配置編碼自動(dòng)生成規(guī)則10界面配置編碼、名稱為固定列；描述列顯示問號(hào)，鼠標(biāo)移到問號(hào)處顯示“物料信息詳情”；當(dāng)類型為產(chǎn)品時(shí)，背景色顯示為橙色；界面字段說明：圖1-2界面字段開發(fā)操作步驟流程說明：圖1-3操作步驟流程圖數(shù)據(jù)庫代碼開發(fā)步驟打開EAP.ModelFirst。在項(xiàng)目總管中建一個(gè)SIE.Test的工程。在SIE.Test的工程中新建一個(gè)ItemTests的文件夾，右鍵文件夾可按圖操作：圖1-4創(chuàng)建Diagram創(chuàng)建完后將出現(xiàn)如下效果：圖1-5Diagram效果雙擊目錄的ItemTests進(jìn)入界面后右鍵新建ItemTest類：圖1-6創(chuàng)建ItemTest類圖雙擊對(duì)ItemTest類進(jìn)行編輯，創(chuàng)建好的物料類屬性如下：圖1-7設(shè)置ItemTest類屬性物料和單位的關(guān)系建立圖1-8單位類添加到物料設(shè)計(jì)器中圖1-9設(shè)置單位和物料的關(guān)聯(lián)關(guān)系圖1-10關(guān)聯(lián)關(guān)系設(shè)置備注物料類型枚舉實(shí)現(xiàn)圖1-11新建枚舉類圖1-12枚舉類的實(shí)現(xiàn)創(chuàng)建物料與物料類型的關(guān)系，使用可空的關(guān)聯(lián)關(guān)系，因?yàn)椴樵冎幸軌虿樵內(nèi)浚@里建關(guān)系建成可空的，可以不用重寫查詢實(shí)體也能滿足業(yè)務(wù)需求。圖1-13物料與物料類型的關(guān)系完成以上所有步驟，選中ItemTest類和ItemType，右鍵生成代碼圖1-14實(shí)體生成代碼接下來將生成ER圖實(shí)體類文件：圖1-15生成實(shí)體類文件選中ItemTest類，右鍵生成代碼圖1-16界面生成代碼生成ER圖界面類文件圖1-17生成界面類文件生成的實(shí)體類文件放置到服務(wù)端工程代碼目錄如下：圖1-18服務(wù)端代碼目錄圖生成的界面類文件放置到客戶端工程代碼目錄如下：圖1-19客戶端代碼目錄圖按以上所有步驟，數(shù)據(jù)庫設(shè)計(jì)我們已經(jīng)完成，并且已生成了相關(guān)的類文件。接下來開始進(jìn)入代碼編寫。物料實(shí)體類功能開發(fā)ItemTest類添加名稱空間的引用，取消[CriteriaQuery]的注釋，生成不報(bào)錯(cuò)。圖1-20物料實(shí)體類報(bào)錯(cuò)和查詢面板實(shí)現(xiàn)物料類型非空處理圖1-21物料類型驗(yàn)證實(shí)現(xiàn)物料下拉顯示名稱和配置項(xiàng)按鈕的實(shí)現(xiàn)圖1-22物料下拉顯示名稱和配置項(xiàng)按鈕的實(shí)現(xiàn)物料界面類ViewConfig功能開發(fā)編碼只讀，編碼、名稱為固定列設(shè)置圖1-23編碼只讀和固定列設(shè)置描述列顯示問號(hào)，鼠標(biāo)移到問號(hào)處顯示“物料信息詳情”實(shí)現(xiàn)圖1-24描述詳情設(shè)置單位編輯器開發(fā)實(shí)現(xiàn)查詢狀態(tài)為可用的單位信息方法實(shí)現(xiàn)，在UnitTestController控制器類中增加方法GetUnits，實(shí)現(xiàn)如下：圖1-25查詢可用狀態(tài)下單位信息單位實(shí)體配置的查詢條件與單位查詢方法的查詢關(guān)鍵字配置為一致的，下拉列表查詢條件取的是實(shí)體顯示成員和查詢成員的并集。圖1-26下拉查詢條件配置自定義單位編輯器的實(shí)現(xiàn)，在客戶端定義一個(gè)擴(kuò)展靜態(tài)類，在靜態(tài)類中實(shí)現(xiàn)單位自定義編輯器。圖1-27單位自定義編輯器的實(shí)現(xiàn)在界面使用編輯器圖1-28使用自定義編輯器物料類型默認(rèn)為物料實(shí)現(xiàn)圖1-29物料類型默認(rèn)值設(shè)置物料下拉列表選擇和查詢視圖配置圖1-30物料下拉列表和查詢條件配置物料類型為產(chǎn)品時(shí)行背景色的變更實(shí)現(xiàn)，在行為的beforeCreate方法中實(shí)現(xiàn)圖1-31物料類型為產(chǎn)品時(shí)行背景色為橙色在ConfigListView方法中使用行為圖1-32使用行為添加和復(fù)制添加按鈕的重寫實(shí)現(xiàn)，主要是處理編碼根據(jù)配置項(xiàng)自動(dòng)生成添加按鈕的前端實(shí)現(xiàn)：圖1-33物料添加命令前端實(shí)現(xiàn)獲取配置項(xiàng)配置值方法的實(shí)現(xiàn)：圖1-34獲取配置項(xiàng)配置值方法實(shí)現(xiàn)添加按鈕的后端實(shí)現(xiàn)：圖1-35物料添加命令后端實(shí)現(xiàn)復(fù)制添加按鈕的前端實(shí)現(xiàn)，繼承SIE.cmd.Copy，重寫_setCopyEntity方法。圖1-36復(fù)制添加命令前端實(shí)現(xiàn)復(fù)制添加命令后端實(shí)現(xiàn)。圖1-37復(fù)制添加命令后端實(shí)現(xiàn)在ConfigListView方法中替換框架的添加和復(fù)制添加命令。圖1-38替換添加和復(fù)制添加命令物料導(dǎo)入命令的開發(fā)實(shí)現(xiàn)導(dǎo)入前端命令實(shí)現(xiàn)：圖1-39導(dǎo)入命令前端實(shí)現(xiàn)導(dǎo)入命令的handle類實(shí)現(xiàn)，文件創(chuàng)建在服務(wù)端工程的ItemTests文件夾下。圖1-40列和列驗(yàn)證的實(shí)現(xiàn)圖1-41物料名稱非空驗(yàn)證圖1-42單位列數(shù)據(jù)校驗(yàn)圖1-43物料類型列數(shù)據(jù)校驗(yàn)圖1-44數(shù)據(jù)釋放及異常消息處理圖1-45導(dǎo)入命令保存邏輯處理導(dǎo)入后端命令實(shí)現(xiàn)：圖1-46導(dǎo)入命令后端實(shí)現(xiàn)導(dǎo)入下載模板的開發(fā)實(shí)現(xiàn)：圖1-47導(dǎo)入模板列配置在物料界面端的ConfigListView中使用導(dǎo)入命令：圖1-48導(dǎo)入命令的使用單位被物料引用不允許刪除的開發(fā)實(shí)現(xiàn)圖1-49單位被物料引用不允許刪除實(shí)現(xiàn)配置模塊與初始化配置初始化菜單，在客戶端工程的初始化類中配置物料初始菜單圖1-50物料初始菜單配置運(yùn)行項(xiàng)目，配置功能菜單圖1-51配置后的效果物料功能的數(shù)據(jù)庫表和序列的生成，在實(shí)體元數(shù)據(jù)功能中點(diǎn)擊“升級(jí)數(shù)據(jù)庫”按鈕，進(jìn)行數(shù)據(jù)庫表的升級(jí)操作。圖1-52升級(jí)數(shù)據(jù)庫圖1-53執(zhí)行升級(jí)數(shù)據(jù)庫操作更新驗(yàn)證，執(zhí)行實(shí)體元數(shù)據(jù)的更新，需要更新物料和單位的規(guī)則。圖1-54更新物料規(guī)則校驗(yàn)效果驗(yàn)證物料功能的效果圖1-55物料功能效果添加按鈕效果，編碼根據(jù)配置項(xiàng)規(guī)則自動(dòng)生成且只讀，物料類型默認(rèn)為物料圖1-56添加按鈕編碼和物料類型默認(rèn)賦值效果單位下拉效果，查詢?yōu)榭捎玫臄?shù)據(jù)圖1-57單位下拉效果保存按鈕的數(shù)據(jù)驗(yàn)證，數(shù)據(jù)驗(yàn)證不通過，會(huì)有對(duì)應(yīng)的提示信息，驗(yàn)證通過可以成功保存數(shù)據(jù)。圖1-58保存按鈕驗(yàn)證未通過效果導(dǎo)入驗(yàn)證。圖1-59導(dǎo)入界面效果圖點(diǎn)擊下載模板，在下載的excel模板中錄入數(shù)據(jù)，瀏覽把錄入數(shù)據(jù)的模板加入進(jìn)來，點(diǎn)擊導(dǎo)入，數(shù)據(jù)驗(yàn)證通過的能夠?qū)氤晒?，?yàn)證不通過的會(huì)有具體的異常提示，如下：圖1-60導(dǎo)入數(shù)據(jù)操作失敗的數(shù)據(jù)會(huì)顯示在對(duì)應(yīng)失敗行的失敗原因中。圖1-61導(dǎo)入失敗詳情單位被物料