D02-03 填報除錯插件

1

版本。

2

應用場景。

1. 在制作填報範本時，範本結構和資料庫表結構可能不一致，且提交時帆軟會對所有公式進行重計算，所以經常會出現提交結果和預期的不一致的情況。在排查此類問題時，由於所見非所得，往往會花上比較多的時間。
   

2. 【填報除錯插件】可以将一部分的後台計算結果轉化爲前端可視化資料，讓使用者能在制作範本時清晰地看到每個提交屬性的計算結果，方便出問題時定位到出問題的資料，進行進一步的排查。

3

功能描述。

1. 主要功能。
   

查看填報屬性中綁定的內建sql在實際填報時的資料信息。


查看某一次操作後的資料變化情況。

查看公式在填報重計算後的結果。

2. 當前限制。

只支援【報表填報屬性】中的提交設定，不支援按鈕等其他地方的提交事件設定。

不支援展示【內建sql】中設定的【提交事件】的結果。

不支援展示【不改變時不更新】設定的結果。

除錯對話框不支援跟随網頁大小自适應。

不支援IE內核浏覽器。

不支援【決策報表】。

啓用除錯對話框時，不支援同時再打開其他對話框。

需要展示工具欄才會彈出除錯對話框。

不支援和【客製展示欄插件】共用。

1

插件安裝。

1. 點擊下載插件：填報除錯插件。

2. 插件安裝方式，可參考A11-18伺服器-插件管理。

2

操作方法

1. 在範本填報預覽的 url 後面加上參數 &debug=true 進入填報除錯預覽介面，如下圖1所示。

2. 進入介面後，右下角會自動顯示除錯對話框，也可以通過工具欄的【填報除錯】按鈕打開除錯對話框。對話框大小和位置可以手動調整，如下圖2所示。

3. 除錯對話框初始化後，會展示填報屬性中的提交設定，可以清楚的看到資料在入庫前重計算後的狀态，如下圖3所示。

4. 當在頁面上新增、更新或者删除資料後，可以點擊除錯對話框裏的刷新按鈕，查看本次操作後的資料計算結果。有變化的資料會呈現綠色字體，其資料所在行的背景色會變爲藍色。

   資料狀态欄會呈現該條資料的狀态，一共三種：預設、修改和删除。預設狀态代表未對該資料做過操作；修改狀态包括更新和新增兩種動作；删除狀态代表該資料已被删除。

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

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

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

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

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

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

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

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