表單建模中接口文檔

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

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

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

5、owToMode后面的復(fù)選框勾選。嚴(yán)格按照以上步驟配置完之后，流程轉(zhuǎn)數(shù)據(jù)功能方可使用。實施注意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字段的話 這樣的話肯定會報錯的 因為我們數(shù)據(jù)庫中也不支持將字符類型的數(shù)據(jù)插入到整數(shù)列中。3、 流程節(jié)點中的“節(jié)點后附加操作”和“節(jié)點前附加操作”點開的頁面，接口動作：action.WorkflowToMode后面的復(fù)選框

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

7、寫設(shè)置：【流程觸發(fā)成功時】表示流程觸發(fā)成功時執(zhí)行此處的內(nèi)容，【流程觸發(fā)失敗時】表示流程觸發(fā)失敗時執(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)表單的字段對應(yīng)設(shè)置，比如流程關(guān)聯(lián)表單中有單行文本的A字段，模塊關(guān)聯(lián)表單中有個單行文本的B字段 在此處設(shè)置A字段對應(yīng)B字段 模塊觸發(fā)數(shù)據(jù)審批的時候會把B字段的值寫入A字段中。2、 根據(jù)上面步驟設(shè)置完之后，接下來需要設(shè)置的就是做如何動作去觸發(fā)

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

9、用。比如模塊關(guān)聯(lián)的表單中字段a是整數(shù)類型，流程關(guān)聯(lián)的表單中的b字段是字符類型 如果將a字段對應(yīng)b字段的話 這樣的話肯定會報錯的 因為我們數(shù)據(jù)庫中也不支持將字符類型的數(shù)據(jù)插入到整數(shù)列中。3、 新建的一個頁面擴展 頁面中的是否觸發(fā)審批工作流程勾選的 點擊此頁面擴展也會觸發(fā)數(shù)據(jù)審批。第三部分 頁面擴展中的接口動作功能說明頁面擴展中的接口動作分為外部接口動作和其他接口動作（DML接口動作），其中外部接口動作是用于調(diào)用根據(jù)實際自定義的action動作。DML接口動作：界面話的形式配置增，刪，改操作。 配置方法1、 外部接口action動作配置動作如下A、 在系統(tǒng)菜單【設(shè)置】【設(shè)置中心】【外部接口設(shè)置】【

10、配置接口動作】頁面如下圖在此頁面上右鍵“新建”按鈕可以創(chuàng)建一個新建的接口動作頁面如下圖。ModeTestAction類的實例代碼如下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();(明細字段：+name+ +value); return Action.SUCCESS; B、 以上配置完之后在頁面擴展頁面外部接口動作選擇新建的ModeTestAc