# 2.模型
# 創建第一個單據模型
提示
單據模型是ELCube的基礎功能單元,通過不同的單據模型來構建您的業務流程
電梯:https://loan.elcube.cloud/#/apps/def/doc/create (opens new window)
通過菜單 開發-模型 進入單據類型列表,點擊新建按鈕進入單據模型編輯界面
| 字段 | 描述 | 舉例 |
|---|---|---|
| 交易類型 | 由4個字符組成的模型唯一標識 | ZR01 |
| 交易類型描述 | 模型名稱 | 演示單據 |
| 有效期限 | 為模型設置一個過期時間,如長期有效 | 2000-01-01 至 2099-12-31 |
| 模型程序 | 為模型提供邏輯處理的Java程序 | Transaction 單據,Partner 伙伴等 |
| 業務主鍵規則 | 單據模型的業務唯一標示的表達式,非必要 | 伙伴的身份證編號、企業的組織機構代碼證編號等 |
# 選擇合適的模型程序
- Transaction 單據:普通的模型程序,適用于普通業務單據。體驗創建可選擇該模型程序
- Partner 伙伴:相關方主數據程序,適用人員檔案、企業檔案、機構檔案等
- Pipeline 流水線:自動化程序,適用于決策、數據抓取等自動化作業
- Page 用戶頁面:菜單頁面單據,每一個菜單都是一個單據模型,每增加一個頁面菜單,就需要創建一個該程序的單據模型
- Rule 規則:配合流水線使用,適用于規則判斷
- DataAnalyse 數據集:適用于為首頁配置數據卡片
- System 系統設置:適用于配置數據字典
請注意
修改單據類型配置后,請保存數據,避免修改內容丟失。
# 為模型添加狀態
提示
任何事物都有狀態,單據模型也不例外;每一個模型可以有多種狀態,但生效的只有一個。
狀態隨著業務的進展更新,因此它的變化是有規可循的,通過狀態表,來描述單據模型狀態變化的過程。
提示
在很多情況下,不同的狀態最終可能會流轉到一個相同的狀態,
同一個狀態也可以根據用戶的選擇流轉到不同的狀態。
如一個業務申請,不論是否審批通過,最終都有可能成為歸檔的狀態。
我們可以在狀態表中添加多個歸檔狀態,分別設置其前序狀態為`審批通過`與`審批駁回`。
也可以設置多個狀態`審批通過`與`審批駁回`,它們的前序狀態都為`審批中`,用戶就可以選擇該業務最后流轉向某一個狀態
| 字段 | 描述 | 舉例 |
|---|---|---|
| 狀態 | 由4個字符組成的狀態唯一KEY | S001 |
| 描述 | 狀態名稱 | 新創建 |
| 操作名 | 為狀態設置一個別名,來描述修改狀態的操作動作 | 提交 |
| 前序狀態 | 描述由哪個狀態可以修改為當前狀態,@標示創建時的默認值 | @、S001、S002 |
| 編輯控制 | 描述當前狀態下單據是否開放編輯 | |
| 顏色 | TODO | |
| 系統狀態 | 定義當前狀態下的系統值,可用于規范程序處理 | |
| 顯示 | 描述狀態操作是否顯示在單據操作列表,默認情況下折疊在下拉菜單里 | |
| 不校驗 | 定義該狀態下是否對卡片數據進行前端校驗,默認是校驗,如需不校驗,可以打開開關 | |
| 擴展程序 | 自定義狀態是否可見的Java程序,繼承NkAbstractDocStateInterceptor類 | NkDocConditionStateInterceptor,參數:{"condition":"${data?.BasicInfo.type=='1'}"} |
| 參數 | 配合擴展程序使用 |
# 下面是一個常見的例子
| 狀態 | 前序狀態 | 編輯控制 | 操作名 | 顯示 |
|---|---|---|---|---|
| 新創建 | @ | 可編輯 | ||
| 審批中 | 新創建 | 不可編輯 | 提交審批 | 是 |
| 駁回 | 審批中 | 可編輯 | 拒絕 | 是 |
| 審批中 | 駁回 | 不可編輯 | 提交審批 | 是 |
| 審批通過 | 審批中 | 不可編輯 | 同意 | 是 |
# 由此可以看出
- 一個單據可以包含1或N個狀態,有且僅有1個初始狀態
- 每個狀態必須有一個前置狀態或設定為初始狀態,來控制狀態的前后序關系
- 通過狀態編輯控制可以設置一個單據是否允許編輯
- 在單據界面中,用戶可以修改單據狀態來完成業務流轉的操作
- 狀態允許有分支以及回溯
# 編寫幫助文檔
提示
用markdown格式編寫這個單據模型的文檔,這個文檔可以被最終用戶看到;
因此,將它作為系統的操作文檔,是非常美妙的事情。
# 激活模型
提示
只有激活的模型,用戶才可以真正在系統中使用,
一切準備就緒后,點擊工具欄中的紅色激活按鈕,使這個模型生效。
# 創建一個業務單據
現在您只是創建了第一個沒有表單內容的新模型,
但是不要緊,您仍然可以前往單據菜單中點擊右上角的+新增創建一個真正的業務單據試一下。
電梯: https://loan.elcube.cloud/#/apps/docs (opens new window)