填報除錯插件

1.1 版本

1.2 應用場景

適用場景：提交資料與預期不符、提交報錯、提交慢

1.3 功能描述

主要功能

2.1 插件安裝

點選下載插件：填報除錯插件

2.2 進入除錯模式

2.3 查看資料詳情

1）在除錯對話框中點選「資料詳情」頁，在提交列表中選擇需要查看的提交設定，並點選重新整理按鈕。

2）資料詳情頁可以看到的資訊有：資料庫欄位型別和長度限制；填報屬性欄位配置；資料在入庫前的值。

2.4 查看除錯日誌

1）在除錯對話框中點選「除錯日誌」頁，在提交後，該頁可以查看提交過程的所有資訊，以及相關的資料庫配置資訊。除錯日誌支援匯出和匯入，在無法獨立解決問題的情況下，可以匯出該日誌，傳送給技術支援協助分析處理。
2）在完成提交後，「除錯日誌」頁會展示出本次提交過程的資訊。在主頁面上，每一個提交都會包括2條資訊：資料過濾結果和資料提交結果。
3）點選「過濾結果」，在「詳細資訊」頁可以查看本次過濾的詳細資訊。
4）點選「提交結果」，在「詳細資訊」頁可以查看本次提交的資料庫配置資訊、填報屬性配置資訊、入庫語句和入庫結果。
提交型別commitType的種類有：DbIntelligence（智慧提交）、DbDelete（刪除提交）、DbInsert（插入提交）、DbUpdate（更新提交）。
在「執行日誌」頁可以查看該提交執行的sql範本，以及每個過程的耗時。
如果平台日誌等級為debug，則還可以看到每個提交的具體sql語句，方便排查資料問題。
注：在解決完問題後，需要將日誌等級改回原有等級，避免出現debug級別下日誌匯出太多造成工程負荷提升的問題。

當出現提交資料與預期不符、提交報錯、提交慢這三種型別的問題時，可以按照以下思路來排查。

4.1 提交資料與預期不符

1）使用填報除錯，點選「提交」後，查看「除錯日誌」頁展示的資料過濾後的條數，以及增刪改的條數，判斷問題是出在哪個階段。
2）如果是過濾階段的問題，可以查看過濾詳情，找到條數出現異常的具體階段，檢查相關設定。
3）如果是提交階段的問題，可以將日誌等級設定為debug，然後查看提交執行日誌，從具體sql語句中尋找出現異常的資料。
注：在解決完問題後，需要將日誌等級改回原有等級，避免出現debug級別下日誌匯出太多造成工程負荷提升的問題。
如果無法將日誌等級設定為debug來排查，也可以在資料詳情介面查看資料入庫前的值，確定是否在計算資料時出現了問題。
4）如果提交詳情頁面出現了下面的資料主鍵重複提示，則大概率會導致提交資料缺失或者異常的問題，需要檢查是否主鍵設定錯誤，或者資料存在重複。

4.2 提交報錯

1）在填報常見報錯代碼文檔中搜尋是否有類似報錯，如果未找到，也可以百度查詢報錯資訊。
2）可以將日誌等級設定為debug，然後查看提交執行日誌，從執行的最後一句sql語句中分析異常原因。也可以直接複製該sql語句到資料庫執行測試。
注：在解決完問題後，需要將日誌等級改回原有等級，避免出現debug級別下日誌匯出太多造成工程負荷提升的問題。
3）如果無法將日誌等級設定為debug來排查，也可以使用二分法，對範本填報屬性進行刪減，定位到具體是哪一個欄位的什麼資料出現了問題。

4.3 提交慢

1）使用填報除錯，點選提交後，查看「除錯日誌」頁展示的資料過濾和資料提交階段的耗時，應答問題出在哪個階段。
2）如果是過濾階段的問題，可以查看過濾詳情中資料計算和資料過濾的時間。如果是計算慢則可以查看填報屬性中設定的公式是否存在效能問題，例如取數函式（sql、value、ds1.select）；如果是過濾慢，則可以查看提交條件的設定，是否存在效能問題。
3）如果是提交階段的問題，可以查看執行日誌，應答問題出在刪除、更新、插入的哪些階段。如果是更新或者刪除階段慢，可以嘗試在資料庫增加該表的索引來提高填報效能。
4）如果以上步驟無法解決提交慢的問題，可以參考填報常見效能問題文檔做進一步排查。

1）now()，uuid()等會不斷變化的公式，且勾選了「填報/分析時，保留公式用於計算」時，每次重新整理除錯對話框，該公式的結果都會被標記為綠色的修改狀態。
2）被「提交條件」過濾掉的資料不會出現在除錯對話框中。比如設定提交條件為產品ID=1時，結果如下：
3）主鍵欄位會統一靠前展示
4）範本存在笛卡爾積時，會有如下報錯。
5）在除錯對話框中重新整理資料後，頁面上的資料修改狀態（紅色小三角）會清空。
6）資料在除錯對話框中的展示順序和最終入庫後的順序不保證一致。
7）除錯對話框每次重新整理後，綠色標記展示的都是當次操作後的結果，所以如果連續重新整理2次，就不會有綠色的狀態顯示了。

注：由於插件的計算時機在提交前，而資料要和資料庫交互後才能知道是新增還是更新，所以插件無法區分更新和新增，統一标記爲修改狀态。

1. 使用now()、uuid()等會不斷變化的公式，且勾選了【填報/分析時，保留公式用於計算】時，每次刷新除錯對話框，該公式的結果都會被标記爲綠色的修改狀态，如下圖1所示。

2. 被【提交條件】過濾掉的資料不會出現在除錯對話框中。譬如：設定提交條件爲【産品ID=1】時，如下圖2所示。

3. 主鍵字段會統一靠前展示，如下圖3所示。

4. 範本存在笛卡爾積時，會有報錯，如下圖4所示。

5. 在除錯對話框中刷新資料後，頁面上的資料修改狀态（紅色小三角）會清空，如下圖5所示。

6. 資料在除錯對話框中的展示順序和最終入庫後的順序不保證一緻。

7. 除錯對話框每次刷新後，綠色标記展示的都是當次操作後的結果，所以連續刷新2次，則不會有綠色的狀态顯示。