表單建模中接口文檔

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

2、明10配置方法11實(shí)施注意13第一部分 流程轉(zhuǎn)數(shù)據(jù)功能說(shuō)明該功能主要用于在流程在離開(kāi)或者到達(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ō)明：n WorkflowToMode這個(gè)action的作用是把流程數(shù)據(jù)轉(zhuǎn)換為模塊卡片數(shù)據(jù)，所以需要檢查WorkflowToMode此接口動(dòng)作標(biāo)識(shí)是否存在 如果不存在則自己添加此action。n 接口動(dòng)作標(biāo)識(shí)：WorkflowToModen 接口動(dòng)作類(lèi)文件：erfaces.acti

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

4、前操作者作為模塊的創(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字段的值寫(xiě)進(jìn)A字段中。3、如果上圖頁(yè)面中是否啟用勾選之后，我們?cè)趯?duì)應(yīng)的流程中設(shè)置的觸發(fā)節(jié)點(diǎn)上我們可以看到“節(jié)點(diǎn)后附加操作”后面會(huì)打勾 具體如下圖點(diǎn)擊上圖中的“節(jié)點(diǎn)后附加操作”我們可以看到的頁(yè)面如下圖，接口動(dòng)作：action.Workfl

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

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

7、寫(xiě)設(shè)置：【流程觸發(fā)成功時(shí)】表示流程觸發(fā)成功時(shí)執(zhí)行此處的內(nèi)容，【流程觸發(fā)失敗時(shí)】表示流程觸發(fā)失敗時(shí)執(zhí)行此處的內(nèi)容。模塊當(dāng)前操作人：此模塊的當(dāng)前操作者為被觸發(fā)流程的創(chuàng)建人。模塊創(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è)置A字段對(duì)應(yīng)B字段 模塊觸發(fā)數(shù)據(jù)審批的時(shí)候會(huì)把B字段的值寫(xiě)入A字段中。2、 根據(jù)上面步驟設(shè)置完之后，接下來(lái)需要設(shè)置的就是做如何動(dòng)作去觸發(fā)

8、這個(gè)數(shù)據(jù)審批，比如我們的功能說(shuō)明中需求是在卡片保存的時(shí)候去觸發(fā)流程。要實(shí)現(xiàn)此需求的步驟如下在【設(shè)置】【設(shè)置中心】【表單建模】點(diǎn)擊具體的模塊接口設(shè)置頁(yè)面擴(kuò)展中 找到擴(kuò)展名為“保存（新建保存）”如下圖點(diǎn)開(kāi)此頁(yè)面中的擴(kuò)展名稱(chēng)為“保存（新建保存）”頁(yè)面如下圖勾選頁(yè)面上的是否觸發(fā)審批工作流程 保存即可。以上步驟設(shè)置完之后，則是表示在此模塊新建的保存數(shù)據(jù)的時(shí)候 會(huì)去觸發(fā)“數(shù)據(jù)審批”頁(yè)面中配置的流程。進(jìn)行數(shù)據(jù)審批。實(shí)施注意1、 數(shù)據(jù)審批中的回寫(xiě)設(shè)置，修改的是模塊的主字段值。修改多個(gè)則中間用逗號(hào)隔開(kāi)。2、 被觸發(fā)流程的數(shù)據(jù)導(dǎo)入下的字段對(duì)應(yīng)關(guān)系一定要對(duì)應(yīng)好，如果字段類(lèi)型對(duì)應(yīng)不一致的話(huà) 此功能配置完之后也會(huì)不起作

9、用。比如模塊關(guān)聯(lián)的表單中字段a是整數(shù)類(lèi)型，流程關(guān)聯(lián)的表單中的b字段是字符類(lèi)型 如果將a字段對(duì)應(yīng)b字段的話(huà) 這樣的話(huà)肯定會(huì)報(bào)錯(cuò)的 因?yàn)槲覀償?shù)據(jù)庫(kù)中也不支持將字符類(lèi)型的數(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)作是用于調(diào)用根據(jù)實(shí)際自定義的action動(dòng)作。DML接口動(dòng)作：界面話(huà)的形式配置增，刪，改操作。 配置方法1、 外部接口action動(dòng)作配置動(dòng)作如下A、 在系統(tǒng)菜單【設(shè)置】【設(shè)置中心】【外部接口設(shè)置】【

10、配置接口動(dòng)作】頁(yè)面如下圖在此頁(yè)面上右鍵“新建”按鈕可以創(chuàng)建一個(gè)新建的接口動(dòng)作頁(yè)面如下圖。ModeTestAction類(lèi)的實(shí)例代碼如下package erfaces.workflow.action;import mons.logging.Log;import mons.logging.LogFactory;import weaver.general.Util;import erfaces.datasource.DataSource;import weaver.soa.workflow.request.Cell;import weaver.soa.workf

11、low.request.DetailTable;import weaver.soa.workflow.request.Property;import weaver.soa.workflow.request.RequestInfo;import weaver.soa.workflow.request.Row;public class ModeTestAction implements Action private Log log = LogFactory.getLog(ModeTestAction.class.getName(); private DataSource ds; public Da

12、taSource getDs() return ds; public void setDs(DataSource 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(); P

13、roperty properties = request.getMainTableInfo().getProperty();/ 獲取表單主字段信息for (int i = 0; i 0) for (int i = 0; i detailtable.length; i+) DetailTable 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); return Action.SUCCESS; B、 以上配置完之后在頁(yè)面擴(kuò)展頁(yè)面外部接口動(dòng)作選擇新建的ModeTestAc