表單建模中接口文檔

1、.僅限閱讀請(qǐng)勿傳播當(dāng)您閱讀本方案時(shí)，即表示您同意不傳播本方案的所有內(nèi)容泛微協(xié)同辦公應(yīng)用平臺(tái)表單建模接口文檔專業(yè) .專注.版本文檔簡(jiǎn)要信息:文檔主題 (Title)泛微協(xié)同辦公應(yīng)用平臺(tái)表單建模接口文檔作者 (Author)肖榮娟審批者 (To Be Approved By)說(shuō)明 (Comments)文件名稱 (File Name)泛微協(xié)同辦公應(yīng)用平臺(tái)表單建模接口文檔.doc文檔版本歷史:序號(hào)日期版本變更說(shuō)明修改人注釋1.2014-03-04V1.0肖榮娟.專業(yè) .專注.目錄版本2第一部分流程轉(zhuǎn)數(shù)據(jù)4功能說(shuō)明4配置方法4實(shí)施注意7第二部分?jǐn)?shù)據(jù)審批8功能說(shuō)明8配置方法8實(shí)施注意10第三

2、部分頁(yè)面擴(kuò)展中的接口動(dòng)作10功能說(shuō)明10配置方法11實(shí)施注意13專業(yè) .專注.第一部分 流程轉(zhuǎn)數(shù)據(jù)功能說(shuō)明該功能主要用于在流程在離開或者到達(dá)某個(gè)節(jié)點(diǎn)的時(shí)候，將流程表單上的數(shù)據(jù)插入到模塊關(guān)聯(lián)的表單中。此功能暫不支持，流程關(guān)聯(lián)的明細(xì)表單觸發(fā)模塊數(shù)據(jù)。配置方法1、在菜單 【設(shè)置】 【設(shè)置中心 】 【外部接口設(shè)置 】 【配置接口動(dòng)作 】頁(yè)面中如下圖說(shuō)明：WorkflowToMode這個(gè)action的作用是把流程數(shù)據(jù)轉(zhuǎn)換為模塊卡片數(shù)據(jù)，所以需要檢查WorkflowToMode此接口動(dòng)作標(biāo)識(shí)是否存在如果不存在則自己添加此action 。接口動(dòng)作標(biāo)識(shí) ：WorkflowToMode接口動(dòng)作類文件： 2、在【

3、設(shè)置】 【設(shè)置中心 】 【表單建模 】 點(diǎn)擊具體的模塊 > 接口設(shè)置 > 流程轉(zhuǎn)數(shù)據(jù)頁(yè)面專業(yè) .專注.右鍵 “新建 ”按鈕頁(yè)面如下圖說(shuō)明：流程類型 ：選擇要觸發(fā)模塊的流程 。比如 通過(guò)內(nèi)部留言流程觸發(fā)生成此模塊的數(shù)據(jù)則 “流程類型 ”選擇內(nèi)部留言流程 。模塊名稱 ：此模塊的具體名稱在上圖頁(yè)面上選擇具體的流程之后，右鍵 點(diǎn)擊 “保存 ”按鈕頁(yè)面如下圖專業(yè) .專注.說(shuō)明：是否啟用 ：如果勾選表示此配置生效流程類型 ：具體流程類型模塊名稱 ：具體的模塊名稱觸發(fā)節(jié)點(diǎn) ：選擇具體流程所對(duì)應(yīng)的節(jié)點(diǎn)。觸發(fā)時(shí)間 ：【離開節(jié)點(diǎn) 】表示流程提交此節(jié)點(diǎn)觸發(fā)，【到達(dá)節(jié)點(diǎn) 】表示流程到達(dá)此節(jié)點(diǎn)的時(shí)候觸發(fā)。模

4、塊創(chuàng)建人 ：【流程當(dāng)前操作人】表示流程的當(dāng)前操作者作為模塊的創(chuàng)建人，【流程創(chuàng)建人 】表示此流程的創(chuàng)建者為此模塊的創(chuàng)建人，【流程人力資源相關(guān)字段】：表示此流程關(guān)聯(lián)表單中的人力資源字段中的值為此模塊的創(chuàng)建人。模塊數(shù)據(jù)導(dǎo)入 ：此處的作用是將模塊關(guān)聯(lián)表單的字段和流程關(guān)聯(lián)表單的字段對(duì)應(yīng)設(shè)置，比如模塊關(guān)聯(lián)表單中有單行文本的A 字段，流程關(guān)聯(lián)表單中有個(gè)單行文本的B字段在此處設(shè)置A字段對(duì)應(yīng) B 字段那么流程觸發(fā)的時(shí)候會(huì)把B 字段的值寫進(jìn)A 字段中 。3、如果上圖頁(yè)面中是否啟用勾選之后，我們?cè)趯?duì)應(yīng)的流程中設(shè)置的觸發(fā)節(jié)點(diǎn)上我們可以看到“節(jié)點(diǎn)后附加操作 ”后面會(huì)打勾具體如下圖專業(yè) .專注.點(diǎn)擊上圖中的 “節(jié)點(diǎn)后附加

5、操作 ”我們可以看到的頁(yè)面如下圖，接口動(dòng)作 ：action.WorkflowToMode后面的復(fù)選框勾選 。嚴(yán)格按照以上步驟配置完之后，流程轉(zhuǎn)數(shù)據(jù)功能方可使用。實(shí)施注意1、 WorkflowToMode此 action 一定要存在 ，不存在的話則此功能不起作用。2、 模塊數(shù)據(jù)導(dǎo)入下的字段對(duì)應(yīng)關(guān)系一定要對(duì)應(yīng)好，如果字段類型對(duì)應(yīng)不一致的話此功能配置完之后也會(huì)不起作用 。 比如模塊關(guān)聯(lián)的表單中字段a 是整數(shù)類型 ，流程關(guān)聯(lián)的表單中的b 字段是字符類型如果將 a 字段對(duì)應(yīng) b 字段的話這樣的話肯定會(huì)報(bào)錯(cuò)的因?yàn)槲覀償?shù)據(jù)庫(kù)中也不支持將字符類型的數(shù)據(jù)插入到整數(shù)列中 。3、流程節(jié)點(diǎn)中的“節(jié)點(diǎn)后附加操作”和“節(jié)

6、點(diǎn)前附加操作”點(diǎn)開的頁(yè)面，接口動(dòng)作：action.WorkflowToMode后面的復(fù)選框一定要是勾選上的，不勾選的話此功能也會(huì)不起作用。專業(yè) .專注.第二部分 數(shù)據(jù)審批功能說(shuō)明該功能主要用于將模塊數(shù)據(jù)觸發(fā)流程進(jìn)行數(shù)據(jù)審批。假如有這樣的需求客戶卡片上有個(gè)客戶狀態(tài)的字段，此字段為選擇框類型，選擇框的值有無(wú)效和無(wú)效兩個(gè)選項(xiàng) 。用戶要求在新建客戶卡片的時(shí)候客戶狀態(tài)為無(wú)效然后保存此卡片的時(shí)候觸發(fā)一條流程，此流程的目的是審批這個(gè)客戶是否有效如果客戶審批通過(guò)之后則把此客戶卡片中的客戶狀態(tài)改成有效。實(shí)現(xiàn)以上需求則可以用此功能來(lái)實(shí)現(xiàn)。配置方法1、 在系統(tǒng)中菜單為【設(shè)置】 【設(shè)置中心 】 【表單建模 】 點(diǎn)擊具

7、體的模塊接口設(shè)置數(shù)據(jù)審批頁(yè)面如下圖說(shuō)明：模塊名稱 ：此模塊的具體名稱信息被觸發(fā)流程類型：被處罰的具體流程信息回寫設(shè)置 ：【流程觸發(fā)成功時(shí)】表示流程觸發(fā)成功時(shí)執(zhí)行此處的內(nèi)容，【流程觸發(fā)失敗時(shí)】表示流程觸發(fā)失敗時(shí)執(zhí)行此處的內(nèi)容。模塊當(dāng)前操作人：此模塊的當(dāng)前操作者為被觸發(fā)流程的創(chuàng)建人。專業(yè) .專注.模塊創(chuàng)建人 ：此模塊的創(chuàng)建者為被觸發(fā)流程的創(chuàng)建人。模塊人力資源相關(guān)字段：表示此模塊關(guān)聯(lián)的卡片中人力資源字段的值為被觸發(fā)流程的創(chuàng)建人。被觸發(fā)流程的數(shù)據(jù)導(dǎo)入：此處的作用是將流程關(guān)聯(lián)表單的字段和模塊關(guān)聯(lián)表單的字段對(duì)應(yīng)設(shè)置，比如流程關(guān)聯(lián)表單中有單行文本的A 字段，模塊關(guān)聯(lián)表單中有個(gè)單行文本的B 字段 在此處設(shè)置

8、A 字段對(duì)應(yīng) B 字段 模塊觸發(fā)數(shù)據(jù)審批的時(shí)候會(huì)把 B 字段的值寫入 A字段中。2、 根據(jù)上面步驟設(shè)置完之后，接下來(lái)需要設(shè)置的就是做如何動(dòng)作去觸發(fā)這個(gè)數(shù)據(jù)審批，比如我們的功能說(shuō)明中需求是在卡片保存的時(shí)候去觸發(fā)流程。要實(shí)現(xiàn)此需求的步驟如下在【設(shè)置 】 【設(shè)置中心 】 【表單建模 】 點(diǎn)擊具體的模塊接口設(shè)置頁(yè)面擴(kuò)展中找到擴(kuò)展名為“保存（新建保存 ）”如下圖點(diǎn)開此頁(yè)面中的擴(kuò)展名稱為“保存（新建保存 ）”頁(yè)面如下圖專業(yè) .專注.勾選頁(yè)面上的是否觸發(fā)審批工作流程保存即可 。以上步驟設(shè)置完之后，則是表示在此模塊新建的保存數(shù)據(jù)的時(shí)候會(huì)去觸發(fā) “數(shù)據(jù)審批 ”頁(yè)面中配置的流程。 進(jìn)行數(shù)據(jù)審批 。實(shí)施注意1、 數(shù)

9、據(jù)審批中的回寫設(shè)置，修改的是模塊的主字段值 。修改多個(gè)則中間用逗號(hào)隔開 。2、 被觸發(fā)流程的數(shù)據(jù)導(dǎo)入下的字段對(duì)應(yīng)關(guān)系一定要對(duì)應(yīng)好，如果字段類型對(duì)應(yīng)不一致的話此功能配置完之后也會(huì)不起作用 。 比如模塊關(guān)聯(lián)的表單中字段a 是整數(shù)類型 ，流程關(guān)聯(lián)的表單中的b 字段是字符類型 如果將 a字段對(duì)應(yīng) b 字段的話 這樣的話肯定會(huì)報(bào)錯(cuò)的因?yàn)槲覀償?shù)據(jù)庫(kù)中也不支持將字符類型的數(shù)據(jù)插入到整數(shù)列中 。3、 新建的一個(gè)頁(yè)面擴(kuò)展頁(yè)面中的是否觸發(fā)審批工作流程勾選的點(diǎn)擊此頁(yè)面擴(kuò)展也會(huì)觸發(fā)數(shù)據(jù)審批。第三部分 頁(yè)面擴(kuò)展中的接口動(dòng)作功能說(shuō)明頁(yè)面擴(kuò)展中的接口動(dòng)作分為外部接口動(dòng)作和其他接口動(dòng)作（DML接口動(dòng)作 ）， 其中外部接口動(dòng)作

10、是專業(yè) .專注.用于調(diào)用根據(jù)實(shí)際自定義的action 動(dòng)作 。 DML 接口動(dòng)作 ：界面話的形式配置增，刪，改操作 。配置方法1、 外部接口 action 動(dòng)作配置動(dòng)作如下A、 在系統(tǒng)菜單 【設(shè)置】 【設(shè)置中心 】 【外部接口設(shè)置 】【配置接口動(dòng)作 】頁(yè)面如下圖在此頁(yè)面上右鍵“新建 ”按鈕可以創(chuàng)建一個(gè)新建的接口動(dòng)作頁(yè)面如下圖。ModeTestAction類的實(shí)例代碼如下able;public class ModeTestAction implements Action 專業(yè) .專注.public DataSource getDs() return ds;public void setDs(Da

11、taSource ds) this.ds = ds;public Log getLog() return log;public void setLog(Log log) this.log = log;public String execute(RequestInfo request) ("do mode action on mode data :"+request.getRequestid();("modeid:"+request.getWorkflowid();Propertyproperties= request.ge

12、tMainTableInfo().getProperty();/獲取表單主字段信息for (int i = 0; i < properties.length; i+) /主表數(shù)據(jù)String name = propertiesi.getName().toLowerCase();String value = Util.null2String(propertiesi.getValue();(" 主字段 ： "+name+" "+value);DetailT able detailtable = request.getDetailTabl

13、eInfo().getDetailTable();/獲取明細(xì)表if (detailtable.length > 0) for (int i = 0; i < detailtable.length; i+) DetailT able dt = detailtablei;Row s = dt.getRow();for (int j = 0; j < s.length; j+) Row r = sj;Cell c = r.getCell();for (int k = 0; k < c.length; k+) Cell c1 = ck;String name = c1.getName();String value = c1.getValue();(" 明細(xì)字段 ： "+name+" "+value);專業(yè) .專注.return Action.SUCCESS;B、 以上配置完之后在頁(yè)面擴(kuò)展頁(yè)面外部接口動(dòng)作選擇新建的ModeTestAction動(dòng)作以上配置完之后點(diǎn)擊此頁(yè)面擴(kuò)展會(huì)執(zhí)行