HEC工作流設(shè)計說明及開發(fā)指南

1、 Hand Enterprise SolutionsWorkflow設(shè)計說明及開發(fā)指南作者:Lei.Zhang建檔日期:December 19, 2009上次更新:控制號: 版本: 1 .0Note: Control Number and Version are marked by a Word Bookmark so that they can be easily reproduced in the header and footer of documents. When you change either of these values, be careful not to acciden

2、tally delete the bookmark. You can make bookmarks visible by selecting Tools-Options匳iew and checking the Bookmarks option in the Show region.審批:Project Manager拷貝號_文檔控制記錄更改日期作者版本文檔狀態(tài)更改參考2009-12-19Lei.Zhang1.0Draft1.0創(chuàng)建2010-1-27Lei.zhang1.1更新2010-2-3Lei.zhang1.2更新審閱人姓名職位分發(fā)拷貝號姓名職位1234Note: The copy nu

3、mbers referenced above should be written into the Copy Number space on the cover of each distributed copy. If the document is not controlled, you can delete this table and the Copy Number label from the cover page.(9-Dec-96)文檔目錄文檔控制ii文檔內(nèi)容1數(shù)據(jù)結(jié)構(gòu)2工作流定義2工作流實例5數(shù)據(jù)字典8如何新增加一個工作流類型9工作流類型SYSCODE9工作流與業(yè)務(wù)單據(jù)表對應(yīng)關(guān)系

4、9審批規(guī)則和審批頁面10系統(tǒng)預(yù)設(shè)的審批規(guī)則10新增加審批規(guī)則10審批頁面和審批記錄11轉(zhuǎn)交和通知11手工添加審批人13工作流過程15節(jié)點校驗的過程15節(jié)點前處理的過程15節(jié)點后處理的過程16完成時執(zhí)行的過程16工作流事件17工作流事件的作用17常用的工作流事件18工作流日志20郵件提醒21消息接收者類型維護(hù)21事件消息模板維護(hù)21事件定義22JOB定義23后臺監(jiān)控23 (9-Dec-96)24Company Confidential - For internal use only文檔內(nèi)容1. 數(shù)據(jù)結(jié)構(gòu)2. 如何新增加一個工作流類型3. 審批規(guī)則和審批頁面4. 工作流過程5. 工作流事件6. 工

5、作流日志7. 郵件提醒數(shù)據(jù)結(jié)構(gòu)分兩個方面來講述：工作流定義 ， 工作流實例 工作流定義l 工作流定義WFL_WORKFLOW定義工作流主體，包括：工作流代碼，名稱，類型，狀態(tài)，可回收標(biāo)志，完成時執(zhí)行的過程。其中完成時執(zhí)行的過程需要預(yù)先定義對應(yīng)過程類型的工作流過程。l 節(jié)點定義WFL_WORKFLOW_NODE為工作流添加審批節(jié)點，設(shè)置節(jié)點審批屬性。以下介紹各個屬性的含義：字段說明節(jié)點名稱節(jié)點名稱序列號節(jié)點順序號，工作流將用此序號由小到大進(jìn)行流轉(zhuǎn)接收類型正常處理該節(jié)點按照標(biāo)準(zhǔn)邏輯運行直接通過運行到該節(jié)點直接跳過流程結(jié)束(通過)運行到該節(jié)點，設(shè)置工作流結(jié)束（審批通過）流程結(jié)束(不通過)運行到該節(jié)點

6、，設(shè)置工作流結(jié)束（審批拒絕）表單名稱審批頁面中嵌入的單據(jù)明細(xì)service名表單高度審批頁面中嵌入的單據(jù)明細(xì)框的高度表單寬度審批頁面中嵌入的單據(jù)明細(xì)框的寬度節(jié)點前處理的過程可以選擇該工作流預(yù)定義的類型為節(jié)點前處理的存儲過程，用于個性化處理是否可以轉(zhuǎn)交設(shè)置該節(jié)點是否允許轉(zhuǎn)交提交人不需要審批當(dāng)選中該選項，則提交人不需要審批校驗的存儲過程可以選擇該工作流定義的類型為節(jié)點校驗過程的存儲過程，在點擊審批按鈕時觸發(fā)，用于個性化處理結(jié)束時通知處理者當(dāng)選中該選項，節(jié)點完成時，會通知節(jié)點中所有的處理人審批意見查看限制當(dāng)選中該選項，此節(jié)點的審批記錄查看受限審批類型任一人只要有一人審批通過，則節(jié)點通過全部審批全部審

7、批人審批通過，則節(jié)點通過，任一人拒絕，則節(jié)點拒絕。一定比例的人數(shù)一定比例人數(shù)審批通過，則節(jié)點通過。一定比例的規(guī)則一定比例的審批規(guī)則通過，則節(jié)點通過一定人數(shù)一定的審批人審批通過，則節(jié)點通過一定規(guī)則一定的審批規(guī)則審批通過，則節(jié)點通過一票通過/一票否決（規(guī)則）第一個審批規(guī)則審批通過則節(jié)點通過；第一個審批規(guī)則審批拒絕，則節(jié)點拒絕。一票通過/一票否決第一個審批人審批通過，則節(jié)點通過；第一個審批人審批拒絕，則節(jié)點拒絕數(shù)值配合以上類型：一定比例人數(shù)/一定比例的規(guī)則？一定人數(shù)/一定規(guī)則郵件提醒通知是否發(fā)送郵件日期限制待辦事項的處理日期控制提醒周期提醒周期無需重復(fù)審批相同審批人第二次需要審批時，系統(tǒng)自動審批通過

8、節(jié)點允許無審批人當(dāng)選中該選項，當(dāng)此節(jié)點沒有審批人時，跳過到下一個節(jié)點。當(dāng)沒有選中，當(dāng)節(jié)點沒有審批人時，工作流報錯。允許添加審批人設(shè)置該節(jié)點是否允許審批人再手工添加其他審批人。允許添加通知人設(shè)置該節(jié)點是否允許再手工添加其他被通知人描述節(jié)點備注字段l 工作流動作WFL_WORKFLOW_ACTION設(shè)置審批動作，分三個類型：繼續(xù)，終止，退回到指定節(jié)點。并能設(shè)置各個動作在頁面顯示時的標(biāo)題字。定義完畢后，必須將動作再分配到節(jié)點動作中，才能在對應(yīng)的節(jié)點審批頁面中顯示該審批動作按鈕。l 工作流過程WFL_WORKFLOW_PROCEDURE工作流自定義過程可以完成標(biāo)準(zhǔn)工作流無法完成的個性化處理。后文有詳細(xì)

9、介紹。l 審批者定義WFL_NODE_RECIPIENT_SET為工作流節(jié)點定義審批人。系統(tǒng)支持3個級別的審批人定義，系統(tǒng)級，工作流級，節(jié)點級。此處只說明節(jié)點級的審批人定義。另外2個級暫時無法在前臺頁面中定義。后文有詳細(xì)介紹審批規(guī)則及審批人。l 節(jié)點動作WFL_WORKFLOW_NODE_ACTION在前面工作流上定義的動作，必須在節(jié)點中引用，才能在該節(jié)點審批頁面中出現(xiàn)。工作流實例l 工作流啟動啟動工作流對應(yīng)的程序 ： Wfl_core_pkg.workflow_start程序類型函數(shù)( function) 返回工作流實例ID參數(shù)1P_transaction_category 工作流單據(jù)類型參

10、數(shù)2P_transaction_type_id 工作流單據(jù)類型ID參數(shù)3P_instance_param 工作流單據(jù)主鍵ID參數(shù)4P_user_id 操作用戶ID參數(shù)p_transaction_category 取值來源為系統(tǒng)代碼WFL_WORKFLOW_CATEGORY的值l 工作流實例WFL_WORKFLOW_INSTANCE工作流每一次提交后，創(chuàng)建唯一的工作流實例，記錄該工作流ID，當(dāng)前節(jié)點，狀態(tài)，來源單據(jù)ID等信息。工作流狀態(tài)分為:0初始化1正在運行10結(jié)束（審批通過）-1結(jié)束（審批拒絕）-2結(jié)束（退回）-100出錯l 實例審批規(guī)則WFL_INSTANCE_NODE_RULE當(dāng)工作流流

11、轉(zhuǎn)到一個節(jié)點時，獲取預(yù)先定義的審批人規(guī)則，插入此表記錄。各字段說明：RULE_RECORD_ID審批規(guī)則記錄ID(主鍵)INSTANCE_ID工作流實例IDNODE_ID節(jié)點IDRECIPIENT_TYPE審批人規(guī)則來源的級別： SYSTEM，WORKFLOW，NODERECIPIENT_SET_ID審批人規(guī)則來源IDRULE_CODE審批規(guī)則代碼RULE_TYPE審批規(guī)則類型RULE_SEQUENCE審批規(guī)則序號RECIPIENT_SEQUENCE審批人審批順序號PARAMETER_1_VALUE參數(shù)1值 與審批規(guī)則上的參數(shù)1對應(yīng)，記錄審批規(guī)則參數(shù)1的實際值PARAMETER_2_VALUE

12、參數(shù)2值 與審批規(guī)則上的參數(shù)2對應(yīng)，記錄審批規(guī)則參數(shù)2的實際值PARAMETER_3_VALUE參數(shù)3值 與審批規(guī)則上的參數(shù)3對應(yīng)，記錄審批規(guī)則參數(shù)3的實際值PARAMETER_4_VALUE參數(shù)4值 與審批規(guī)則上的參數(shù)4對應(yīng)，記錄審批規(guī)則參數(shù)4的實際值l 實例審批層次WFL_INSTANCE_NODE_HIERACHY對實例審批規(guī)則每一條記錄進(jìn)行分析，調(diào)用每一個審批規(guī)則對應(yīng)的審批人獲取過程，創(chuàng)建該規(guī)則對應(yīng)的審批層次記錄。各字段說明：HIERACHY_RECORD_ID審批層次記錄ID（主鍵）RULE_RECORD_ID審批規(guī)則記錄ID，記錄來源于哪一行審批規(guī)則記錄RULE_DETAIL_ID

13、審批規(guī)則明細(xì)ID，記錄來源規(guī)則明細(xì)的記錄ID（當(dāng)規(guī)則是業(yè)務(wù)規(guī)則時，該字段記錄業(yè)務(wù)規(guī)則ID）INSTANCE_ID工作流實例IDNODE_ID節(jié)點IDSEQ_NUMBER審批順序號APPROVER_ID審批人用戶IDPOSTED_FLAG該記錄是否已發(fā)送待辦事項標(biāo)志，已發(fā)送記錄為YDISABLED_FLAG該記錄是否已失效標(biāo)志（各種情況下會造成原審批人無需再審批的情況，則設(shè)置該標(biāo)志為Y）NOTE備注發(fā)送待辦事項：根據(jù)RULE_RECORD_ID,RULE_DETAIL_ID分組（審批規(guī)則分組），每個審批規(guī)則中找POSTED_FLAG為N，DISABLED_FLAG為N，SEQ_NUMBER最小的

14、記錄，將該APPROVER_ID插入待辦事項表，并設(shè)置POSTED_FLAG為Yl 待辦事項WFL_INSTANCE_NODE_RECIPIENT用戶直接看到的待辦事項對應(yīng)的表。用戶可以在首頁或者待辦事項中看到待審批記錄。用戶審批結(jié)束后，將備份該記錄，并刪除當(dāng)前待辦事項各字段說明：RECORD_ID待辦事項記錄ID（主鍵）HIERACHY_RECORD_ID審批層次記錄ID，記錄來源于哪一行審計層級記錄INSTANCE_ID工作流實例IDNODE_ID節(jié)點IDUSER_ID審批人用戶IDSEQ_NUMBER審批順序號COMMISION_BY轉(zhuǎn)交人用戶IDCOMMISION_DESC轉(zhuǎn)交人用戶D

15、ATE_LIMIT處理時限l 審批記錄WFL_APPROVE_RECORD顧名思義就是記錄審批的表。各字段說明：RECORD_ID審批記錄ID（主鍵）RCPT_RECORD_ID待辦事項記錄ID，記錄來源于哪一行待辦事項記錄INSTANCE_ID工作流實例IDNODE_ID節(jié)點IDSEQ_NUMBER審批順序號ACTION_TAKEN審批動作IDCOMMENT_TEXT審批意見APPROVE_COUNT審批輪次DISANBLED_FLAG審批記錄失效標(biāo)志（某種情況下，可能造成之前的審批記錄無效，如工作流向前跳轉(zhuǎn)）NOTE備注審批記錄的重要性：審批記錄是判斷節(jié)點審批類型中是否審批通過的重要依據(jù)。

16、l 通知記錄WFL_NOTIFICATION_RECORD顧名思義就是記錄通知的表各字段說明RECORD_ID通知記錄ID（主鍵）INSTANCE_ID工作流實例IDNODE_ID節(jié)點IDUSER_ID被通知人用戶IDSTATUS0，未被通知人確認(rèn)； 1，被被通知人確認(rèn)RECORD_TYPE0，用戶手工添加通知人發(fā)送的通知； 1，系統(tǒng)發(fā)送的通知SOURCE_USER_ID通知來源人用戶IDNOTE備注審批記錄和通知記錄都會在工作流審批歷史中顯示。以上 實例審批規(guī)則，實例審批層次，待辦事項 三張表是鏈形的存在關(guān)系待辦事項記錄唯一來源于實例審批層次表，實例審批層次記錄唯一來源于實例審批規(guī)則表。并且

17、三張表只記錄工作流實例當(dāng)前節(jié)點的記錄，當(dāng)節(jié)點通過后，將所有記錄備份（原表名后加_HT后綴的表），并按照新節(jié)點重新計算數(shù)據(jù)。數(shù)據(jù)字典表 說明：字段 說明：關(guān)系說明：如何新增加一個工作流類型工作流類型SYSCODE系統(tǒng)代碼WFL_WORKFLOW_CATEGORY記錄系統(tǒng)中已有的工作流類型的種類，如果需要增加新類型，必須在該系統(tǒng)代碼內(nèi)新增加代碼值創(chuàng)建工作流類型SYSCODE的腳本為：INITIALIZE_SEEDDATA_WFL_WORKFLOW_CATEGORY.sql工作流與業(yè)務(wù)單據(jù)表對應(yīng)關(guān)系系統(tǒng)中每個工作流必須指定一個工作流的類型，每一種類型都必須說明這種類型工作流對應(yīng)的單據(jù)的關(guān)聯(lián)關(guān)系。工作

18、流模塊獲取其他業(yè)務(wù)模塊數(shù)據(jù)關(guān)系說明表：WFL_DOCUMENT_REFERENCE字段說明：字段說明Workflow_category工作流類型代碼Document_desc對應(yīng)單據(jù)說明Document_table_desc對應(yīng)單據(jù)的表名Ref_id_column_name對應(yīng)單據(jù)表與工作流實例的關(guān)聯(lián)idRef_num_column_name對應(yīng)單據(jù)表的文檔編號字段Ref_company_column_name對應(yīng)單據(jù)表的公司id字段Ref_created_column_name對應(yīng)單據(jù)表的創(chuàng)建者id字段Ref_detail對應(yīng)單據(jù)表的詳細(xì)信息sql取數(shù)，可用作獲取單據(jù)其他字段值用該表記錄初始

19、化腳本為：INITIALIZE_SEEDDATA_WFL_DOCUMENT_REFERENCE.sql審批規(guī)則和審批頁面系統(tǒng)預(yù)設(shè)的審批規(guī)則序號規(guī)則名稱說明對應(yīng)程序名1根據(jù)存儲過程獲取通過自定義過程來取審批人wfl_common_pkg.get_approver_by_procedure2申請者上級申請者員工崗位對應(yīng)的上級崗位wfl_common_pkg.get_employee_manager3申請者部門主管申請者員工部門主管wfl_common_pkg.get_employee_unit_manager4申請者自己申請者自己wfl_common_pkg.get_employee5間接主管暫時

20、不能使用wfl_common_pkg.get_employee_indirect_manager6指定人員wfl_employee_lov.service指定人員wfl_common_pkg.get_appointed_employee7指定崗位wfl_position_lov.service 指定崗位wfl_common_pkg.get_appointed_position8指定職務(wù)wfl_job_lov.service 指定職務(wù)wfl_common_pkg.get_appointed_virtual_position9申請者公司主管申請者公司主管wfl_common_pkg.get_emp

21、loyee_company_manager10申請者上級公司主管申請者上級公司主管wfl_common_pkg.get_parent_company_manager11申請者上級部門主管申請者上級部門主管wfl_common_pkg.get_parent_unit_manager12業(yè)務(wù)規(guī)則通過EXP1900業(yè)務(wù)規(guī)則定義來獲取審批人exp_wf_approval_rule_pkg.get_next_node_approver以上數(shù)據(jù)存在表 wfl_recipient_rule使用wfl_recipient_rule_pkg.load_wfl_recipient_rule存儲過程導(dǎo)入數(shù)據(jù)對應(yīng)腳本

22、文件名INITIALIZE_SEEDDATA_WFL_RECIPIENT_RULE.sql新增加審批規(guī)則1. 創(chuàng)建審批規(guī)則定義審批規(guī)則定義表 ： wfl_recipient_rules 各字段說明：字段名說明Rule_code規(guī)則代碼Rule_type規(guī)則類型（請插入RECIPIENT_RULE）Procedure_name該規(guī)則對應(yīng)的獲取審批的存儲過程，如果是新建規(guī)則，則需要添加對應(yīng)的審批規(guī)則存儲過程。Parameter_1_type參數(shù)1 類型。3種：空；INPUT,輸入型；SELECT,lov選擇型Parameter_1_desc參數(shù)1 說明Parameter_1_url當(dāng)參數(shù)是SELE

23、CT時候，指定一個lov的service文件Sys_flag是否系統(tǒng)預(yù)裝入可以使用INITIALIZE_SEEDDATA_WFL_RECIPIENT_RULE.sql腳本修改創(chuàng)建你所需要的規(guī)則。2. 編寫自定義審批規(guī)則獲取審批人的存儲過程審批人獲取存儲過程，可以通過需要，自己插入對應(yīng)規(guī)則需要出現(xiàn)的審批人。存儲過程的格式必須滿足一下條件：過程類型存儲過程 (procedure)參數(shù)1P_parameter_1 對應(yīng)規(guī)則定義中參數(shù)1的值參數(shù)2P_parameter_2 對應(yīng)規(guī)則定義中參數(shù)2的值參數(shù)3P_parameter_3 對應(yīng)規(guī)則定義中參數(shù)3的值參數(shù)4P_parameter_4 對應(yīng)規(guī)則定義中

24、參數(shù)4的值參數(shù)5P_rule_record_id 工作流實例審批規(guī)則id，可以通過此id或者當(dāng)前工作流實例的所有信息，比如workflow_id,node_id等。使用標(biāo)準(zhǔn)接口 wfl_core_pkg.insert_wfl_instance_node_hirc 插入你需要的審批人可以參考之前列出的標(biāo)準(zhǔn)審批規(guī)則對應(yīng)的存儲過程。審批頁面和審批記錄1. 審批頁面系統(tǒng)可以在每個節(jié)點設(shè)置一個審批的顯示頁面(定義service文件)，可以用來顯示業(yè)務(wù)數(shù)據(jù)上圖是節(jié)點維護(hù)中定義審批頁面的選項。其中表單名稱下拉框中的數(shù)據(jù)來源于表wfl_workflow_page系統(tǒng)預(yù)設(shè)了費用申請單，費用報銷單，借款申請單 3

25、中不同的審批頁面。如需要添加，可以參考導(dǎo)入腳本 INITIALIZE_SEEDDATA_WORKFLOW_PAGE.sql2. 審批記錄審批記錄表 wfl_approve_record 記錄了所有審批記錄數(shù)據(jù),每一個待辦事項記錄會產(chǎn)生唯一對應(yīng)的審批記錄。也有可能存在待辦事項沒有審批記錄的情況。轉(zhuǎn)交和通知1. 轉(zhuǎn)交WFL2110工作流轉(zhuǎn)交設(shè)置，可以分工作流，事件范圍設(shè)置審批時的自動轉(zhuǎn)交人。 另外，當(dāng)待辦事項已經(jīng)到達(dá)審批人時，也可是再次將本次審批權(quán)限轉(zhuǎn)交給其他人。前提是工作流節(jié)點定義中，選中 2. 通知系統(tǒng)首頁中，為了顯示待辦事項外，還有一種數(shù)據(jù)類型的顯示：通知通知和待辦事項的區(qū)別：通知只能查看工

26、作流的狀態(tài)，審批情況等信息，但是不能對工作流做審批處理。收到工作流通知的用戶可以再次發(fā)通知給其他用戶。前提是在節(jié)點定義中選中系統(tǒng)能夠預(yù)設(shè)2種類型的通知：節(jié)點結(jié)束時的通知和節(jié)點結(jié)束時的通知。分別在工作流維護(hù)和節(jié)點維護(hù)中定義。通知規(guī)則類似于審批規(guī)則，通過預(yù)定義的存儲過程尋找被通知人。手工添加審批人系統(tǒng)支持在工作流運行過程中，有用戶自己添加審批人。需要在工作流節(jié)點維護(hù)中選中在審批頁面會出現(xiàn)添加審批人的標(biāo)簽頁選擇審批鏈：可以選擇EXP1900業(yè)務(wù)規(guī)則定義中已定義規(guī)則，點擊新增審批鏈將該規(guī)則下的審批人做為新添加的審批人放入下面的列表，用戶可以再手工修改。列表中也可以單獨添加員工做為審批人。審批優(yōu)先級：1

27、) 新審批鏈將選擇的審批人添加到一條新的審批鏈2) 之前將選擇的審批人添加到當(dāng)前審批人之前審批，暫時取消當(dāng)前待辦記錄3) 之后將選擇的審批人添加到當(dāng)前審批人之后審批4) 平行將選擇的審批人添加到為當(dāng)前審批人相同的審批順序，同時要求其審批確定： 將下面列表中已確定的員工做為添加的審批人加入到審批列表中。工作流過程工作流維護(hù)界面 - 工作流過程設(shè)置工作流自定義過程必須遵守預(yù)定的規(guī)則，比如參數(shù)個數(shù)，返回值等。節(jié)點校驗的過程點擊審批按鈕時執(zhí)行的過程，可以用來設(shè)置審批權(quán)限。過程類型函數(shù) (function)返回值類型數(shù)字型 (Number)參數(shù)1P_rcpt_record_id 待辦事項記錄id參數(shù)2P

28、_action_id 按鈕動作id函數(shù)返回如果為0 ，則規(guī)則驗證通過。否則系統(tǒng)報錯：審批權(quán)限檢查不通過，不能審批！節(jié)點前處理的過程到達(dá)節(jié)點接收者（審批人）之前執(zhí)行的過程。過程類型函數(shù) (function)返回值類型數(shù)字型 (Number)參數(shù)1P_instance_id 工作流實例id參數(shù)2P_rcpt_record_id待辦事項記錄id函數(shù)返回如果為1，則正常處理。否則，系統(tǒng)認(rèn)為當(dāng)前待辦事項自動審批通過節(jié)點后處理的過程節(jié)點全部結(jié)束后執(zhí)行的過程，可以用來判斷自定義函數(shù)，并跳轉(zhuǎn)工作流。過程類型函數(shù) (function)返回值類型字符 (varchar2)參數(shù)1P_instance_id 工作流實

29、例id參數(shù)2P_node_id 工作流節(jié)點id參數(shù)3P_result 留空函數(shù)返回一個字符，系統(tǒng)將此字符與節(jié)點后定義的判斷做比較，設(shè)置工作流節(jié)點如果處理。完成時執(zhí)行的過程工作流結(jié)束時執(zhí)行的過程，用來處理單據(jù)狀態(tài)。過程類型存儲過程 (procedure)參數(shù)1P_instance_id 工作流實例id參數(shù)2P_status 工作流結(jié)束時的狀態(tài)參數(shù)3P_user_id 操作用戶id自定義過程中按照不同的工作流實例狀態(tài)，分別修改對應(yīng)的單據(jù)狀態(tài)。系統(tǒng)已預(yù)設(shè)的完成時執(zhí)行的過程：費用申請單Exp_requisition_pkg.update_reports_post_workflow報銷單Exp_report_pkg.update_reports_post_wrokflow借款申請單Csh_payment_requisition_pkg.update_reports_post_workflow工作流事件系統(tǒng)預(yù)設(shè)工作流事件可以通過EVT2010查詢到：工作流事件的作用當(dāng)需要在某些時候?qū)Τ绦蜻壿嬜鎏厥馓幚淼臅r候，系統(tǒng)在多個時點預(yù)設(shè)了工作流事件，程序員可以通過新增加二開程序，在適當(dāng)時機對應(yīng)的工作流事件中調(diào)用二開程序來滿足對特殊業(yè)務(wù)的需求。例：待辦事項的