【正文】 通過 BL_finishActivityByDefID 結束活動的方式結束工作項 在現(xiàn)有工作流工作項結束調用中一般都會采用 BL_finishWorkItem這個運算邏輯調用，但是也有情況可以通過 BL_finishActivityByDefID 來結束活動的方式結束工作項。這些工作項的擁有者此時無論 是否處理它們，已不會對運行的流程造成任何影響，只有當流程實例結束時，引擎才會將這些工作項終止 活動項與 工作項 活動項和工作項是一對多的關系， 人工活動被激活后，形成活動項實例繼而有生成工作項實例，供參與者操作。 未完成工作項自動終止 1） 選擇 “ 是 ” ： 工作流引擎在結束活動實例的同時對于那些剩余的未完成的工作項作 “ 停止 ” 處理 。 例如，上面的例子若按此策略將產(chǎn)生 6 個工作項， tiger、 fish、 goose、 kitty、snoppy， micky 每人分配一個工作項，直接執(zhí)行。具體分配為： tiger 一個工作項，由其直接執(zhí)行 (該參與者只有一個人所以無需先領取 )；角色 B一個工作項，由 fish 或 goose 中的一個人以領取的方式執(zhí)行；同理，機構 A一個工作項，由 kitty、 snoppy 或 micky 中的一個人以領取的方式執(zhí)行 。每個參與者一個工作項，若參與者中包括若干人員（比如參與者的類型為機構 或角色），則這些人員可通過先 “ 領取 ” 的方式執(zhí)行工作項。如果設置了超時提醒，該字段可能出現(xiàn)負數(shù)，是未超時的表現(xiàn)，只有正數(shù)才表示超時的時間，timeOutNumDesc 是其描述字段。 EOS WORKFLOW 判斷流程或人工活動超時的原理 流程或人工活動的時間限制中設置的限制時間將寫入表 WFProcessInst 或WFWorkItem 的 limitNum 字段中，單位為毫秒， limitNumDesc 是其描述字段；finalTime 是時間限制到達后的時間。 活動時間限制的設置：開發(fā)人員可以根據(jù)業(yè)務需要在 “ 人工活動 ” 和 “ 子流程活動 ” 中進行設置。 時間限制 活動的時間限制表示活動實例啟動啟動后必須在多長時間內完成。 當工作項被領取以后，就會在工作項表WFWorkItem 表里出現(xiàn)具體的執(zhí)行人信息。這個字段描述該工作項的參與者具體是誰。 工作流 參與者設置機制說明 流程實例根據(jù)流轉條件依次激活實例中的相應的活動，當活動分配給某個參與者（唯一的 userID）的時候，就在 WFWorkItem 表中形成一條工作項記錄，主鍵為 workItemID。 /Condition 此外，還有 一種方法設置一組機構：把多個機構寫成如下格式： list id1/id / id2/id / /list 這樣機構變量路徑 xpath 寫成： list//id 即可。 在上面 XPATH 結構中如 果 type 是 “ person”， 那么 id 即為用戶 ID； 如果 type是 “ role”，那么 id 即為角色 ID；如果 type 是 “ anization”，那么 id即為機構 ID； 如果 type 是 “ position”，那么 id 即為崗位 ID； 如果 type是 “ position_list”，那么 id 即 需滿足如下格式： Condition type=OR // type=”O(jiān)R” 表示組織機構 roleIDrolea/roleID // 角色 ID ID$ID/ID // 獲取機構 ID 的 XPATH（相對于相關數(shù)據(jù)的根路徑）。格式如下所示： Participant id/id name/name type/type /Participant id 和 type 的含義同上。從業(yè)務邏輯返回 Dom 當中找到參與者列表的方法： 1） 如果返回的結果中包括下面的結構，系統(tǒng)從 list 節(jié)點中獲取多個參與者。這樣，工作流引擎也會找到多個機構 id，從而實現(xiàn)設置一組機構 +角色的要求。 ”$”不可少，標識其后的串是個 XPATH。相關數(shù)據(jù)必須滿足下面的結構。 XXXX id/ name/ type/ /XXXX 3）從相關數(shù)據(jù)獲得一系列參與者 【算法說明】 從相關數(shù)據(jù)的 XPATH 中，獲得一組參與者?？梢允且粋€人，也可以是某一角色或某一機構的一組人。 相關數(shù)據(jù)必須滿足下面的結構。 如下 圖所示： 圖 設置一組機構變量 從相關數(shù)據(jù)區(qū)設置 參與 者 1）從相關數(shù)據(jù)獲得一個具體的參與者 【算法說明】 從相關數(shù)據(jù)的 XPATH 中，直接指定一個參與者。 此外，還有 一種方法設置一組機構：把多個機構 寫成 如下格式 ： list id1/id / id2/id / /list 這樣機構變量路徑 xpath 寫成： list//id 即可。由相關數(shù)據(jù)獲取參與者的規(guī)則詳見 從相關數(shù)據(jù)獲取參與者 從規(guī)則邏輯獲取 ：表示活動參與者由某個規(guī)則邏輯的返回值 確定。 EOS WorkFlow 提供了 4 種可以獲取參與者的方式： 組織機構與角色 ：參與者由開發(fā)人員從機構樹中獲取 – 只選擇一人：表示該活動所對應的工作項直接分配給該人處理 – – 超過一人：表示該活動所對應的工作項由這些人中的某個人以 “ 領取 ”的方式處理 虛擬崗位（機構 +角色） ：表示 在不設置崗位的情況下，由部門 +角色共同決定一個人工活動的參與者。 參與者設置 活動參與者實際上是指在流程實例運行過程中，流程實例 “ 流轉 ” 至此時該活動實例所對應的工作項有哪些人可以執(zhí)行。 3) 由該活動射出的連線上沒有一個滿足條件時 ［圖 “單一分支”型分支模式 3］ 如上圖所示，由于“ A” 活動的分支模式是“單一分支”并且在處理的過程中“ num==2”，那么由“ A”射出的連接線上沒有滿足條件的，因此“ D”活動被缺省觸發(fā)。 2. “單一分支”型分支模式示例 1) 由該活動射出的連線上只有一個滿足條件時 ［圖 “單一分支”型分支模式 1］ 如圖所示，由于“ A” 活動的分支模式是“單一分支”并且在處理的過程中“ num==6”，所以由“ A”射出的連接線上只有“ num 5”滿足條件，因此“ B”活動滿足條件被觸發(fā)。 3) 多路 分支 還需要特別說明的是：多路 分支 不一定要設置默認連線，也就是說一個多路 分支 的全部連線都可以設置條件。 3．“多路分支”型分支模式 如果該活動的分支模式為“多路分支”，那么引擎會根 據(jù)由該活動“射出”的連接線上的條件進行判斷，決定觸發(fā)哪個或哪些后繼活動。具體分為下面三種情況： 1) 滿足條件的連接線所指的活動被觸發(fā)； 2) 如果有若干個連接線上的條件都滿足，那么比較連接線上的優(yōu)先級，優(yōu)先級高的那條連接線所指的活動將被觸發(fā)； 3) 如果連接線上的條件都不滿足，那么取“默認值”的那條連接線所指的活動將被觸發(fā)。它包括“全部分支（ AND）”、“單一分支（ XOR）”以及“多路分支 (OR)”三種情況： 1. “全部分支”型分支模式 表示該活動結束后它的所有后繼活動將同時被觸發(fā)。 2) 由 前驅 活動射出的連線上 都 設置條件 ［圖 “多路聚合 ”型聚合模式］ 如上圖所示，由于 “ 活動 E” 的“ 聚合 模式（ JoinMode）”是 “ 多路 聚合 ” 并且在處理的過程中 “num==6” ，那么根據(jù)上面的算法說明由于 “活動 B與 “ 活動D” 的 射出的 連線上的條件都滿足，因此 “活動 B 與 “ 活動 D” 都 完成后， 活動 E才 被觸發(fā)。而無需考慮 “ 人工活動 1” 或 “ 人工活動 2” 是否完成。 【示例】 1. “ 全部聚合 ” 型聚合模式示例 ［圖 “全部聚合”型聚合模式］ 如上圖所示， “ 人工活動 3” 的 “ 聚合模式（ JoinMode） ” 設置為 “ 全部聚合 ” ，那么只有在它的前驅 “ 人工活動 ” 、 “ 人工活動 1” ， “ 人工活動 2” 都完成后， “ 人工活動 3” 才可以運行。 3. “ 多路聚合 ” 型聚合模式 表示該活動必須等到它的所有滿足條件的前驅活動全部完成才可以觸發(fā)。它包括 “ 全部聚合（ AND） ” 、 “ 單一聚合（ XOR） ” 以及 “ 多路聚合（ OR） ” 三種情況： 1. “ 全部聚合 ” 型聚合模式 表示該活動必須等到它的所有前驅活動全部完成才可以觸發(fā)。如果調用的子流程需要輸入或輸出一些參數(shù)請在 參數(shù) 選項卡中設置 聚合模式、分支模式 活動的 “ 分支 ” 與 “ 聚合 ” 模式在流程定義時設置，分別描述了活動在運行時何時被觸發(fā)以及或個運行結束后，它的后繼活動如何被觸發(fā)。此時，如要將返回結果中的某 項返回到相關數(shù)據(jù)中，可在 參數(shù) 選項卡中設置。 1） 自動活動的基本信息設置如下： ? 自動返回結果： – “ 是 ” ：表示執(zhí)行動作的返回結果全部自動放入 相關數(shù)據(jù) 的根路徑下。 結束活動 表示一個業(yè)務流程的結束。 路由活動 是一 種邏輯活動，根據(jù)控制條件判斷流程的流向。 子流程 一種特殊的活動，此活動本身是指向某一個流程，表示當流程實例運行至此時，啟動另外一個流程。 自動活動 指無需人工干預，系統(tǒng)自動執(zhí)行的活動。 人工活動 指需要人工干預、進行某種操作的活動。 活動圖元介紹 圖元 名稱 含義 開始活動 表示一個業(yè)務流程的開始。 活動定義 EOS WorkFlow 提供了六種類型的活動。 [圖 流程啟動者 ] 當流程實例運行的時候，可以在相關數(shù)據(jù)區(qū)的 如下節(jié)點 xpath 找到流程啟動者： WFContext WFProcessInst creator tiger/ creator / WFProcessInst / WFContext 流程定義特別說明 工作流的自動活動或觸發(fā)事件調用帶事務的業(yè) 務邏輯的注意事項 因為工作流的事務控制和 業(yè)務邏輯 的事務控制是分開的，所以，當工作流的自動活動或觸發(fā)事件調用了帶事務控制的業(yè)務邏輯時，工作流引擎默認忽略業(yè)務邏輯中的事務，這樣就存在一個問題： 業(yè)務邏輯中出現(xiàn)了異常，并通過異常線回滾，這時，業(yè)務數(shù)據(jù)提交不成功，但是，工作流引擎并沒有接收到異常，它會繼續(xù)往后走，最終就出現(xiàn)工作流事務和業(yè)務事務不一致的現(xiàn)象。 EOS WorkFlow 提供兩種流程啟動策略 :任意人員啟動和從組織機構樹獲取。在超時觸發(fā)事件中注冊一個定時器，定時掃描該流程實例是否完成，如果沒有完成就執(zhí)行 發(fā)放郵件或者短信都通知的操作。流程實例一旦超時，就會觸發(fā)相應的操作將流程實例中的 WFProcessInst/isTimeOut 節(jié)點設置為 Y。 此處將會根據(jù) 相關配置給 流程 啟動者發(fā)送郵件。 此處將會根據(jù) 相關配置給 流程 啟動者發(fā)送郵件。如果設置了超時提醒，該字段可能出現(xiàn)負數(shù)，是未超時的表現(xiàn)，只有正數(shù)才表示超時的時間，timeOutNumDesc 是其描述字段。 流程時間限制的計時：從流程啟動時開始計時 流程時間限制的獲?。褐苯又付?、從相關數(shù)據(jù)獲取（格式： 表示時限為 3 天 5小時 20 分鐘） 發(fā)送提醒郵件： EOS WorkFlow 可根據(jù)流程定義中的具體設置給流程啟動者發(fā)提醒郵件，提醒他該流程還有多長時間將超時 發(fā)送超時郵件： EOS WorkFlow 可根據(jù)流程定義中的具體設置給流程啟動者發(fā)送超時郵件，告之他該流程已經(jīng)超時 提醒時間必須小于指定的時間限制 EOS WORKFLOW 判斷流程或人工活動超時的原理 流程或人工活動的時間限制中設置的限制時間將寫入表 WFProcessInst 或WFWorkItem 的 limitNum 字段中，單位為毫秒， limitNumDesc 是其描述字段；finalTime 是時間限制到達后的時間。 時間 限制 說明 流程的時間限制表示流程啟動后必須在多長時間內完成。 [圖 設置觸發(fā)事件的參數(shù) ] 注意： 如果調用的事件類型為 業(yè)務邏輯， 而參數(shù)的數(shù)據(jù)類型為 字符串常量 或 字符串變量， 那么 路徑 中填入的格式必須為： nodeName=value或 nodeName=‘value’（因為業(yè)務邏輯不支持直接傳入常量或變量） 例如：要傳入常量 tiger 到所調用的業(yè)務邏輯中，就必須做如下設置 超時設置 如果想擴展和替換 EOS 工作流的超時和預警機制，可以根據(jù)工作流配置文件 中的工作流引擎服務層相關配置 module name=service group name=timer conf