工業(yè)管理軟件Api接口和調(diào)度功能開發(fā)案例-實訓(xùn)指導(dǎo)書

工業(yè)管理軟件Api接口和調(diào)度功能開發(fā)案例實訓(xùn)指導(dǎo)書一、實訓(xùn)目的本課程的教學(xué)目的是讓學(xué)生掌握工業(yè)管理軟件Api接口和調(diào)度功能的開發(fā)流程和關(guān)鍵技術(shù)。從系統(tǒng)的需求分析出發(fā)，了解到開發(fā)需要實現(xiàn)和滿足的實際業(yè)務(wù)功能點；根據(jù)功能點的業(yè)務(wù)需求。使用VisualStudio2019及以上開發(fā)工具對其進行開發(fā)實現(xiàn)，然后在功能中進行測試，完成Api接口和調(diào)度功能的開發(fā)實現(xiàn)及效果驗證。通過綜合實訓(xùn)幫助學(xué)生全面牢固地掌握教學(xué)內(nèi)容、培養(yǎng)學(xué)生的實踐動手能力，提高學(xué)生綜合運用專業(yè)知識和專業(yè)技能解決實際問題的能力，強化課堂教學(xué)與實踐教學(xué)相結(jié)合，鍛煉學(xué)生的職業(yè)能力。二、實訓(xùn)準備1、掌握C#編程開發(fā)技能。2、了解工業(yè)管理軟件的基礎(chǔ)開發(fā)。3、事先要能夠根據(jù)實訓(xùn)工程源代碼，配置環(huán)境，搭建項目工程。4、安裝好實訓(xùn)開發(fā)環(huán)境，下載實訓(xùn)工程源代碼。5、Api接口和調(diào)度功能的開發(fā)依賴于采購訂單，需要先完成采購訂單功能的開發(fā)實現(xiàn)。三、實訓(xùn)環(huán)境Windows10或以上操作系統(tǒng)(不能是Windows11家庭版)、Visual

Studio2019或以上開發(fā)工具安裝、數(shù)據(jù)庫可以選擇SqlServer數(shù)據(jù)庫（安裝VS時將VS自帶的SqlServer安裝上，就可以不用單獨安裝SqlServer的數(shù)據(jù)庫）或者Oracle數(shù)據(jù)庫（安裝ODAC、安裝Oracle客戶端、安裝PLSQL）、安裝EAP.Modelfirst、VS中導(dǎo)入代碼片段。四、實訓(xùn)步驟任務(wù)描述本實訓(xùn)讓學(xué)生體驗Api接口和調(diào)度功能的開發(fā)過程。通過本指導(dǎo)書展開詳細的開發(fā)步驟。任務(wù)：Api接口和調(diào)度功能實現(xiàn)邏輯包括：Api接口：傳入?yún)?shù)：傳入?yún)?shù)：開始時間和結(jié)束時間（不可為空），頁數(shù)（可為空，為空查第一頁），頁數(shù)據(jù)量（可為空，為空查所有）；接口實現(xiàn)邏輯：傳入的開始時間和結(jié)束時間去跟采購日期進行匹配，開始時間〈=采購日期〈=結(jié)束時間，根據(jù)頁數(shù)和頁數(shù)據(jù)量將滿足條件的訂單和對應(yīng)訂單明細的數(shù)據(jù)返回；接口返回值說明：訂單包含的字段內(nèi)容：訂單號、采購日期、訂單總金額、訂單狀態(tài)、備注；訂單明細包含的字段內(nèi)容：產(chǎn)品編碼、產(chǎn)品名稱、采購價、銷售價、采購數(shù)量、總金額、備注；接口完成后需要編寫接口卡。調(diào)度任務(wù)功能：調(diào)度任務(wù)執(zhí)行邏輯：根據(jù)頁數(shù)和頁數(shù)據(jù)量查詢采購信息，查詢數(shù)據(jù)按采購時間的升序進行排序，通過調(diào)度定時去更改采購訂單的狀態(tài)，狀態(tài)變更的條件：訂單對應(yīng)所有訂單明細的入庫數(shù)量為0，采購訂單的狀態(tài)變更為新建；訂單對應(yīng)所有訂單明細的0〈入庫數(shù)量〈采購數(shù)量，采購訂單的狀態(tài)變更為部分接收；訂單對應(yīng)所有訂單明細的入庫數(shù)量=采購數(shù)量，采購訂單的狀態(tài)變更為全部接收；調(diào)度參數(shù)：頁數(shù)、頁數(shù)據(jù)量，調(diào)度任務(wù)未配置頁數(shù)和頁數(shù)量，提示頁數(shù)和頁數(shù)據(jù)量必須配置；調(diào)度任務(wù)必須記錄日志信息。Api開放接口效果：圖1-1Api開放接口效果調(diào)度任務(wù)實現(xiàn)效果：圖1-2調(diào)度任務(wù)效果詳細開發(fā)步驟Api接口和調(diào)度功能開發(fā)環(huán)境配置介紹Api接口服務(wù)使用的是SIE.WebApiHost，要進行Api接口的調(diào)試測試，需要先將實現(xiàn)接口的服務(wù)端工程添加依賴到SIE.WebApiHost，如我是在SIE.Test工程實現(xiàn)的接口，需要先將該工程引用到SIE.WebApiHost，并配置對應(yīng)工程的數(shù)據(jù)庫連接。圖1-3SIE.WebApiHost添加Api接口對應(yīng)工程依賴和數(shù)據(jù)庫配置調(diào)度功能：調(diào)度平臺使用的數(shù)據(jù)庫連接是hangfire，如果調(diào)試工程沒有添加hangfire的數(shù)據(jù)庫連接，需要先添加上。圖1-4調(diào)度連接字符串配置調(diào)試工程需要依賴調(diào)度平臺相關(guān)dll圖1-5調(diào)試工程依賴調(diào)度的程序集調(diào)度平臺的表如果使用的是SQLSERVER的數(shù)據(jù)庫，是可以直接使用平臺的升級數(shù)據(jù)庫功能進行表的生成；如果使用的是oracle的數(shù)據(jù)庫，則需要使用腳本在數(shù)據(jù)庫中執(zhí)行，腳本如下。圖1-6調(diào)度平臺oracle數(shù)據(jù)庫腳本以上是做Api接口和調(diào)度功能要提前檢查和配置的開發(fā)環(huán)境，環(huán)境準備好后，接下來就進入到Api接口和調(diào)度功能的開發(fā)實現(xiàn)了。Api接口的功能開發(fā)Api接口返回值訂單明細類的定義。圖1-7Api接口返回值訂單明細類的定義Api接口返回值采購訂單信息類的定義。圖1-8Api接口返回值訂單類的定義在SIE.Test工程的OrderTests文件夾下定義一個控制器，區(qū)分方法的控制器。圖1-9接口控制器的定義訂單控制器類聲明為部分類。圖1-10訂單控制器類聲明為部分類獲取采購訂單信息的Api接口的實現(xiàn)圖1-11獲取訂單Api接口實現(xiàn)Api接口方法體的邏輯實現(xiàn)圖1-12Api接口方法體的實現(xiàn)圖1-13根據(jù)條件查詢采購訂單方法的實現(xiàn)接口實現(xiàn)完成后編寫接口卡。圖1-14接口卡編寫請求效果圖1-15接口卡編寫返回值效果到這，Api接口的開發(fā)完成了。調(diào)度功能的開發(fā)實現(xiàn)調(diào)度參數(shù)類的開發(fā)實現(xiàn)。圖1-16調(diào)度參數(shù)類的開發(fā)實現(xiàn)調(diào)度參數(shù)界面類的開發(fā)實現(xiàn)。圖1-17調(diào)度參數(shù)界面類的開發(fā)實現(xiàn)根據(jù)業(yè)務(wù)條件保存訂單邏輯的方法實現(xiàn)。圖1-18保存訂單信息調(diào)度類的開發(fā)實現(xiàn)。圖1-19調(diào)度類的開發(fā)實現(xiàn)運行項目，配置調(diào)度任務(wù)，我們開發(fā)的采購訂單任務(wù)在調(diào)度任務(wù)設(shè)置，添加按鈕中可以展示出來。圖1-20實現(xiàn)的調(diào)度任務(wù)到這，采購訂單的狀態(tài)更改調(diào)度任務(wù)就都開發(fā)完成了。效果驗證以SIE.WebApiHost啟用，允許SIE.WebApiHost項目，項目啟動成功的效果。圖1-21SIE.WebApiHost啟動成功效果將服務(wù)的IP和端口復(fù)制到瀏覽器中效果，將*改成localhost。圖1-22SIE.WebApiHost瀏覽器運行效果接口實現(xiàn)的效果。圖1-23接口實現(xiàn)效果-參數(shù)和返回值說明圖1-24接口實現(xiàn)效果-接口請求圖1-25接口實現(xiàn)效果-接口響應(yīng)在Api使用說明中獲取票據(jù)。圖1-26獲取票據(jù)將票據(jù)粘貼到Api方法GetPurOrderList請求中的Ticket，配置傳入?yún)?shù)的開始時間和結(jié)束時間。圖1-27粘貼票據(jù)，配置傳入?yún)?shù)開始時間和結(jié)束時間點擊請求，查詢Api接口的返回值效果圖1-28供應(yīng)商標簽打印按鈕效果到這Api接口的效果就驗證完成了，如果返回值存在問題，可以在Api方法中設(shè)置斷點，點擊Post進行調(diào)試測試原因。在調(diào)度任務(wù)設(shè)置中添加調(diào)度任務(wù)。圖1-29添加調(diào)度任務(wù)配置調(diào)度的表達式，如果要根據(jù)cron表達式定期執(zhí)行周期，依賴于調(diào)度服務(wù)，實際項目中該表達式的執(zhí)行周期不建議設(shè)置太短。圖1-30cron表達式配置配置方法參數(shù)、庫存組織和員工，點擊保存，保存任務(wù)圖1-31配置方法參數(shù)、庫存組織和員工未配置任務(wù)參數(shù)，點擊運行，日志中會記錄錯誤，參數(shù)未配置。圖1-32未配置參數(shù)任務(wù)執(zhí)行效果調(diào)度任務(wù)參數(shù)配置，按如下配置，配置完成后點擊保存數(shù)據(jù)。圖1-33調(diào)度參數(shù)配置配置參數(shù)后，點擊運行，調(diào)度任務(wù)執(zhí)行的效果圖1-34配置任務(wù)參數(shù)調(diào)度任務(wù)執(zhí)行效果調(diào)度任務(wù)的驗證到這也就完成了，如果調(diào)度任務(wù)執(zhí)行保存，可以在job的ExecuteJob方法中