自定義平臺實施手冊

華天動力協(xié)同辦公系統(tǒng)自定義平臺實施手冊大連華天軟件有限公司2013年8月22日目錄TOC\o"1-5"\h\z\o"CurrentDocument"1：自定義平臺實施概要 3\o"CurrentDocument"2：實施子系統(tǒng) 3\o"CurrentDocument"2.1新建子系統(tǒng) 3\o"CurrentDocument"2.2模塊設置 3\o"CurrentDocument"2.2.1新建模塊 3\o"CurrentDocument"審批流程設置 5\o"CurrentDocument"2.2.3畫面設置 5\o"CurrentDocument"2.3菜單設置 7\o"CurrentDocument"2.4后臺觸發(fā)程序 8\o"CurrentDocument"2.4.1畫面后臺觸發(fā)程序 82.4.2流程后臺觸發(fā)程序 9\o"CurrentDocument"2.4.3后臺觸發(fā)程序常見問題 10\o"CurrentDocument"2.5表單控件詳解 12\o"CurrentDocument"2.5.1關聯設置 122.5.2提醒設置 13\o"CurrentDocument"2.5.3計算字段 13\o"CurrentDocument"2.5.4宏控件 13\o"CurrentDocument"2.5.5明細表 14\o"CurrentDocument"2.5.6SQL字段 14\o"CurrentDocument"2.5.7查詢按鈕 14\o"CurrentDocument"2.5.8表單按鈕 163：流水號 16\o"CurrentDocument"3.1流水號設置 16\o"CurrentDocument"3.1.1設置流水號的所屬類別 16\o"CurrentDocument"設置編號相關信息 17\o"CurrentDocument"3.2流水號應用 174：訪問外部數據 17\o"CurrentDocument"4.1新建數據源 17\o"CurrentDocument"4.2獲取外部數據 17\o"CurrentDocument"4.3回寫外部數據 181：自定義平臺實施概要自定義平臺由：子系統(tǒng)列表、預定義流程、節(jié)點設置、流水號設置、數據源設置等子模塊構成。其中“子系統(tǒng)列表”是核心模塊，在這里完成大多數的自定義設置?！邦A定義流程”和“節(jié)點設置”是和工作流相關的模塊?！傲魉栐O置”用來設置表單中流水號的樣式。“數據源設置”主要是設置外部數據源的連接。2：實施子系統(tǒng)2.1新建子系統(tǒng)由菜單【自定義平臺】\【子系統(tǒng)列表】進入子系統(tǒng)列表，單擊“新增”按鈕，則出現如下操作界面。填寫系統(tǒng)名稱之后保存即可新建一個子系統(tǒng)，其后的所有操作都在子系統(tǒng)項下進行。2.2模塊設置一個子系統(tǒng)下包含多個模塊。例如：辦公用品這個子系統(tǒng)包含了物品信息、采購申請單、入庫單、物品領用單、庫存維護單、庫存表等模塊。一個模塊中包含了一個表單、多個流程、多個畫面及后臺數據庫中對應的一組數據表。新建模塊第一步：設置模塊名稱、附件存放方式、模塊狀態(tài)和后臺觸發(fā)程序。關于后臺觸發(fā)程序的詳細信息請參閱本文檔的后臺觸發(fā)程序章節(jié)。

第二步：錄入畫面設置畫面基于HTML技術，設計器中有多種控件可以使用。這些控件的詳細使用方法請參閱本文檔的“表單控件詳解”部分。第三步：表設置第四步：讀寫權限設置注意：當表單沒有審批流程的時候，才在這里設置讀寫權限。如果表單會掛接審批流程，那么可以忽略第四步。經過上述四個步驟之后，保存就可以創(chuàng)建一個新模塊。審批流程設置這部分的設置與審批流轉里面完全一致，請參考審批流轉的相關文檔畫面設置畫面分為三類：瀏覽畫面、錄入畫面、類別瀏覽畫面以表格的形式展現數據。瀏覽畫面中表格的各個列可以自由定義。

錄入畫面就是在表單設計器中設計的界面。設置錄入畫面后能實現從菜單直接進入新增記錄的表單，即單擊菜單后頁面上顯示的表單是新增狀態(tài)。類別畫面用來實現分類的瀏覽畫面，通過該畫面能新增、修改和刪除類別記錄。2.3菜單設置每個畫面創(chuàng)建之后會有一個對應的激活URL,如下圖所示。通過這個URL就可以把一個畫面和一個菜單項關聯起來。進入子系統(tǒng)列表,單擊“菜單設置”按鈕進入菜單設置頁面。@菜單設置丨新建丨修改丨上下級菜單排序丨同級菜單排序丨刪除丨返回丨E牛人辦公□短消息發(fā)送短消息已發(fā)短消息已收短消息短消息收藏消息草稿箱□文件傳送發(fā)送文件已發(fā)文件已收文件文件收藏文件草稿箱牛人文件柜我的申詰持我審批經我審批待我閱讀我的申詰持我審批經我審批待我閱讀□公司電子郵件公司郵件箱菜單名稱：填寫菜單的標題。上級菜單：選擇菜單的上級菜單。鏈接目標：填寫畫面的“激活URL”。因為激活URL是一個比較長字符串，通?？梢栽诋嬅嬖O置處先把激活URL復制下來，然后粘貼到此處。選擇權限組：選擇新增菜單可以被哪些權限組的用戶使用。菜單圖片：在菜單左側顯示的圖片，僅對第一級菜單有效。2.4后臺觸發(fā)程序后臺觸發(fā)程序分為兩類：畫面后臺觸發(fā)程序和流程后臺觸發(fā)程序。后臺觸發(fā)程序使用Java語言編寫。畫面后臺觸發(fā)程序

每個畫面都可以設置一個后臺觸發(fā)程序。頁面后臺程序需要繼承m.TracePublicPageProcess,并實現其中定義的方法。m.TracePublicPageProcess公共變量說明dataMap方法名說明publicabstractStringcreateBefore();新建方法運行前觸發(fā)publicabstractStringupdateBefore();修改方法運行前觸發(fā)publicabstractStringdeleteBefore();刪除方法運行前觸發(fā)publicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);保存方法運行前觸發(fā)參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);保存方法運行后觸發(fā)參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組參數yesFlg當前審批者是否同意2.4.2流程后臺觸發(fā)程序一個模塊可以設置一個流程后臺觸發(fā)程序。頁面后臺程序需要繼承m.TracePublicProcess,并實現其中定義的方法。m.TracePublicProcess公共變量說明dataMap方法名說明publicabstractMapcreateTraceInit();新建表單時，初使值的設置畫面PublicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);新建流程后在發(fā)送審批前觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組publicabstractStringcreateTraceAfterBySend(MapmainRecord,MaplistRecordArray);新建流程后在發(fā)送審批后觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組publicabstractStringcreateTraceAfterBySave(MapmainRecord,MaplistRecordArray);新建流程后保存前觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組publicabstractStringtraceBefore(MapmainRecord,MaplistRecordArray);每步審批前觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組publicabstractStringtraceAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);每步審批后觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組參數yesFlg當前審批者是否同意publicabstractStringbackTraceBefore(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文前觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組參數backToCreaterFlg是否是退文到創(chuàng)建人publicabstractStringbackTrace(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文時觸發(fā)的事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組參數backToCreaterFlg是否是退文到創(chuàng)建人publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);審批結束后事件參數mainRecord操作主表記錄參數listRecordArray操作細表記錄數組參數yesFlg當前審批者是否同意后臺觸發(fā)程序常見問題Q：如何獲得主表字段的值？A：參見如下代碼publicStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFlg){//“申請單單號”是字段名稱StringbillNumber=(String)mainRecord.get("申請單單號");//其他代碼…returnnull;}Q：如何遍歷操作子表A：參見如下代碼publicStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFlg){//official_input_detail是子表名MapdetailRecord=(Map)listRecordArray.get("official_input_detail");inti=0;Maprecord=(Map)detailRecord.get("tr"+i++);while(record!=null){Stringcategoryld=(String)record.get("物品類別")；

//其他代碼….//獲得子表的下一條記錄record=(Map)detailRecord.get("tr"+i++);}returnnull;}Q：程序中的dataMap公共變量的用途是什么？A：參見下表變量用法說明dataMap.get("currentStepId”)獲得當前流程的審批步驟lddataMap.get("currentStepName”)獲得當前流程的審批步驟名稱dataMap.get("currentStepTraceActionlc”)獲得審批動作iddataMap.get("currentStepTraceActionName”)獲得審批動作名稱dataMap.get("currentTraceUserld”)獲得當前審批人lddataMap.get("currentTraceUserName”)獲得當前審批人用戶名dataMap.get("currentTraceUserDeptld”)獲得當前審批人部門lddataMap.get("currentTraceUserDeptName”)獲得當前審批人的部門名稱dataMap.get("currentTraceUserRoleld”)獲得當前審批人的崗位lddataMap.get("currentTraceUserRoleName”)獲得當前審批人的崗位名稱dataMap.get("currentTraceUserLeaderlc”)獲得當前審批人的直屬領導lddataMap.get("currentTraceUserLeaderName”)獲得當前審批人的直屬領導姓名dataMap.get("currentTraceUserTraceMinc”)獲得當前審批步驟的審批意見dataMap.get("currentTraceUserTraceMindState’)獲得當前審批步驟的審批狀態(tài)dataMap.get("currentTraceUserTraceDateTime’)獲得當前審批步驟的審批操作時間dataMap.get(“nextStepId”)獲得審批流程的下一步驟lddataMap.get(“nextStepTitle”)獲得審批流程的下一步驟名稱dataMap.get(“nextStepName”)獲得審批流程的下一步驟動作名稱dataMap.get(“nextStepTraceUserldLisf)獲得下一審批步驟的審批人ld列表dataMap.get(“nextStepTraceUserNameLisf)獲得下一審批步驟的審批人名稱列表dataMap.get("traceTitle”)申請標題dataMap.get("createTraceUserCreateDateTime”)申請時間dataMap.get("createTraceUserld”)申請人用戶iddataMap.get("createTraceUserName”)申請人用戶名稱dataMap.get("createTraceUserDeptld”)申請人部門ld

變量用法說明dataMap.get("createTraceUserDeptName”)申請人部門名稱dataMap.get("createTraceUserRolelcT)申請人崗位iddataMap.get("createTraceUserRoleName”)申請人崗位名稱dataMap.get("createTraceUserLeaderUserldList”)申請人直屬領導id列表dataMap.get("createTraceUserLeaderUserNameLisf)申請人直屬領導名稱列表2.5表單控件詳解關聯設置關聯用于：當表單的一個字段值發(fā)生變化后，其他一個或多個字段會跟著發(fā)生變化。例如：客戶編碼和客戶名稱、客戶電話之間的關聯，當客戶編碼被改變的時候，對應的客戶名稱和客戶電話相應發(fā)生關聯變化，在這種情況下需要在客戶編碼上設置關聯。關聯是通過定義SQL文以及SQL文執(zhí)行結果與表單字段的對應關系來實現。第一步：建立數據來源的SQL文。通過使用外部數據源，可以訪問外部系統(tǒng)的數據。如何配置外部數據源，請參考本文檔的“訪問外部數據”部分。第二步：設置表單字段內容綁定，把SQL文查詢的結果的字段與表單上的字段綁定起來。提醒設置提醒用于：在輸入的時候，系統(tǒng)根據所輸入的部分文字自動給出備選的信息，供快捷選擇。例如：輸入商品編碼，會提示商品名稱。第一步：編寫提醒的SQL文。第二步：設置提醒列表中顯示的字段。【設置為提醒字段】按鈕：把選中的字段設置為提醒列表中的顯示字段?！驹O置為使用字段】按鈕：選中的字段的值會顯示在當前控件上?！驹O置為存儲字段】按鈕：存儲字段的值會保存到數據庫中。計算字段計算字段可以實現主表的字段之間的計算、明細表的各個列之間的計算和計算明細表某列的合計。填寫明細表的某列的名稱，表示對明細表這列的值求和。宏控件序號宏控件說明1日期選擇選擇日期2時間選擇選擇時間3日期時間選擇日期和時間

序號宏控件說明4表單名稱表單的名稱5重要度申請的重要程度6經辦人IP地址顯示經辦人的IP地址7當前用戶崗位名稱顯示當前用戶的崗位名稱8當前用戶直屬領導顯示當前用戶的直屬領導9申請人姓名顯示申請人的姓名10申請人部門顯示申請人的部門名稱11審批人簽名顯示審批人的簽名12審批人意見顯示審批人的意見13金額轉大寫把小與的數字轉換為中文大與數字14自動流水號顯示自動流水號，有多個流水號可用的時候顯示下拉列表讓用戶選擇15崗位選擇選擇崗位16人員選擇選擇人員17部門選擇選擇部門18類別選擇選擇一個類別。19多人員選擇同時選擇多個人員。明細表明細表的每個列可以是：輸入框、輸入區(qū)、復選按鈕、單選按鈕、下拉列表、計算字段SQL字段和宏控件。每種類型的使用與單獨的控件是完全一致的。SQL字段SQL字段能實現從其他數據表中取數。通過使用外部數據源，SQL字段也能訪問其他系統(tǒng)中的數據。查詢按鈕查詢按鈕可以和查詢視圖關聯起來，單擊查詢按鈕后關聯的查詢視圖會被調用。查詢視圖上的數據被選擇后，可以給表單上對應的字段賦值。

視圖名稱：按鈕單擊之后會調用哪個查詢視圖。選取方式：用于把查詢視圖上的數據返回給表單的時候，允許用戶只能選擇一條查詢視圖上的數據還是允許用戶選擇多條查詢視圖上的數據。允許選擇多條數據一般用于向子表傳遞數據。查詢條件：用SQL的where子句的語法格式向查詢視圖附加過濾條件。表單字段內容綁定：用來設置如何把查詢視圖上的字段對應到表單上。當用戶選擇了查詢視圖上的數據后，查詢視圖的數據就按這個綁定關系把值傳給表單上對應的控件。

表單按鈕表單按鈕用來聯查表單，單擊表單按鈕后顯示關聯的表單第一步：選擇模板名稱，即要關聯的表單。第二步：設置表單選中條件綁定。通常會使用表單的唯一標志來做條件綁定，例如：使用單號來做條件綁定?！澳０蹇丶侄巍笔侵赴粹o單擊后顯示的表單模板