excel服務器入門教程:[2]定義數據項?

excel服務器入門：之定義數據項

工具/原料

勤哲excel

方法/步驟

什麼是數據項

數據項指的是模板表樣中需要填寫內容的那些空白單元格。若干相關的數據項可以組成一個數據表。

數據項的定義包括以下內容：

l 區域地址和名稱：它表明所填寫的位置和信息的含義。比如在《客戶登記表》模板中，C3單元格就是一個數據項，它的名稱是“客戶名稱”

l 數據類型，它表明空白單元格中可以只能填寫什麼類型的信息，比如“客戶名稱”數據項，只能填寫不超過100個字符的文字，而不能填寫數字或日期。

l 是否必填，它規定按模板格式填寫實際的表單時，此數據項可否空白不填。比如在《客戶登記表》中，“客戶名稱”是必填項，而“收貨地點”不是必填項。

l 填寫規範，指對所填數據的要求，通常有幾種情況，一是默認值，如“登記日期”的默認值是當前日期；二是下拉列表選擇或樹型選擇，如“大區”就不能隨意填寫，而是在相應的位置有一個事先定義好的下拉列表，列舉了全部大區的名稱，填表時只需要從中選擇。三是自動編號，如“客戶編號”可以自動產生。

l 主鍵，主鍵的目的是保證唯一性。比如在“客戶登記表”模板中，我們把“客戶編號”定義為主鍵，就意味著不管填了多少張《客戶登記表》，“客戶編號”都必須彼此不同。因為通過Excel服務器填寫的表單上的內容最終都保存到數據庫中，所以這裡所說的“彼此不同”不是靠人為的小心謹慎來做到，而是由系統自動控制的；如果您填了兩張編號相同的《客戶登記表》，第二張表保存時系統自動會通知您發生了數據重複，保存無法通過。

l 其他內容，包括是否隱藏、填寫下一張時是否清空，如何排序等。

數據項又稱為“字段”，在下文中，這兩個詞是同樣的含義。

定義單一數據項

數據項又分“單一數據項”和“重複數據項”兩種，在《客戶登記表》模板上，我們先來定義單一數據項，至於兩者的區別，到下一章再敘述。

1） 在《客戶登記表》模板的設計狀態下，按住Ctrl鍵，然後用鼠標左鍵依次選中空白單元格C2，E2，G2，C3:E3，…，C8:G8，如下圖所示：

2） 選擇菜單“模板à定義數據項à單一數據項”（或者單擊鼠標右鍵，從彈出菜單中選擇“單一數據項”）。彈出如下窗口：

“選中單元格”處顯示的是上一步選中的那些空白單元格/單元區域的地址。每一個選中單元格/單元區域都要定義成一個數據項。

3） 點擊按鈕 【左側單元名稱】，意思是用空白單元格左側的單元格中的內容為空白單元格命名。例如，用C3單元格左側的單元格（B3）的內容為C3單元格命名，而B3的內容是“客戶名稱”，所以C3單元格對應的數據項命名為“客戶名稱”。

4） 點擊【下一步】窗口顯示如下圖所示。選擇“組成新數據表”，命名為“客戶表”，按【下一步】

5） 窗口中顯示出數據項的列表，選擇每個數據項的數據類型，在“客戶編號”、“銷售員”、“客戶名稱”和“登記日期”對應的“必填”處單擊打勾，然後按【下一步】。

6） 窗口顯示如下圖，不改變默認選擇，直接按【完成】

7） 窗口消失，回到客戶登記表模板的設計狀態。

8） 保存模板。

關閉模板。

典型的excel服務器對數據項的處理如上所示，但是在FineReport中，對數據項的處理感覺更加靈活一下，下面以FineReport填報中對數據的處理為例進行對比：

報表填報是指將數據填報至數據庫中，那麼填報到哪個數據庫，哪個數據表中該怎麼判斷呢，因此需要在填報屬性中選擇填報入庫的數據庫表，如下圖：

添加字段

選擇表後，點擊智能添加字段按鈕，會自動讀取數據庫中表中的所有字段，若不想添加全部，可以去掉字段前面的勾選，如下圖：

除了使用智能添加字段來一次性添加多個字段之外，還可以直接點擊添加字段按鈕來單個的添加字段，如下圖：

添加單元格

字段添加完成之後，點擊智能添加單元格或者只能添加單元格組，就可以給數據列綁定單元格，如下圖，點擊智能添加單元格，在彈出的對話框中選擇報表主體中的單元格，為數據列綁定單元格：

我們不僅可以給數據列綁定單元格，還可以使用字符串常量、公式、參數等等不同類型的數據，如下圖

若用戶在模板中插入了一行或一列，導致填報單元格整體偏移了一格，此時可以使用批量修改單元格，整體批量修改，如下圖：

設置提交條件

使用內置SQL填報數據，可以對填報數據進行過濾，如果web端提交的數據滿足條件，則可以入庫，不滿足，則不入庫，點擊設置提交條件即可添加過濾條件，如下圖：

自定義事件

如下圖，在報表填報屬性頁面，可增加自定義事件，自定義事件可通過FR提供的API接口來實現不同的類，接著將該類導入到設計器中，即可實現自定義事件，詳細請參照自定義事件：

注：添加了多個內置SQL後（不論幾個sheet裡面的內置SQL），提交時有一個執行不通過的話，後面的內置SQL就不會執行，前面的執行過的也會無效（FR填報支持事務回滾機制）。

另：在數據commit時出現異常，或者回滾時出現異常時， 如果最終是失敗的，後臺額外報錯提示 前者是 “數據提交出錯，無法回滾”，後者是 “數據回滾失敗”。 前端都提示”失敗”。