內建SQL提交

1.1 版本

1.2 功能介紹

設計好填報表格，新增填報元件之後，如下圖所示：

需要將填報資料的儲存格與資料庫表欄位進行綁定，確定填報的資料可以錄入到對應的資料庫表欄位下。

1.3 功能入口

設計器菜單欄點選「範本」→「報表填報屬性」，設定介面預設選擇「提交」，點選，選擇「内建SQL」即可，如下圖所示。

注：多個內建SQL的執行順序為從上到下，串行執行。多個內建SQL屬於同一個交易，如果其中一個執行失敗，所有內建SQL都會回滾。

內建 SQL 提交的設定步驟为：選擇提交型別→選擇資料庫→選擇資料庫表→新增欄位→新增儲存格，下面將對每個步驟做簡單介紹。

2.1 選擇提交型別

選擇提交型別即選擇資料入庫的方式，共有 4 種方式可供選擇，每種提交方式的邏輯和應用場景參見文檔：提交型別。

2.2 選擇資料庫和表

選擇資料庫和表是為了獲取資料庫表欄位，用於後面綁定填報儲存格，如下圖所示：

注：部分資料庫可能需要選擇模式，例如oracle。

11.0.2 版本及之後，選擇資料表時支援模糊搜尋。篩選表的框中輸入正文後，會根據輸入正文精確搜尋相關資料庫、模式下的表，將搜尋的結果展示在下拉框中，供使用者選擇表。如下圖所示：

2.3 新增欄位

新增欄位有 2 種方式：「智慧新增欄位」和「新增欄位」，2 種方式的差別如下。

• 智慧新增欄位：當需要新增的欄位較多時，可以使用這種批量操作的方式，點選按鈕後，預設選中表中全部欄位，將不需要綁定的欄位去掉勾選即可。

• 新增欄位：當需要新增的欄位很少時，可以像圖2這種手動一個一個新增的方式。

2.4 新增儲存格

點選「智慧新增儲存格」，將填報儲存格跟資料庫表欄位進行綁定，操作方式為手動選取填報儲存格，如下圖所示。

注：新增完儲存格後，一定要再檢查下有沒有遺漏掉欄位，欄位跟儲存格是否準確匹配上了。

2.5 設定主鍵

主鍵用於確認需要根據哪個或者哪幾個欄位來進行更新和刪除操作，相當於 SQL 中 where 的效果，和資料庫的主鍵不是一個概念。如果涉及到修改或刪除需求，那麼必須勾選一個或多個主鍵。如下圖所示。

3.1 智慧新增儲存格組

當一個資料庫表欄位需要綁定多個儲存格時，可以使用該功能，詳細介紹參見文檔：智慧新增儲存格組。

3.2 批量修改儲存格

該功能可以透過設定位置偏移批量修改儲存格，偏移方式有 2 種，操作示範如下：

• 列偏移：偏移值為 n，儲存格下移 n 列；偏移值為 -n，儲存格上移 n 列。

• 欄偏移：偏移值為 n，儲存格右移 n 欄；偏移值為 -n，儲存格左移 n 欄。

3.3 移除欄位

可以刪除已經設定的欄位，操作如下圖所示。

3.4 未修改不更新

勾選「不改變時不更新」後，前端填報時，若記錄沒有被修改，則該記錄不會參與提交過程。

在大資料量查詢並回填情況下，啟用該設定，可以明顯提高填報的提交效能。

詳細介紹請參見文檔：填報未修改不更新。

3.5 提交條件

提交條件可以用來對即將入庫的資料進行過濾，滿足條件的資料可以入庫，不滿足條件的不予入庫，但並不會中斷提交過程。

實際應用可參見文檔：填報提交條件。

3.6 提交事件

提交事件可以針對外層內建SQL影響的每筆資料分別執行一次設定的提交事件操作，其執行動作會在外層的內建SQL結束後開始。