AgilePoint 的流程變數

一般的工作流程或電子表單的軟體, 最常用的方式是一張表單, 一個流程, 通常也會對應至一個資料表, 因此我們會看到有些Workflow的軟體, 所強調的流程整合是利用表單資料轉換的方式來進行, 請購轉換為採購單, 採購單轉換為驗收單, 驗收單再轉換為付款單, 類似此種架構, 主要是因為他們的架構上表單與資料是密不可分的緣故.

clip_image002

AgilePoint 是採用前端輸出入介面, 流程, 資料三者分離的架構, 因此可視為三者是獨立存在.

我不將前端輸出入介面直接稱為表單, 而改稱為輸出入介面, 主要的原因是在AgilePoint 中資料與表單是分離的, 因此流程中所儲存的資料, 我們稱為Custom Attribute 我將他翻譯為流程變數, 其流程變數與表單並無絕對的關係.

clip_image002[5]

流程變數是串起整個流程資料的依據, 就像是網頁程式的Session 變數, 差別在於Session變數只存在於網頁連線的期間, 流程變數是存在於整個流程, 由流程啟動一直到流程完成後都會一直保留在資料庫中.

流程變數在流程資料庫中預設是以XML 的型式儲存, 其優點為無需預先定義資料格式, 可視需要隋時增加變數與修改變數的內容.

流程變數的產生有以下幾種方式:

1.啟動流程時一併建立流程變數.

在AgilePoint要啟動一個流程可以透過CreateProcInst() 的API , 其有兩種形式直接呼叫CreateProcInst()的API 或呼叫其所提供的WebService 介面, 視呼叫單所在的位置決定.

在此API 中可傳輸一個流程變數與資料名稱的陣列, 資料型態為其內定的NameValue[] 的格式, 簡單的說就是由名稱與值所組成的陣列.

因此在表單中輸入資料或外部應用系統如ERP 中只要能呼叫WebService 並且可組成NameValue的Array , 都可以在啟動流程時, 一併將外部資料傳送至AgilePoint 中.

2.透過AgilePoint 所提供的WebControl

在AgilePoint 所提供的WebControl 都有一個BindingName 的屬性, 呼叫啟動流程的API- CreateProcInst()或呼叫完成一個工作(WorkItem)的API – CompletedWorkItem() 時係統會自動將所有具有BindingName 屬性的WebControl 都儲存為流程變數.

3.透過儲存或取得流程變數的API

除了採用具有BiningName 的WebControl 外, 對一般的Asp.net 或ThirdParty所提供的WebControl , 甚至流程資料與顯示無關時都可以透過存取流程變數的API –setCustomAttr()設定單一變數或一次設定多個變數的API -setCustomAttrs()將所需要的資料設定為流程變數, 且無需考慮變數資料是否已經存在, 系統或自動處理新增變數或修改變數的問題.

另外如果需要取得變數的內容亦可透過取得變數的API-getCustomAttr() 取得指定的變數或透過getCustomAttrs()一次取得整個流程的變數, 傳回的資料型態是一個物件的形態, 可視需要作轉型, 如變數資料不存在會傳回null值,因此可依內容作預設值的處理.

以上三種方式是基本的流程變數取得與儲存的方式, 因此任何只要能呼叫WebService的程式或語言都可以透過上述方式與透過流程元件互相溝通.

前面提到流程變數是以XML的形式存在, 惟XML 的缺點是不適合直接查詢特定欄位值或輸出為為報表, 因此必要時我們可以透過AgilePoint提供的資料庫存取元件或客制的AgilePart 將其轉存為一般的資料表, 再作後續的運用.

留言

張貼留言

這個網誌中的熱門文章

如何使用SQL Profiler 找到語法錯誤

圖片
  SQL Profiler 我們在執行SQL 語法時, 常發生SQL Server 端的錯誤, 但無法直接由Client 端的訊息看出來,此時我們可透過SQL Profiler 來找到Server 執行的錯誤, 只是Server 端的事件那麼多該如何找到錯誤呢? 一個很重要的觀念, SQL Server 不論執行的結果如何, 正確或錯誤都會產生Complete的事件, 如 StoreProcedure 的 SP:Completed/StmtCompleted   一般SQL 的SQL:StmtCompleted / BatchCompleted. 奇怪了, 都錯了怎麼還有BatchCompleted 呢? 別緊張在Error 欄也有寫執行結果(1-Error) ,因此我們可以針對執行結果為1-Error 的部份, 來看它的錯誤原因,只要設定Exception 及User Error Message , 並針對所需的指令類別(StoreProcedure或一般SQL)所需的Completed 事件, 就可以找到錯誤的指令.   實際應用的案例 以下是一個我們在Client 端程式所發生的錯誤, 可是單由Client端的訊息看不出來錯在那裡, 執行資料庫Schema 更新失敗(Schema Ver.18 update failed) 接下來要找到失敗的原因. 1. 開啟 SQL Profiler. 開始-->程式集—>Mircosoft SQL Server 2005->效能工具->SQL Server Profiler. 2.新增追蹤 3.連結資料庫 4.設定所需的事件 預設項目除了 RPC:Completed , SP:StmtCompleted, SQL BatchCompleted 其餘均可取消.   5.勾選 顯示所有事件及顯示所有資料行. 6.選擇必要的事件    對於找出一般SQL 指令的錯誤而言, 只需要設定三個值, 其餘可取消.    設定Errors and Warnings 之 Exception 與User Error M...
閱讀完整內容

如何將SQL Server 的查詢輸出寫入文字檔

圖片
  SQL Server 預設會將執行結果顯示於畫面上，可設定將其輸出寫入外部檔案，此項設定只針對新開啟的視窗有效. 以下範例是針對SQL Server 2005 . a. 開啟SQL Server Management Studio b. 點選工具à選項 c. 設定查詢結果，選擇將結果存檔 d. 開啟新的執行視窗，並執行指令. e. 選擇輸出檔案名稱. 雖然預設副檔名為 .rpt , 但其內容為文字檔，因此可用文字編輯開啟.
閱讀完整內容

AgilePoint逐級簽核與指定簽核層級範圍

圖片
  循序簽核 企業流程中, 大部份的行政流程都採用申請者逐級簽核的方式進行, 由申請者開始依組織的層級逐級向上簽核,當導入BPM或Workflow時也會面臨同樣的問題, 一般常見的作法是逐一繪出組織層級與流程. 上述的流程雖然很清楚的呈現簽核者的層級與流程, 可是問題也不少,因為一般流程的訪談都是以最基層的員工為主, 因此很容易發生以自己為出發點去設計流程,試問 1.如果經理自己申請是否要自己核准, 如果協理申請是否要給經理簽 ? 2. 如果有一個部門沒有協理怎麼辦 ?一個流程如果要適用於生產部門的工廠與行政支援部門, 通常其組織結構是不同的, 傳統的作法是把每個組織了流程劃出來, 整個流程密密麻麻. 逐級簽核 新的流程設計通常改用逐級簽核的方式, 以類似迴圈的方式判斷是否達到核決的權限, 如未達到則在找上一階主管, 已達到則離開迴圈, 不論申請者是何層級或組織階層為何皆可執行.   AgilePoint 提供很有彈性的逐級簽核的判斷,可在單一條件的流程元件(Single Condition) 是否達核決權限中判斷指定的流程變數(圖中IsPrivileged)為True或False, 因此只要在流程中依組織的核決規則去設定流程變數值即可. 判斷是否達核決權限的判斷有許多種方法, 第一種是在人工簽核作業元件中設定判斷的基准,該元件會依設定的內容指定流程變數的值. 內件元件可以依人員或部門甚至流程變數的值作判斷, 判斷的方法有特定的值(等於某個層級), 特定欄位值是否符核該層級的區間(經理可准假幾天, 協理可以核准採購金額多少),上簽幾階等不同的方式. 如果內建的內容無法滿足時,亦可在表單上運算然後將結果(True/False)直接設定給流程變數, 不過我們通常不建議將判斷寫於表單上, 比較建議的方法是寫成一個流程元件(AgilePart), 其優點除了簡化表單的設計外, 另一個好處是可以重覆利用這個元件, 達到組合流程的目的. 資產處分流程中, 依資產使用年限與殘值決定核決層級, 以AgilePart 製作核決權限判斷元件. 設計一個可參數化的流程元件直接設定所需的核決層級. 透過上述幾個案例, 可以發現逐級簽核有兩個重點, 一個是需要一個樹狀...
閱讀完整內容