MES開發(fā)與應(yīng)用 課件 3.12 工業(yè)管理軟件開發(fā)基礎(chǔ)-調(diào)度功能的使用與開發(fā)

3.12調(diào)度功能的使用與開發(fā)深圳市信息職業(yè)技術(shù)學(xué)院目

錄調(diào)度功能介紹01調(diào)度界面配置說明02調(diào)度功能開發(fā)示例03常見異常問題列舉04知識回顧接口介紹；Api接口的定義；Api接口的開發(fā)與測試；Api接口的調(diào)用。學(xué)習(xí)目標(biāo)通過本節(jié)學(xué)習(xí)可以：掌握調(diào)度任務(wù)的配置；掌握調(diào)度參數(shù)類的開發(fā)實現(xiàn)；掌握調(diào)度任務(wù)類的開發(fā)實現(xiàn)；了解調(diào)度常見問題；01調(diào)度功能介紹調(diào)度功能介紹調(diào)度功能介紹調(diào)度：是指根據(jù)一定的策略和算法，按照預(yù)定的規(guī)則和優(yōu)先級，安排任務(wù)或資源的執(zhí)行順序和時間分配的過程。工業(yè)管理軟件的調(diào)度任務(wù)是指系統(tǒng)按配置要求，定時執(zhí)行相關(guān)的任務(wù)，這里分別有兩個方面，一個是要執(zhí)行的任務(wù)，需要開發(fā)人員使用代碼實現(xiàn)相關(guān)的業(yè)務(wù)邏輯，另一個是實施人員在系統(tǒng)中配置執(zhí)行任務(wù)的時間、周期、參數(shù)等。使用調(diào)度的功能，如果是直連數(shù)據(jù)庫調(diào)試，需要在WebClient工程中引用Hangfire.Oracle.Core.dll，SIE.Schedule.dll和SIE.Web.Schedule.dll，依賴的第三方包：Hangfire1.7.8，Hangfire.Core1.7.8。調(diào)度的數(shù)據(jù)庫連接名：hangfire；VS自帶的數(shù)據(jù)庫連接配置"hangfire":{"Name":"hangfire","ConnectionString":"DataSource=(LocalDB)\\MSSQLLocalDB;AttachDbFilename=D:\\Project\\DEMO\\SMOM.Demo.V9.1\\App_Data\\DEMO_91.mdf;IntegratedSecurity=True;UserId=DEMO_91","ProviderName":"System.Data.SqlClient"},調(diào)度功能介紹調(diào)度功能介紹調(diào)度功能的開發(fā)，最好是與業(yè)務(wù)工程區(qū)分開，單獨建調(diào)度工程進(jìn)行調(diào)度功能的開發(fā)，工程名以Job結(jié)尾。命名規(guī)范：調(diào)度任務(wù)類命名以Job結(jié)尾；調(diào)度參數(shù)類命名以JobParameter結(jié)尾。做調(diào)度功能開發(fā)時，調(diào)度任務(wù)類是必須的，調(diào)度參數(shù)類非必須(根據(jù)具體的業(yè)務(wù)來決定是否需要參數(shù)類)。做調(diào)度功能開發(fā)時，日志必須記錄詳細(xì)。02調(diào)度界面配置說明調(diào)度界面配置調(diào)度界面配置調(diào)度的界面配置都是在“調(diào)度任務(wù)設(shè)置”功能配置完成的。調(diào)度界面配置調(diào)度界面配置在“調(diào)度任務(wù)設(shè)置”功能中添加調(diào)度任務(wù)，選擇一筆數(shù)據(jù)，點擊確定。調(diào)度界面配置調(diào)度界面配置調(diào)度名稱可以修改，配置cron表達(dá)式和方法參數(shù)。調(diào)度界面配置調(diào)度界面配置配置調(diào)度任務(wù)參數(shù)（執(zhí)行時間和周期）點擊調(diào)度任務(wù)的“cron表達(dá)式”，可配置調(diào)度任務(wù)的執(zhí)行時間及周期，即告訴調(diào)度器什么時候執(zhí)行，或者隔多久執(zhí)行一次。調(diào)度界面配置調(diào)度界面配置配置調(diào)度任務(wù)的參數(shù)（業(yè)務(wù)參數(shù)）點擊調(diào)度任務(wù)的“方法參數(shù)”，即可彈出該任務(wù)的業(yè)務(wù)參數(shù)配置頁面，該頁面就是由調(diào)度任務(wù)參數(shù)視圖進(jìn)行配置的。調(diào)度界面配置調(diào)度界面配置配置完成后，保存數(shù)據(jù)，任務(wù)狀態(tài)默認(rèn)是可用的。調(diào)度界面配置調(diào)度界面配置運行和觸發(fā)啟動后點擊觸發(fā)按鈕，進(jìn)入調(diào)度任務(wù)排隊等待，根據(jù)時間先后順序執(zhí)行。運行和觸發(fā)的區(qū)別：運行：表示立即執(zhí)行，在本地環(huán)境運行調(diào)度，在開發(fā)時可通過這個按鈕進(jìn)行調(diào)試調(diào)度任務(wù)。觸發(fā)：進(jìn)入排隊等待，在調(diào)度服務(wù)運行，由調(diào)度器執(zhí)行。觸發(fā)依賴于調(diào)度服務(wù)，本地調(diào)試配置了cron表達(dá)式，點擊觸發(fā)，也不會定時去執(zhí)行調(diào)度任務(wù)；在調(diào)度服務(wù)執(zhí)行調(diào)度任務(wù)時，任務(wù)狀態(tài)必須是啟用的才會進(jìn)行排隊等待執(zhí)行。思考題調(diào)度任務(wù)配置為每天的16點執(zhí)行，該如何配置？03調(diào)度功能開發(fā)示例調(diào)度功能開發(fā)示例需求描述需求描述：開發(fā)一個調(diào)度任務(wù)，根據(jù)類別名稱、狀態(tài)來統(tǒng)計讀者數(shù)量（類別名稱和狀態(tài)作為參數(shù)傳入）。思考題上頁PPT中，要實現(xiàn)需求描述的要求的調(diào)度任務(wù)，至少需要開發(fā)幾個類？調(diào)度功能開發(fā)示例開發(fā)步驟開發(fā)調(diào)度參數(shù)類，命名以JobParameter結(jié)尾，標(biāo)記特性根實體和序列化[RootEntity,Serializable]，繼承JobParameter，通過代碼段添加屬性。調(diào)度功能開發(fā)示例開發(fā)步驟調(diào)度參數(shù)界面配置：跟普通實體視圖配置一樣，需繼承WebViewConfig<T>，調(diào)度參數(shù)設(shè)置中彈出的是表單頁面，所以調(diào)用的是ConfigDetailsView視圖，相關(guān)字段在ConfigDetailsView設(shè)置即可。調(diào)度功能開發(fā)示例開發(fā)步驟調(diào)度任務(wù)類的開發(fā)：命名以Job結(jié)尾，繼承JobBase，標(biāo)記特性[Job(“統(tǒng)計讀者數(shù)量”,typeof(ReaderJobParameter))]，實現(xiàn)調(diào)度任務(wù)執(zhí)行方法ExecuteJob。調(diào)度功能開發(fā)示例調(diào)度任務(wù)類說明[Job("統(tǒng)計讀者數(shù)量",typeof(ReaderJobParameter))]所有的調(diào)度任務(wù)類，都需要標(biāo)記Job標(biāo)簽，用于告訴系統(tǒng)當(dāng)前的類是一個調(diào)度任務(wù)類，在“調(diào)度任務(wù)設(shè)置”中識別并添加到調(diào)度任務(wù)中。JobBase所有的調(diào)度任務(wù)的類，都需要繼承JobBase類，只有繼承了JobBase，才提供相關(guān)調(diào)度任務(wù)的相關(guān)標(biāo)準(zhǔn)方法。ExecuteJob繼承了JobBase的類，需要實現(xiàn)ExecuteJob方法，調(diào)度器在執(zhí)行調(diào)度任務(wù)時，會自動調(diào)用調(diào)度任務(wù)類的ExecuteJob方法，就是說系統(tǒng)在定時執(zhí)行這個方法。在執(zhí)行ExecuteJob方法時，會將“調(diào)度任務(wù)設(shè)置”中設(shè)置的參數(shù)傳給ExecuteJob的param參數(shù)。調(diào)度功能開發(fā)示例調(diào)度任務(wù)類說明AddLog調(diào)度任務(wù)在執(zhí)行過程中，可以將相關(guān)的日志信息寫入到數(shù)據(jù)庫中，同時會在“調(diào)度任務(wù)設(shè)置”功能中看到。需要注意的是，調(diào)度任務(wù)中執(zhí)行一次任務(wù)，就算寫多個日志信息，都會合并成一個，并不會出現(xiàn)多條記錄。ReaderJobParameter（JobParameter）ReaderJobParameter是自己定義的參數(shù)實體，用于提供當(dāng)前調(diào)度任務(wù)類可以要接收的自定義業(yè)務(wù)參數(shù)，如果調(diào)度任務(wù)類不需要設(shè)定任何業(yè)務(wù)參數(shù)，則默認(rèn)為JobParameter即可，即typeof(JobParameter)。調(diào)度功能開發(fā)示例開發(fā)步驟完成后，運行項目，在“調(diào)度任務(wù)設(shè)置”功能中，點擊添加，任務(wù)就會添加進(jìn)來了，就可以進(jìn)行任務(wù)的配置了。04常見異常問題列舉常見異常問題常見異常問題調(diào)度平臺執(zhí)行升級數(shù)據(jù)庫操作升級表失敗。問題描述：調(diào)度平臺相關(guān)dll都依賴進(jìn)來了，也配置了調(diào)度的數(shù)據(jù)庫連接字符串且正確，但是執(zhí)行升級數(shù)據(jù)庫操作生成調(diào)度平臺表時，生成表失敗。原因：調(diào)度平臺如果是使用的sqlserver數(shù)據(jù)庫，使用平臺的升級數(shù)據(jù)庫操作可以正常生成調(diào)度平臺的表；如果使用的是oracle數(shù)據(jù)庫，使用平臺的升級數(shù)據(jù)庫操作無法生成調(diào)度平臺的表。解決方案：平臺使用的是oracle的數(shù)據(jù)庫，則通過腳本生成調(diào)度相關(guān)表，腳本如下。常見異常問題常見異常問題調(diào)度任務(wù)需要先禁用再刪除，否則刪除后調(diào)度還會在hangfire運行。如果刪除后調(diào)度還在運行，可以在調(diào)度的控制臺Recurringjobs頁簽進(jìn)行刪除。常見異常問題常見異常問題部署的調(diào)度任務(wù)不執(zhí)行。問題描述：部署后調(diào)度任務(wù)不執(zhí)行，對應(yīng)場景：調(diào)度測試環(huán)境（windows環(huán)境）執(zhí)行成功，但正式環(huán)境（linux+docker）不執(zhí)行。解決方案：打開調(diào)度控制臺檢查linux環(huán)境是否時區(qū)正確，兩個系統(tǒng)的環(huán)境的時區(qū)標(biāo)識是不是樣的。常見異常問題常見異常問題下面第1個圖是windows環(huán)境，第2個圖是linux環(huán)境。常見異常問題常見異常問題某個調(diào)度任務(wù)執(zhí)行失敗。問題描述：其他調(diào)度任務(wù)都正常，某個調(diào)度任務(wù)執(zhí)行不了或者失敗，失敗如下圖。原因：調(diào)度服務(wù)沒有發(fā)布，只發(fā)布了Host和BS。解決方案：調(diào)度服務(wù)、Host和BS同時發(fā)布。練習(xí)1、工業(yè)軟件開發(fā)中，開發(fā)調(diào)度功能，調(diào)用任務(wù)是以Job結(jié)尾，繼承JobBase類及子類嗎?（）2、工業(yè)軟件開發(fā)中，調(diào)度任務(wù)需要配置參數(shù)是需要繼承JobParameter類嗎?（）3、

工業(yè)軟件開發(fā)中，調(diào)用任務(wù)如果定義了參數(shù)類并繼承了JobParameter類