流程封裝預(yù)置變量說(shuō)明表

1、流程圭寸裝預(yù)置變量說(shuō)明表參與人相關(guān)參與人相關(guān)的變量，用于輔助實(shí)現(xiàn)以下四種場(chǎng)景:1. 基于權(quán)限配置對(duì)隊(duì)列進(jìn)行過(guò)濾，將任務(wù)分配給隊(duì)列中的一個(gè)或多個(gè)人處理。實(shí)際使用時(shí)，可使用全開(kāi)放式的隊(duì)列，然后基于權(quán)限配置，設(shè)置隊(duì)列中任務(wù)的實(shí)際可處理人。2. 節(jié)點(diǎn)D必須是節(jié)點(diǎn)A的實(shí)際執(zhí)行人處理。3. 節(jié)點(diǎn)D不能由節(jié)點(diǎn)A的實(shí)際執(zhí)行人處理。4. 動(dòng)態(tài)選人，支持設(shè)定選人范圍。選人范圍的設(shè)置支持使用sql，比如（本部門(mén)人員）或者基于權(quán)限配置。注（變量命名規(guī)范）：框架用于控制的變量以“L_”開(kāi)頭需要框架進(jìn)行賦值的工作流組，使用“WFG_”開(kāi)頭。隊(duì)列過(guò)濾當(dāng)節(jié)點(diǎn)使用需要過(guò)濾的Queue時(shí)，需要將該變量作為工號(hào)列表Paramete

2、r，并在節(jié)點(diǎn)執(zhí)行前賦空值（”）。流程框架會(huì)在新任務(wù)到達(dá)時(shí)，自動(dòng)將根據(jù)流程變量的值取對(duì)應(yīng)的權(quán)限，并取到具有這些權(quán)限的工號(hào)列表，并存入L_Userlds中。如果在節(jié)點(diǎn)執(zhí)行前對(duì)該變量賦值，則流程框架不再做轉(zhuǎn)換。如果該節(jié)點(diǎn)需要發(fā)送郵件或短信通知，則按照L_UserIds的值選取通知人。任務(wù)列表從需要過(guò)濾的Queue中取任務(wù)時(shí)，將按照L_UserIds的值做過(guò)濾。示例：000272;000125注：要使Queue具有過(guò)濾功能，需要：（1）需要過(guò)濾的Queue需要配置到PubSysCnfg中。（2）增加”L_Userlds作為隊(duì)列變量。（3）同時(shí)放在該節(jié)點(diǎn)的參數(shù)中。（4）將權(quán)限定義中涉及的流程變量放到節(jié)點(diǎn)

3、的參數(shù)中。將L_StepName在節(jié)點(diǎn)執(zhí)行前設(shè)成適當(dāng)?shù)念愋汀Ｅ懦墓び糜凇皬?fù)核”類節(jié)點(diǎn)，需要將處理人排除在外。號(hào)列表與L_StepParticipant配合使用。節(jié)點(diǎn)執(zhí)行每一個(gè)需要記錄具體執(zhí)行人的Activity節(jié)點(diǎn)，都需要人將該變量作為Parameter。節(jié)點(diǎn)的任務(wù)實(shí)例提交后，流程框架會(huì)自動(dòng)把處理人的工號(hào)放到該變量中。流程定義中，可以在節(jié)點(diǎn)執(zhí)行后，將該變量的值賦給其他的變量保存起來(lái)，以便后續(xù)引用。示例：000272;節(jié)點(diǎn)名稱用于唯一標(biāo)識(shí)流程內(nèi)節(jié)點(diǎn)的字符串，用于權(quán)限定義中設(shè)置節(jié)點(diǎn)名稱。此外，也用于節(jié)點(diǎn)配置（任務(wù)到達(dá)通知模板等）中標(biāo)識(shí)不同的節(jié)點(diǎn)，以及流程定義中設(shè)置跳轉(zhuǎn)、駁回或回收的目標(biāo)節(jié)點(diǎn)。工作

4、流組用于指定工作流組的可選人員的范圍。過(guò)濾SQL流程變量的名稱中“L_WfgFilterSql_”是固定的，表示W(wǎng)orkflowGroupFilterSql，后面的"XXX”表示工作流組的名稱。在需要?jiǎng)討B(tài)選人的節(jié)點(diǎn)，傳入工作流組變量和該變量作為Parameter，用于過(guò)濾供用戶選擇的人員范圍。變量名稱中雖然包含了”Sql”，但該變量的支持兩種格式：定義格式1（指定目標(biāo)節(jié)點(diǎn)名稱，推薦）前后以“”和“”包起來(lái)。中間是目標(biāo)節(jié)點(diǎn)名稱的取值?？梢灾付ǘ鄠€(gè)變量的取值，變量中間以“；”隔開(kāi)。流程中的變量自動(dòng)參與人員限制，所以一般只需要設(shè)置目標(biāo)節(jié)點(diǎn)的L_StepName。例如:選擇會(huì)審人員：L_St

5、epName=HUISHEN選擇調(diào)查人員：L_StepName=DIAOCHA定義格式2（SQL，不推薦，無(wú)法應(yīng)用授權(quán)機(jī)制）適用于選擇同部門(mén)人員等情況。注意：用于人工選擇處理人時(shí)，返回列中應(yīng)包含工號(hào)和姓名兩列。同時(shí)，可以使用當(dāng)前登錄人的信息如下：$userNo$,當(dāng)前登錄人工號(hào)$agencyCode$,當(dāng)前登錄人所在機(jī)構(gòu)編號(hào)$busiTypeCode$,當(dāng)前登錄人的業(yè)務(wù)類型編號(hào)工作流組用于搶占式審批任務(wù)的動(dòng)態(tài)指定審批人，保存由工作工號(hào)列表流組轉(zhuǎn)換而成用戶工號(hào)列表，用分號(hào)隔開(kāi)。流程變量的名稱中“L_WfgUids_”是固定的，后面的“XXX”表示工作流組的名稱。在動(dòng)態(tài)選人的節(jié)點(diǎn)提交時(shí)，針對(duì)工作流

6、組的變量，判斷是否有“L_WfgUids_工作流組名”的變量，如果有，則將該變量設(shè)置為選擇的工號(hào)列表。跳轉(zhuǎn)、駁回相關(guān)因?yàn)樵贔ileNet中，節(jié)點(diǎn)間的路由必須畫(huà)線，為了避免太多的線讓流程圖混亂不堪，所以在流程圖中，增加一類特殊的節(jié)點(diǎn)一一“中轉(zhuǎn)接點(diǎn)”。中轉(zhuǎn)節(jié)點(diǎn)應(yīng)該通過(guò)特殊的標(biāo)識(shí)（比如名字，暫定為“路由”），與其他的節(jié)點(diǎn)區(qū)別開(kāi)來(lái)。這樣在動(dòng)態(tài)流程圖上，可以把中轉(zhuǎn)接點(diǎn)及其相關(guān)的連線隱藏，只把流程基本的流向顯示給用戶。考慮到實(shí)際需求中，并不是每個(gè)節(jié)點(diǎn)都需要任意的跳轉(zhuǎn)和駁回，所以僅需要將需要跳轉(zhuǎn)或駁回的節(jié)點(diǎn)通過(guò)中轉(zhuǎn)接點(diǎn)連接起來(lái)。同時(shí)，為了標(biāo)識(shí)某個(gè)節(jié)點(diǎn)所能跳轉(zhuǎn)或駁回到哪些節(jié)點(diǎn)，增加流程變量：回退到的節(jié)點(diǎn)列表包

7、含所能回退到的節(jié)點(diǎn)名稱，節(jié)點(diǎn)名稱用L_StepName表示，多個(gè)節(jié)點(diǎn)名稱，使用“；”分隔。流程定義時(shí)，在節(jié)點(diǎn)到達(dá)后，將該變量賦值。在流程任務(wù)處理界面，取該變量的值，并拆分成多個(gè)節(jié)點(diǎn)名稱。放置到“流轉(zhuǎn)方向”中。流程提交時(shí)，能夠判斷流轉(zhuǎn)方向中的取值是響應(yīng)還是回退或跳轉(zhuǎn)，如果是響應(yīng)則放到response中，如果是回退或跳轉(zhuǎn)，則放到L_JumpNextStep中。跳轉(zhuǎn)到包含所能跳轉(zhuǎn)到的節(jié)點(diǎn)名稱，節(jié)點(diǎn)名稱及分隔符同的節(jié)點(diǎn)上。列表流程定義和任務(wù)處理同上。跳轉(zhuǎn)/回保存跳轉(zhuǎn)或回退到的下一節(jié)點(diǎn)名稱。中轉(zhuǎn)節(jié)點(diǎn)根據(jù)退的下該變量確定要跳轉(zhuǎn)或回退到的目標(biāo)節(jié)點(diǎn)。（配置路由的一節(jié)點(diǎn)路由條件）流程定義需要注意的事項(xiàng)流程啟動(dòng)節(jié)

8、點(diǎn)，只能設(shè)置Forward，不能設(shè)置BackTo。Forward應(yīng)該設(shè)置在流程變量的初始值中。對(duì)其他節(jié)點(diǎn)，應(yīng)該在節(jié)點(diǎn)的執(zhí)行前任務(wù)中，對(duì)Forward和BackTo賦值。對(duì)于允許跳轉(zhuǎn)或駁回的節(jié)點(diǎn)，設(shè)置為對(duì)應(yīng)的目標(biāo)節(jié)點(diǎn)名；對(duì)于不允許跳轉(zhuǎn)或駁回的節(jié)點(diǎn)，設(shè)置為空。這三個(gè)變量都應(yīng)該放到節(jié)點(diǎn)的讀寫(xiě)參數(shù)中。特別注意，設(shè)置L_JumpBackToSteps或L_JumpForwardToSteps后，必須要把相關(guān)的節(jié)點(diǎn)通過(guò)路由用線連起來(lái)。具有跳轉(zhuǎn)或駁回時(shí)，默認(rèn)的路由必須要設(shè)置條件：L_JumpNextStep="”規(guī)范起見(jiàn)，建議將所有非中轉(zhuǎn)的路由都設(shè)置條件：L_JumpNextStep="

9、”而所有到中轉(zhuǎn)節(jié)點(diǎn)的路由都設(shè)置條件：L_JumpNextStep<>"”對(duì)節(jié)點(diǎn)名稱的引用，統(tǒng)一使用流程變量中定義的該節(jié)點(diǎn)對(duì)應(yīng)的名稱“L_SN_XXX”。收回相關(guān)首先需要明確的是，不是所有的節(jié)點(diǎn)都可以收回，比如經(jīng)過(guò)了自動(dòng)節(jié)點(diǎn)，或者流程有了分支，或者是多人并行處理的工作流組節(jié)點(diǎn)，或者是流程分叉的節(jié)點(diǎn)，都是不應(yīng)該允許收回的。所以，是否能夠收回，應(yīng)該在流程定義中通過(guò)配置的方式加以定義。另外，F(xiàn)ileNet所有的路由都必須要畫(huà)線才能實(shí)現(xiàn)，所以收回的實(shí)現(xiàn)思路基本等同于跳轉(zhuǎn)和退回。但收回有其特殊性，其一就是有權(quán)執(zhí)行收回的人是上一個(gè)節(jié)點(diǎn)的執(zhí)行人，其二就是執(zhí)行收回后，應(yīng)該回到上一個(gè)節(jié)點(diǎn)。為

10、體現(xiàn)這兩點(diǎn)，定義流程變量:到上一個(gè)節(jié)點(diǎn)。為體現(xiàn)這兩點(diǎn)，定義流程變量:有權(quán)收回的人和收回到的節(jié)點(diǎn)。指定有權(quán)收回的人員工號(hào)和收回到的節(jié)點(diǎn)名稱。工號(hào)和節(jié)點(diǎn)名稱用“；”分隔。格式為“000888;LURU”?！癓_RetrieveFlag”為丫的節(jié)點(diǎn)，在任務(wù)提交后，將該變量的值置為“提交人+當(dāng)前節(jié)點(diǎn)名”。在流程定義中，不允許收回的節(jié)點(diǎn)，在任務(wù)到達(dá)時(shí)，將該變量置為“”（空字符串）。任務(wù)處理程序中，在打開(kāi)時(shí)，將該變量置為空。（下個(gè)環(huán)節(jié)的人打開(kāi)后，就不能再被上個(gè)環(huán)節(jié)的人收回，而只能由下個(gè)環(huán)節(jié)的人退回。）流程定義需要注意的事項(xiàng)對(duì)需要提交后收回的節(jié)點(diǎn)，在執(zhí)行后任務(wù)中對(duì)L_RetrievePersonAndSte

11、p賦值為L(zhǎng)_StepParticipant+；Stepl"，其中Stepl表示當(dāng)前節(jié)點(diǎn)的L_StepName。注意：謹(jǐn)慎設(shè)置L_RetrieveFlag，特別考慮目標(biāo)節(jié)點(diǎn)多人處理的情況、流程分支的情況和流程并發(fā)的情況。如果啟動(dòng)節(jié)點(diǎn)需要提交后收回，則需要單獨(dú)畫(huà)一個(gè)節(jié)點(diǎn)，并且設(shè)置L_StepName。然后在啟動(dòng)節(jié)點(diǎn)的執(zhí)行后任務(wù)中，對(duì)L_RetrievePersonAndStep賦值為“啟動(dòng)人工號(hào)+新節(jié)點(diǎn)的L_StepName”。將該變量放到所有節(jié)點(diǎn)的讀寫(xiě)參數(shù)中。特別注意，允許收回的節(jié)點(diǎn)，必須要把目標(biāo)節(jié)點(diǎn)與收回到的節(jié)點(diǎn)通過(guò)路由用線連起來(lái)。任務(wù)列表相關(guān)注：已完成流程的流程變量并沒(méi)有以“L_”

12、開(kāi)頭，所以任務(wù)列表中，需要判斷兩類變量。另外，在啟動(dòng)節(jié)點(diǎn)，必須將前5個(gè)變量置于節(jié)點(diǎn)參數(shù)中，以便流程封裝程序自動(dòng)賦值。(L_Summary不需要，該變量通過(guò)流程定義在啟動(dòng)節(jié)點(diǎn)的“執(zhí)行后任務(wù)”中賦值；)建議：將這6個(gè)變量置于所有的節(jié)點(diǎn)參數(shù)中，以便需要發(fā)送郵件時(shí)，可以使用其中的值。流程啟動(dòng)時(shí)，doLaunch判斷該流程是否配置有“流程編號(hào)前綴”，如果有，則自動(dòng)生成流程編號(hào)，并賦給該變量。流程啟動(dòng)時(shí)，doLaunch將啟動(dòng)人所屬機(jī)構(gòu)名稱賦給該變量。流程啟動(dòng)時(shí)，doLaunch將啟動(dòng)人所屬機(jī)構(gòu)的機(jī)構(gòu)代碼賦給該變量。流程啟動(dòng)時(shí)，doLaunch將啟動(dòng)人工號(hào)賦給該變量。流程啟動(dòng)時(shí)，doLaunch將啟動(dòng)人姓

13、名賦給該變量。流程啟動(dòng)后，在啟動(dòng)節(jié)點(diǎn)的“執(zhí)行后任務(wù)”中賦值；在后續(xù)節(jié)點(diǎn)中對(duì)流程變量有改動(dòng)時(shí)，更新。1. 節(jié)點(diǎn)名稱定義相當(dāng)于編程中的常量定義。每個(gè)人工節(jié)點(diǎn)對(duì)應(yīng)一個(gè)變量，以“L_SN_”開(kāi)頭，并在描述中寫(xiě)該節(jié)點(diǎn)的中文名稱。為了權(quán)限定義方便，從名稱上將需要定義權(quán)限的節(jié)點(diǎn)和不需要定義權(quán)限的節(jié)點(diǎn)分開(kāi)，需要定義權(quán)限的節(jié)點(diǎn)名稱以“L_CSN_”開(kāi)頭(ControlledStepName)，不需要定義權(quán)限的節(jié)點(diǎn)名稱以“L_USN_”開(kāi)頭(UncontrolledStepName)。例如：錄入節(jié)點(diǎn)L_USN_Input，級(jí)審批L_CSN_Level1動(dòng)態(tài)選人的范圍配置規(guī)則(SQL)針對(duì)需要配置選人范圍的工作流組

14、，找到對(duì)應(yīng)的變量：工作流組過(guò)濾SQLL_WfgFilterSql_XXX，其中XXX為對(duì)應(yīng)工作流組的名稱。配置語(yǔ)言為sql語(yǔ)句，目標(biāo)位wfuser表，查詢條件中可以包含的預(yù)置變量如下：* ?$userNo$,當(dāng)前登錄人工號(hào)* ?$agencyCode$,當(dāng)前登錄人所在機(jī)構(gòu)編號(hào)* ?$busiTypeCode$,當(dāng)前登錄人的業(yè)務(wù)類型編號(hào)*支持按照組過(guò)濾，在sqlExp中增加如下：* usernoin$G_組名*該函數(shù)將自動(dòng)把組名”對(duì)應(yīng)的TDS的Group中的用戶編號(hào)轉(zhuǎn)換成('','uid1','uid2',)的字符串，替換到原SQL中。其中第一個(gè)是

15、為了方便組為空的處理，無(wú)實(shí)際意義。*注意：組名需要寫(xiě)整個(gè)Dn，比如：cn=AgencyLeader,ou=Qs_Workflow,cn=groups,dc=km,dc=citics,dc=com_示例：1. 選取本部門(mén)的人員selectuserno,usernamefromwfuserwhereisjianzhi='N'andrzjg='$agencyCode$'2. 在指定的人員范圍中選擇人員selectuserno,usernamefromwfuserwhereisjianzhi='N'andusernoin(000487','000272','005155'3. 選取本部門(mén)的人員（不包含當(dāng)前登錄人本人）selectuserno,usernamefromwfuserwhereisjianzhi='N'andrzjg='$agencyCode$'anduserno<>'$userNo$'4. 選取本