標準作業防呆，中文化，回應訊息，處理中狀態，layout 處理

標準作業防呆

grid 資料未做修改時，不允許 save
form、grid 資料型態正確及資料填寫完整才允許update/save
中文化

不是寫死的中文字，必須用變數代替需要顯示文字的地方

介面中的文字
下拉選單代表的中文字
訊息的文字
語系定義檔案： projects/foodprint/web-app/i18n/Application_zh-TW.properties
語系定義規則：type.myVariable.label
- type為語系類型分別有以下四種，將 myVariable替換為實際的變數名稱，最後加上 .label 。
  1. default 預設類
- 比common元件適用範圍更廣，可能被各個元件使用。
- 範例 default.message.load = "讀取中..."
  1. common 共用類
- 屬於commone元件之字串。
- 範例 common.saveBtn.label = 儲存
  1. domain 資料欄位類
- 對應於後端資料庫之欄位名稱。下面以batchDomain為例：
- 範例 batch.id.label = "批號編號"
  1. component 前端元件類
- 不屬於上述任一種，屬於功能型元件之字串。以回溯元件為例，由於回溯的資料包含品項、批號等domain的集合，因此應獨立定義其語系標簽。
- 範例 forwardTraceTree.item.title.label=品項名稱 forwardTraceTree.id.label=批號主鍵

目前統一由Utilites元件處理語系轉換，一般的轉換可參考commonCreateBtn，直接呼叫Utilities中的getMsg方法，並傳入指定的語系標籤即可。

processCommonCreateBtn(config){
    config.text=Utilities.getMsg('common.createBtn.label');
    return config;
}

grid、form轉換可參考ItemGrid、ItemForm，使用Utilities.processConfigBundle(config, 'item')指定語系類型為item即可自動轉換。

processItemGrid(config){
    return Utilities.createFiltersFeature(Utilities.processConfigBundle(config, 'item'));
}

關於語系替換的方式可參考下列文章：Extjs-8-30：在 Sencha Architect 中的多語系處理

回應訊息

儲存、更新、刪除完成需要由後端回傳success/failed對應的說明訊息。
處理中狀態
只要有 submit 或是有跟後端進行 request 務必要有遮罩
如果與後端無法連結，也同樣需要有對應的訊息
layout 處理
所有作業都必須填滿所有空間
grid 的欄位屬性根據重要度給定 flex，基本必須設置為 1，讓 grid 根據畫面自動延展
Auto Fill注意事項：
1. 元件不需設定width、height。
2. 主要元件設定flex=1，使其布滿畫面。
3. Initail View需設定為Viewport，方可自動調整高度。
4. 以動態新增之元件，code中也必須設計控制Layout。

以MainContainer為例，左方功能列表將動態新增各功能tab頁面，在產生Tab時應同時指定layout。

tab =  {
        xtype: 'panel',
        layout: {
            type: 'fit'
        },
        title: tabName,
        closable:true,
        items: [{ xtype: xtypeStr }]
   };

ps. 請參考OperationEditorCt。

結構調整

當function需操作多個物件時，才定義於controller當中。若是單純操作自身物件，則定義於該物件之view中。品項、批號、生產線、製程等維護作業資本上應只有一個controller，若有特殊需求需mixin其他controller請提出討論。如batchViewerController中的doDisplay，其實只有操作batchForm物件，因此重新定義於batchForm之中而非Controller，請參考批號維護（batchEditor）結構。

交易安全處理

執行delete功能時，可能發生domain不允許刪除，但發生前已刪除該domain中的object attribute，因此應加上transaction處理避免此問題，可參考batch delete、http://grails.org/doc/2.1.0/guide/services.html
基本上是把 domain 的更新在 service 中做，可以用 create-service 產生，然後在 condtroller 宣告def batchService 就可以使用了，不用 new，使用時就像是 batchService.deleteBatch(batchInstance)
函式內容為

@Transactional 

   def deleteBatch(batchInstance) {
      batchInstance.delete(flush:true)
   }

agricloud / foodprint