自定義平臺實(shí)施手冊

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

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

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

每個(gè)畫面都可以設(shè)置一個(gè)后臺觸發(fā)程序。頁面后臺程序需要繼承m.TracePublicPageProcess,并實(shí)現(xiàn)其中定義的方法。m.TracePublicPageProcess公共變量說明dataMap方法名說明publicabstractStringcreateBefore();新建方法運(yùn)行前觸發(fā)publicabstractStringupdateBefore();修改方法運(yùn)行前觸發(fā)publicabstractStringdeleteBefore();刪除方法運(yùn)行前觸發(fā)publicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);保存方法運(yùn)行前觸發(fā)參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);保存方法運(yùn)行后觸發(fā)參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組參數(shù)yesFlg當(dāng)前審批者是否同意2.4.2流程后臺觸發(fā)程序一個(gè)模塊可以設(shè)置一個(gè)流程后臺觸發(fā)程序。頁面后臺程序需要繼承m.TracePublicProcess,并實(shí)現(xiàn)其中定義的方法。m.TracePublicProcess公共變量說明dataMap方法名說明publicabstractMapcreateTraceInit();新建表單時(shí)，初使值的設(shè)置畫面PublicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);新建流程后在發(fā)送審批前觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組publicabstractStringcreateTraceAfterBySend(MapmainRecord,MaplistRecordArray);新建流程后在發(fā)送審批后觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組publicabstractStringcreateTraceAfterBySave(MapmainRecord,MaplistRecordArray);新建流程后保存前觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組publicabstractStringtraceBefore(MapmainRecord,MaplistRecordArray);每步審批前觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組publicabstractStringtraceAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);每步審批后觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組參數(shù)yesFlg當(dāng)前審批者是否同意publicabstractStringbackTraceBefore(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文前觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組參數(shù)backToCreaterFlg是否是退文到創(chuàng)建人publicabstractStringbackTrace(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文時(shí)觸發(fā)的事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組參數(shù)backToCreaterFlg是否是退文到創(chuàng)建人publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);審批結(jié)束后事件參數(shù)mainRecord操作主表記錄參數(shù)listRecordArray操作細(xì)表記錄數(shù)組參數(shù)yesFlg當(dāng)前審批者是否同意后臺觸發(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”)獲得當(dāng)前流程的審批步驟lddataMap.get("currentStepName”)獲得當(dāng)前流程的審批步驟名稱dataMap.get("currentStepTraceActionlc”)獲得審批動作iddataMap.get("currentStepTraceActionName”)獲得審批動作名稱dataMap.get("currentTraceUserld”)獲得當(dāng)前審批人lddataMap.get("currentTraceUserName”)獲得當(dāng)前審批人用戶名dataMap.get("currentTraceUserDeptld”)獲得當(dāng)前審批人部門lddataMap.get("currentTraceUserDeptName”)獲得當(dāng)前審批人的部門名稱dataMap.get("currentTraceUserRoleld”)獲得當(dāng)前審批人的崗位lddataMap.get("currentTraceUserRoleName”)獲得當(dāng)前審批人的崗位名稱dataMap.get("currentTraceUserLeaderlc”)獲得當(dāng)前審批人的直屬領(lǐng)導(dǎo)lddataMap.get("currentTraceUserLeaderName”)獲得當(dāng)前審批人的直屬領(lǐng)導(dǎo)姓名dataMap.get("currentTraceUserTraceMinc”)獲得當(dāng)前審批步驟的審批意見dataMap.get("currentTraceUserTraceMindState’)獲得當(dāng)前審批步驟的審批狀態(tài)dataMap.get("currentTraceUserTraceDateTime’)獲得當(dāng)前審批步驟的審批操作時(shí)間dataMap.get(“nextStepId”)獲得審批流程的下一步驟lddataMap.get(“nextStepTitle”)獲得審批流程的下一步驟名稱dataMap.get(“nextStepName”)獲得審批流程的下一步驟動作名稱dataMap.get(“nextStepTraceUserldLisf)獲得下一審批步驟的審批人ld列表dataMap.get(“nextStepTraceUserNameLisf)獲得下一審批步驟的審批人名稱列表dataMap.get("traceTitle”)申請標(biāo)題dataMap.get("createTraceUserCreateDateTime”)申請時(shí)間dataMap.get("createTraceUserld”)申請人用戶iddataMap.get("createTraceUserName”)申請人用戶名稱dataMap.get("createTraceUserDeptld”)申請人部門ld

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

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

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

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