Ecology8數(shù)據(jù)展現(xiàn)及流程觸發(fā)集成操作手冊V1.0.doc

流程展現(xiàn)及流程觸發(fā)集成操作手冊V1.01. WebService注冊一、概述目前很多軟件為了便于和其它軟件進行集成，都開發(fā)了WebService接口，通過這些接口可以和第三方軟件進行數(shù)據(jù)的交互功能，這里的WebService注冊就是在E-cology中集中登記其它軟件的WebService接口及相關的參數(shù)，這樣我們在后臺管理的時候可以直接調(diào)用這些接口。二、注冊設置1、點擊【W(wǎng)ebService注冊】菜單后顯示如圖1所示圖1 點擊【新建】按鈕可以注冊WebService信息； 選中已注冊的WebService后點擊【刪除】按鈕后可以刪除選中的信息； 列表菜單只有【編輯】和【刪除】按鈕，點擊后可以編輯刪除注冊信息。2、在圖1中點擊【新建】按鈕后顯示如圖2所示，開始注冊WebService信息圖2 自定義名稱中填寫WebService服務的名稱，在后期調(diào)用的時候會看到這個名稱，所以命名最后能夠代表此WebService服務是干嘛用的； WebService地址：非常重要的內(nèi)容，此地址是由第三方軟件供應商提供的，如果沒有提供就不能使用這個功能，配置完成后可以點擊【解析WSDL】以確保接口地址正確，點擊【檢查更新】按鈕可以可以確保接口內(nèi)容有沒有變化； 點擊圖2中的添加按鈕，會在下方增加一行，配置WebService接口中提供的方法和參數(shù)字段等信息，這些信息都是由第三方軟件供應商所需要提供的，如圖3所示圖3 配置完成后需要點擊【保存】按鈕進行保存； 選中已有的方法，點擊按鈕可以刪除選中的方法； 方法列表字段功能顯示如下表，先來看一下圖3中紅框所示的方法所對應的WebService接口文件，如圖4所示，我們通過瀏覽器直接訪問WebService地址后看到的內(nèi)容圖4字段說明方法名稱其它模塊配置過程中可以調(diào)用的方法，此方法必需是寫在WebService接口內(nèi)容中的，如圖4中的【getAllModeDataList】，所以這些方法都是由提供WebService接口的軟件供應商提供描述針對此方法的文字描述，主要是便于其它管理員了解此接口的作用返回值類型接口返回數(shù)值的類型，在后期調(diào)用接口方法的時候，E-cology字段的類型一致參數(shù)名稱寫在方法之后的參數(shù)名稱，這些名稱也在WebService接口文件中可以看到，如圖4中的in0in7參數(shù)類型對應參數(shù)的類型，在WebService接口文件中可以看到，如圖4中type后面跟的就是參數(shù)字段的類型是否數(shù)組只有數(shù)組型的參數(shù)才需要選中2. 數(shù)據(jù)展現(xiàn)集成一、概述數(shù)據(jù)展現(xiàn)集成就是通過瀏覽按鈕的方式展示外部數(shù)據(jù)源的數(shù)據(jù)，常被用作自定義瀏覽框的設置和自定義查詢菜單的設置。二、數(shù)據(jù)展現(xiàn)集成設置1、點擊【數(shù)據(jù)展現(xiàn)集成】菜單后顯示如圖1所示圖1 點擊【新建】按鈕可以創(chuàng)建新的自定義瀏覽框； 選中已有的自定義瀏覽按鈕后點擊【刪除】可以批量刪除選中的自定義瀏覽框； 列表菜單只有【編輯】和【刪除】兩個按鈕，點擊后可以編輯和刪除當前的自定義瀏覽框。2、在圖1中點擊【新建】按鈕后顯示如圖2所示圖2 標識：自定義數(shù)據(jù)查詢頁面的名稱，必需是唯一的； 名稱：此自定義查詢數(shù)據(jù)的名稱，一般用中文表示，告知需要用到此查詢功能的用戶這個是查詢什么內(nèi)容的； 展現(xiàn)形式：展現(xiàn)形式分為了【瀏覽框】和【查詢頁面】兩種，瀏覽框的話可以在流程表單中設置了自定義瀏覽框類型的字段時調(diào)用，查詢頁面可以在自定義菜單等頁面進行調(diào)用； 展現(xiàn)方式：選擇瀏覽框中內(nèi)容的展現(xiàn)方式，只有展現(xiàn)形式是【瀏覽框】時才需要設置，可以采用列表式、樹形方式，如果采用自定義頁面的話，顯示如圖3所示，只要直接設置自定義頁面地址就可以了，其它信息不用設置了。圖3 數(shù)據(jù)來源：數(shù)據(jù)來源可以分為數(shù)據(jù)庫、WebService接口、自定義接口三種，每種接口配置不完全一樣 數(shù)據(jù)源查詢 數(shù)據(jù)源：查詢數(shù)據(jù)的來源數(shù)據(jù)庫，數(shù)據(jù)源需要在【數(shù)據(jù)源設置】中先設好； 查詢SQL語句：編寫查詢語句，控制瀏覽按鈕的查詢顯示結果； WebService查詢 WebService地址：在WebService注冊中記錄接口名稱，通過下拉選擇框選擇； WebService方法：屬于這個接口的具體方法； 自定義地址查詢 已經(jīng)在第三方的頁面中編寫了查詢方法，這里直接調(diào)用那個查詢方法的文件； 主鍵：查詢的主標示字段名稱； 外部頁面地址： 列表式查詢頁面中必需設置頁面中的查詢條件和顯示字段列，點擊下方的進行添加； 如果是樹形展示字段的話，需要制定父字段和子字段在外部數(shù)據(jù)源中的名稱，如圖4所示。圖4三、實例介紹1.數(shù)據(jù)展現(xiàn)集成-展現(xiàn)類型-瀏覽框（即E7及以下版本的自定義瀏覽按鈕）以表ID_0為例子：E7及以下版本的自定義瀏覽按鈕設置及瀏覽按鈕查詢結果展示：E8版本的自定義瀏覽按鈕設置：數(shù)據(jù)庫中存的值為主鍵字段標題欄的作用：l瀏覽框中的作用即是選擇后顯示的字段l查詢頁面中的作用即是提供超鏈接的字段瀏覽按鈕查詢結果展示：新增功能：l字段聯(lián)動：以表t_hrmresource、t_hrmdepartment為例：聯(lián)動條件字段在流程中的字段名稱為op_test_ld_bm（對應表t_hrmdepartment的內(nèi)容）需要聯(lián)動帶出的人員字段：設置方法A：直接在查詢sql中添加條件，聯(lián)動字段為$op_test_ld_bm$聯(lián)動字段如果都是在明細表中，聯(lián)動字段的寫法為：$formtable_main_748_dt1_bm_dl$其中，formtable_main_748_dt1是明細表表名，bm_dl為明細表中的字段名設置方法B：直接在查詢字段設置中的流程聯(lián)動字段名稱中填寫聯(lián)動字段名稱結果展示：l轉(zhuǎn)換方法：以表ID_0為例未使用轉(zhuǎn)換方法前，瀏覽按鈕顯示的結果：使用轉(zhuǎn)換方法：select email from id_0 WHERE loginid = ?currentvalue;瀏覽按鈕顯示的結果：特殊的SQL處理：當多表聯(lián)動時，可能會出現(xiàn)這些表中的主鍵一樣的問題，這種情況下，SQL語句做一層包裝，即可解決：例如：select d.id,d.departmentid, d.lastname|20150819 as lastname ,(case when sex = 1 then 女 when sex = 0 then 男 end) as Sex,(case when status = 0 then 試用 when status = 1 then 正式 when status = 2 then 臨時 when status = 3 then 試用延期 when status = 4 then 解聘 when status = 5 then 離職 when status = 6 then 退休 when status = 7 then 無效end) as status, f.jobtitlename, e.departmentname, g.subcompanyname from (select id,a.lastname,a.sex,a.status,a.departmentid,a.subcompanyid1,a.jobtitle from Hrmresource a where a.departmentid in (select b.id from Hrmdepartment b where b.subcompanyid1 in (selectc.idfrom Hrmsubcompany c where substr(id,1,2)=$wenben$) d left join Hrmjobtitles f on d.jobtitle =f.id left join Hrmdepartment e on d.departmentid =e.id left join Hrmsubcompany g on d.subcompanyid1 =g.id where d.lastname like %y% order by d.departmentid由于各表中都有id這個主鍵，所以導致此SQL無法正常使用修改為以下內(nèi)容即可：select * from(select d.id,d.departmentid, d.lastname|20150819 as lastname ,(case when sex = 1 then 女 when sex = 0 then 男 end) as Sex,(case when status = 0 then 試用 when status = 1 then 正式 when status = 2 then 臨時 when status = 3 then 試用延期 when status = 4 then 解聘 when status = 5 then 離職 when status = 6 then 退休 when status = 7 then 無效end) as status, f.jobtitlename, e.departmentname, g.subcompanyname from (select id,a.lastname,a.sex,a.status,a.departmentid,a.subcompanyid1,a.jobtitle from Hrmresource a where a.departmentid in (select b.id from Hrmdepartment b where b.subcompanyid1 in (select c.id from Hrmsubcompany c where substr(id,1,2)=$wenben$) d left join Hrmjobtitles f on d.jobtitle = f.id left join Hrmdepartment e on d.departmentid = e.id left join Hrmsubcompany g on d.subcompanyid1 = g.id where d.lastname like %y%)a order by departmentid2.數(shù)據(jù)展現(xiàn)集成-展現(xiàn)類型-查詢頁面（新功能）該功能主要是和異構系統(tǒng)待辦元素集成功能一起使用的，設置方式和自定義瀏覽按鈕基本沒有區(qū)別（字段聯(lián)動無效），異構系統(tǒng)待辦元素集成功能介紹參考附件中的【120389】新增功能：異構系統(tǒng)待辦元素集成功能?；仫@異常回顯異常是指 配置完成并在流程上正常瀏覽并選擇數(shù)據(jù)后，流程提交或保存頁面再次打開，之前選擇的數(shù)據(jù)消失或者顯示錯誤。可以依次嘗試如下解決方案：當前在后臺配置的sql，你的SQL： select id , a ,b from d where b=xxx1，select * from ( 你的SQL ) t -使用包裹層2，select * from ( select id , a ,b from dWHERE b=xxx ) t -將你的SQL中的所有where大寫3，select * from ( selectregexp_replace(id,0-9a-zA-Z,) as id, a ,b from dWHERE b=xxx ) t -刪除字符串類型的主鍵中的特殊字符比如id值為： =asxn 102$ 其中有 等號/空格/$符 3種類型的特殊字符，則：oracle : regexp_replace(id,0-9a-zA-Z,)sqlserver：Replace(Replace(Replace(id, ,),=,),$,)主鍵要求：主鍵不要有字母數(shù)字以外的其它字符。4，邏輯悖論類型：數(shù)據(jù)來源 d 是一個視圖，視圖內(nèi)涵邏輯條件：已經(jīng)被選擇過的數(shù)據(jù)，不再出現(xiàn)在候選列表中。此中情況下造成的不能回顯，無法解決；請實施人員自行調(diào)整業(yè)務邏輯。此種邏輯，必定造成不能回顯！原因：瀏覽按鈕保存在OA數(shù)據(jù)庫中是僅僅是數(shù)據(jù)id，要回顯時，還是用配置的sql，加上id條件，去 d 視圖中查詢數(shù)據(jù)，但d視圖本身內(nèi)涵已經(jīng)選擇的數(shù)據(jù)不會出現(xiàn)在視圖中，導致根據(jù) id 再去 d 視圖查，就查不到數(shù)據(jù)，導致不能正常回顯。5，字符串類型的主鍵，選擇的是數(shù)據(jù) A，后臺id是 001；回顯成了數(shù)據(jù)B，B的id是 100101 之類。提交技術支持流程，總部提供更新文件，升級解決。6，表達式：$abc$ 用于在表單字段上取得當前表單值，?abc 用于取得某些默認的固定值。這兩種類型的表達式，所有字符必須全部是小寫字符7，select id , a ,b from d where b=$xxx$ and usercode=?workcode-表達式兩邊用單引號引用起來，以免未獲得值時后臺出現(xiàn)SQL執(zhí)行報錯8，select * from (select id , a ,b from d where b=空格$xxx$空格) t -表達式兩邊留出空格9，主鍵不唯一：使用此查詢關聯(lián)頁面其它字段時id唯一，如：select id , a ,b from d where type=$type$如果直接使用，則id不唯一，如：select id , a ,b from d方案1：-針對只做保存回顯，不在需要根據(jù)此字段值還聯(lián)動其它字段值的情況oracle: select * from (selecttype|_|id as id, a ,b from d where type= $type$ )t -使用type加id的形式組合成字符串類型聯(lián)合主鍵方案2：-其它字段要根據(jù)選擇的主鍵還要聯(lián)動出值，故而主鍵不能變。要求數(shù)據(jù)，同樣 id 的數(shù)據(jù)除過 type 區(qū)分外，要顯示的 a 字段值都一樣。oracle: select * from (selectid , a ,max(b) as bfrom dwheretype= $type$group by id,a) t -使用分組函數(shù)10，使用了固定取值表達式： ?userid ?loginid ?username ?workcode ?password ?departmentid ?departmentcode ?departmentname ?subcompanyid ?subcompanycode ?subcompanyname這些表達式在創(chuàng)建節(jié)點第一次選擇值時，會帶出當前登錄者相關的對應信息，但后續(xù)表單值已經(jīng)保存后回顯時，于此相關的條件都會替換成 1=1 ，編寫SQL時，一定要考慮回顯會忽略人的問題，考慮到人這個條件被替換成 1=1 時，sql 附加上選中的 id 作為條件，是否還能正常查詢，并返回唯一的一條數(shù)據(jù)。編寫SQL ： select id , a ,b from d whereb=?departmentcode自動計算出的回顯SQL ：select id , a ,b from d where1=1and id=表單上保存的id11，剛建立流程并提交的幾天數(shù)據(jù)正?；仫@，過一段時間后選擇的數(shù)據(jù)回顯不了：檢查 SQL 或 視圖 中是否有取數(shù)據(jù)庫時間類型的函數(shù)如：sysdate，getdate() 等。selectid , a ,b from dwhere b=to_char(sysdate, MM)此 SQL 意為只提供本月的數(shù)據(jù)以供選擇。 但選擇后，會導致只有在每年的本月（如12月），數(shù)據(jù)在流程上正常回顯，其它月份流程上此選擇的數(shù)據(jù)都回顯不了。因為選擇的數(shù)據(jù) id 是屬于 12 月里的，如果到了非 12 月的時候，能查出的數(shù)據(jù)里面，本就沒有了此條數(shù)據(jù)，那么相當于（1月時）：selectid , a ,b from dwhere b=01 and id=表單上保存的12月的id此條回顯 SQL 不能查詢到數(shù)據(jù)，故而不能正?；仫@。屬于上面的第四點，邏輯悖論。解決方案：在流程表單上增加一個日期(或月份)類型字段，默認當前時間，查詢sql中使用此字段表達式。selectid , a ,b from dwhere b=$createMonth$12, 使用了數(shù)據(jù)庫函數(shù)：getdate() 等。流程點開放大鏡后頁面沒數(shù)據(jù)。提交技術支持流程，總部提供更新文件（針對性不整理到標準產(chǎn)品的修改），升級解決。13,WebService示例注：首先在W