表單建模中接口文檔

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

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

3、設(shè)置】 【設(shè)置中心 】 【表單建模 】 點(diǎn)擊具體的模塊 > 接口設(shè)置 > 流程轉(zhuǎn)數(shù)據(jù)頁面專業(yè) .專注.右鍵 “新建 ”按鈕頁面如下圖說明：流程類型 ：選擇要觸發(fā)模塊的流程 。比如 通過內(nèi)部留言流程觸發(fā)生成此模塊的數(shù)據(jù)則 “流程類型 ”選擇內(nèi)部留言流程 。模塊名稱 ：此模塊的具體名稱在上圖頁面上選擇具體的流程之后，右鍵 點(diǎn)擊 “保存 ”按鈕頁面如下圖專業(yè) .專注.說明：是否啟用 ：如果勾選表示此配置生效流程類型 ：具體流程類型模塊名稱 ：具體的模塊名稱觸發(fā)節(jié)點(diǎn) ：選擇具體流程所對應(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)表單的字段對應(yīng)設(shè)置，比如模塊關(guān)聯(lián)表單中有單行文本的A 字段，流程關(guān)聯(lián)表單中有個單行文本的B字段在此處設(shè)置A字段對應(yīng) B 字段那么流程觸發(fā)的時(shí)候會把B 字段的值寫進(jìn)A 字段中 。3、如果上圖頁面中是否啟用勾選之后，我們在對應(yīng)的流程中設(shè)置的觸發(fā)節(jié)點(diǎn)上我們可以看到“節(jié)點(diǎn)后附加操作 ”后面會打勾具體如下圖專業(yè) .專注.點(diǎn)擊上圖中的 “節(jié)點(diǎn)后附加

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

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

7、體的模塊接口設(shè)置數(shù)據(jù)審批頁面如下圖說明：模塊名稱 ：此模塊的具體名稱信息被觸發(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)表單的字段對應(yīng)設(shè)置，比如流程關(guān)聯(lián)表單中有單行文本的A 字段，模塊關(guān)聯(lián)表單中有個單行文本的B 字段 在此處設(shè)置

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

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

10、是專業(yè) .專注.用于調(diào)用根據(jù)實(shí)際自定義的action 動作 。 DML 接口動作 ：界面話的形式配置增，刪，改操作 。配置方法1、 外部接口 action 動作配置動作如下A、 在系統(tǒng)菜單 【設(shè)置】 【設(shè)置中心 】 【外部接口設(shè)置 】【配置接口動作 】頁面如下圖在此頁面上右鍵“新建 ”按鈕可以創(chuàng)建一個新建的接口動作頁面如下圖。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、 以上配置完之后在頁面擴(kuò)展頁面外部接口動作選擇新建的ModeTestAction動作以上配置完之后點(diǎn)擊此頁面擴(kuò)展會執(zhí)行