表單建模中接口文檔

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

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

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

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

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

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

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

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

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

10、是專業(yè) .專注.用于調用根據(jù)實際自定義的action 動作 。 DML 接口動作 ：界面話的形式配置增，刪，改操作 。配置方法1、 外部接口 action 動作配置動作如下A、 在系統(tǒng)菜單 【設置】 【設置中心 】 【外部接口設置 】【配置接口動作 】頁面如下圖在此頁面上右鍵“新建 ”按鈕可以創(chuàng)建一個新建的接口動作頁面如下圖。ModeTestAction類的實例代碼如下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();/獲取明細表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();(" 明細字段 ： "+name+" "+value);專業(yè) .專注.return Action.SUCCESS;B、 以上配置完之后在頁面擴展頁面外部接口動作選擇新建的ModeTestAction動作以上配置完之后點擊此頁面擴展會執(zhí)行