流程封裝預置變量說明表.docx

流程封裝預置變量說明表1. 參與人相關參與人相關的變量，用于輔助實現(xiàn)以下四種場景：1. 基于權限配置對隊列進行過濾，將任務分配給隊列中的一個或多個人處理。實際使用時，可使用全開放式的隊列，然后基于權限配置，設置隊列中任務的實際可處理人。2. 節(jié)點D必須是節(jié)點A的實際執(zhí)行人處理。3. 節(jié)點D不能由節(jié)點A的實際執(zhí)行人處理。4. 動態(tài)選人，支持設定選人范圍。選人范圍的設置支持使用sql，比如（本部門人員）或者基于權限配置。注（變量命名規(guī)范）： 框架用于控制的變量以“L_”開頭。 需要框架進行賦值的工作流組，使用“WFG_”開頭。流程變量名稱使用說明L_UserIds隊列過濾工號列表當節(jié)點使用需要過濾的Queue時，需要將該變量作為Parameter，并在節(jié)點執(zhí)行前賦空值（”）。流程框架會在新任務到達時，自動將根據(jù)流程變量的值取對應的權限，并取到具有這些權限的工號列表，并存入L_UserIds中。如果在節(jié)點執(zhí)行前對該變量賦值，則流程框架不再做轉(zhuǎn)換。如果該節(jié)點需要發(fā)送郵件或短信通知，則按照L_UserIds的值選取通知人。任務列表從需要過濾的Queue中取任務時，將按照L_UserIds的值做過濾。示例：000272;000125注：要使Queue具有過濾功能，需要：（1）需要過濾的Queue需要配置到PubSysCnfg中。（2）增加”L_UserIds”作為隊列變量。（3）同時放在該節(jié)點的參數(shù)中。（4）將權限定義中涉及的流程變量放到節(jié)點的參數(shù)中。將L_StepName在節(jié)點執(zhí)行前設成適當?shù)念愋?。L_ExUserIds排除的工號列表用于“復核”類節(jié)點，需要將處理人排除在外。與L_StepParticipant配合使用。L_StepParticipant節(jié)點執(zhí)行人每一個需要記錄具體執(zhí)行人的Activity節(jié)點，都需要將該變量作為Parameter。節(jié)點的任務實例提交后，流程框架會自動把處理人的工號放到該變量中。流程定義中，可以在節(jié)點執(zhí)行后，將該變量的值賦給其他的變量保存起來，以便后續(xù)引用。示例：000272;L_StepName節(jié)點名稱用于唯一標識流程內(nèi)節(jié)點的字符串，用于權限定義中設置節(jié)點名稱。此外，也用于節(jié)點配置（任務到達通知模板等）中標識不同的節(jié)點，以及流程定義中設置跳轉(zhuǎn)、駁回或回收的目標節(jié)點。L_WfgFilterSql_XXX工作流組過濾SQL用于指定工作流組的可選人員的范圍。流程變量的名稱中“L_WfgFilterSql_”是固定的，表示W(wǎng)orkflow Group Filter Sql，后面的“XXX”表示工作流組的名稱。在需要動態(tài)選人的節(jié)點，傳入工作流組變量和該變量作為Parameter，用于過濾供用戶選擇的人員范圍。變量名稱中雖然包含了”Sql”，但該變量的支持兩種格式： 定義格式1（指定目標節(jié)點名稱，推薦） 前后以“”和“”包起來。中間是目標節(jié)點名稱的取值。可以指定多個變量的取值，變量中間以“;”隔開。 流程中的變量自動參與人員限制，所以一般只需要設置目標節(jié)點的L_StepName。例如： 選擇會審人員：L_StepName=HUISHEN 選擇調(diào)查人員：L_StepName=DIAOCHA 定義格式2 （SQL，不推薦，無法應用授權機制），適用于選擇同部門人員等情況。注意：用于人工選擇處理人時，返回列中應包含工號和姓名兩列。同時，可以使用當前登錄人的信息如下： $userNo$, 當前登錄人工號 $agencyCode$, 當前登錄人所在機構編號 $busiTypeCode$, 當前登錄人的業(yè)務類型編號L_WfgUids_XXX工作流組工號列表用于搶占式審批任務的動態(tài)指定審批人，保存由工作流組轉(zhuǎn)換而成用戶工號列表，用分號隔開。流程變量的名稱中“L_WfgUids_”是固定的，后面的“XXX”表示工作流組的名稱。在動態(tài)選人的節(jié)點提交時，針對工作流組的變量，判斷是否有“L_WfgUids_工作流組名”的變量，如果有，則將該變量設置為選擇的工號列表。2. 跳轉(zhuǎn)、駁回相關因為在FileNet中，節(jié)點間的路由必須畫線，為了避免太多的線讓流程圖混亂不堪，所以在流程圖中，增加一類特殊的節(jié)點“中轉(zhuǎn)接點”。中轉(zhuǎn)節(jié)點應該通過特殊的標識（比如名字，暫定為“路由”），與其他的節(jié)點區(qū)別開來。這樣在動態(tài)流程圖上，可以把中轉(zhuǎn)接點及其相關的連線隱藏，只把流程基本的流向顯示給用戶。考慮到實際需求中，并不是每個節(jié)點都需要任意的跳轉(zhuǎn)和駁回，所以僅需要將需要跳轉(zhuǎn)或駁回的節(jié)點通過中轉(zhuǎn)接點連接起來。同時，為了標識某個節(jié)點所能跳轉(zhuǎn)或駁回到哪些節(jié)點，增加流程變量：流程變量名稱使用說明L_JumpBackToSteps回退到的節(jié)點列表包含所能回退到的節(jié)點名稱，節(jié)點名稱用L_StepName表示，多個節(jié)點名稱，使用“;”分隔。流程定義時，在節(jié)點到達后，將該變量賦值。在流程任務處理界面，取該變量的值，并拆分成多個節(jié)點名稱。放置到“流轉(zhuǎn)方向”中。流程提交時，能夠判斷流轉(zhuǎn)方向中的取值是響應還是回退或跳轉(zhuǎn)，如果是響應則放到response中，如果是回退或跳轉(zhuǎn)，則放到L_JumpNextStep中。L_JumpForwardToSteps跳轉(zhuǎn)到的節(jié)點列表包含所能跳轉(zhuǎn)到的節(jié)點名稱，節(jié)點名稱及分隔符同上。流程定義和任務處理同上。L_JumpNextStep跳轉(zhuǎn)/回退的下一節(jié)點保存跳轉(zhuǎn)或回退到的下一節(jié)點名稱。中轉(zhuǎn)節(jié)點根據(jù)該變量確定要跳轉(zhuǎn)或回退到的目標節(jié)點。（配置路由的路由條件）流程定義需要注意的事項 流程啟動節(jié)點，只能設置Forward，不能設置BackTo。Forward應該設置在流程變量的初始值中。 對其他節(jié)點，應該在節(jié)點的執(zhí)行前任務中，對Forward和BackTo賦值。對于允許跳轉(zhuǎn)或駁回的節(jié)點，設置為對應的目標節(jié)點名；對于不允許跳轉(zhuǎn)或駁回的節(jié)點，設置為空。 這三個變量都應該放到節(jié)點的讀寫參數(shù)中。 特別注意，設置L_JumpBackToSteps或L_JumpForwardToSteps后，必須要把相關的節(jié)點通過路由用線連起來。 具有跳轉(zhuǎn)或駁回時，默認的路由必須要設置條件：L_JumpNextStep = “”。規(guī)范起見，建議將所有非中轉(zhuǎn)的路由都設置條件：L_JumpNextStep = “”，而所有到中轉(zhuǎn)節(jié)點的路由都設置條件：L_JumpNextStep “”； 對節(jié)點名稱的引用，統(tǒng)一使用流程變量中定義的該節(jié)點對應的名稱“L_SN_XXX”。3. 收回相關首先需要明確的是，不是所有的節(jié)點都可以收回，比如經(jīng)過了自動節(jié)點，或者流程有了分支，或者是多人并行處理的工作流組節(jié)點，或者是流程分叉的節(jié)點，都是不應該允許收回的。所以，是否能夠收回，應該在流程定義中通過配置的方式加以定義。另外，F(xiàn)ileNet所有的路由都必須要畫線才能實現(xiàn)，所以收回的實現(xiàn)思路基本等同于跳轉(zhuǎn)和退回。但收回有其特殊性，其一就是有權執(zhí)行收回的人是上一個節(jié)點的執(zhí)行人，其二就是執(zhí)行收回后，應該回到上一個節(jié)點。為體現(xiàn)這兩點，定義流程變量：流程變量名稱使用說明L_RetrievePersonAndStep有權收回的人和收回到的節(jié)點。指定有權收回的人員工號和收回到的節(jié)點名稱。工號和節(jié)點名稱用“;”分隔。格式為“000888;LURU”?！癓_RetrieveFlag”為Y的節(jié)點，在任務提交后，將該變量的值置為“提交人+當前節(jié)點名”。在流程定義中，不允許收回的節(jié)點，在任務到達時，將該變量置為“”（空字符串）。任務處理程序中，在打開時，將該變量置為空。（下個環(huán)節(jié)的人打開后，就不能再被上個環(huán)節(jié)的人收回，而只能由下個環(huán)節(jié)的人退回。）流程定義需要注意的事項 對需要提交后收回的節(jié)點，在執(zhí)行后任務中對L_RetrievePersonAndStep賦值為L_StepParticipant + “;Step1”，其中Step1表示當前節(jié)點的L_StepName。注意：謹慎設置L_RetrieveFlag，特別考慮目標節(jié)點多人處理的情況、流程分支的情況和流程并發(fā)的情況。 如果啟動節(jié)點需要提交后收回，則需要單獨畫一個節(jié)點，并且設置L_StepName。然后在啟動節(jié)點的執(zhí)行后任務中，對L_RetrievePersonAndStep賦值為“啟動人工號+新節(jié)點的L_StepName”。 將該變量放到所有節(jié)點的讀寫參數(shù)中。 特別注意，允許收回的節(jié)點，必須要把目標節(jié)點與收回到的節(jié)點通過路由用線連起來。4. 任務列表相關注：已完成流程的流程變量并沒有以“L_”開頭，所以任務列表中，需要判斷兩類變量。另外，在啟動節(jié)點，必須將前5個變量置于節(jié)點參數(shù)中，以便流程封裝程序自動賦值。（L_Summary不需要，該變量通過流程定義在啟動節(jié)點的“執(zhí)行后任務”中賦值；）建議：將這6個變量置于所有的節(jié)點參數(shù)中，以便需要發(fā)送郵件時，可以使用其中的值。流程變量名稱使用說明L_ProcNo流程編號流程啟動時，doLaunch判斷該流程是否配置有“流程編號前綴”，如果有，則自動生成流程編號，并賦給該變量。L_AgencyName所屬機構流程啟動時，doLaunch將啟動人所屬機構名稱賦給該變量。L_AgencyCode機構代碼流程啟動時，doLaunch將啟動人所屬機構的機構代碼賦給該變量。L_InputOperatorCode錄入人工號流程啟動時，doLaunch將啟動人工號賦給該變量。L_InputOperatorName錄入人名字流程啟動時，doLaunch將啟動人姓名賦給該變量。L_Summary摘要流程啟動后，在啟動節(jié)點的“執(zhí)行后任務”中賦值；在后續(xù)節(jié)點中對流程變量有改動時，更新。5. 節(jié)點名稱定義相當于編程中的常量定義。每個人工節(jié)點對應一個變量，以“L_SN_”開頭，并在描述中寫該節(jié)點的中文名稱。為了權限定義方便，從名稱上將需要定義權限的節(jié)點和不需要定義權限的節(jié)點分開，需要定義權限的節(jié)點名稱以“L_CSN_”開頭（Controlled Step Name），不需要定義權限的節(jié)點名稱以“L_USN_”開頭（Uncontrolled Step Name）。例如：錄入節(jié)點L_USN_Input，一級審批L_CSN_Level16. 動態(tài)選人的范圍配置規(guī)則(SQL)針對需要配置選人范圍的工作流組，找到對應的變量：工作流組過濾SQL L_WfgFilterSql_XXX，其中XXX為對應工作流組的名稱。配置語言為sql語句，目標位wfuser表，查詢條件中可以包含的預置變量如下： * $userNo$, 當前登錄人工號 * $agencyCode$, 當前登錄人所在機構編號 * $busiTypeCode$, 當前登錄人的業(yè)務類型編號 * 支持按照組過濾，在sqlExp中增加如下： * userno in $G_組名 * 該函數(shù)將自動把“組名”對應的TDS的Group中的用戶編號轉(zhuǎn)換成(,uid1,uid2,.)的字符串，替換到原SQL中。其中第一個是為了方便組為空的處理，無實際意義。 * 注意：組名需要寫整個Dn，比如：cn=AgencyLeader,ou=Qs_Workflow,cn=groups,dc=km,dc=citics,dc=com示例：1. 選取本部門的人員select userno, username from wfuser where isjianzhi=N and rzjg = $agencyCode$2. 在指定的人員范圍中選擇人員select userno, username from wfuser where isjianzhi=N and userno in (000487,000272,005155)3. 選取本部門的人員（不包含當前登錄人本人）select userno, username from wfuser where isjianzhi=N and rzjg = $agency