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

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