1.1 版本

1.2 应用场景

在制作填报模板时，模板结构和数据库表结构往往是不完全一样的，且提交时根据填报属性的不同设置也会呈现不同的提交结果，所以经常会出现提交结果和预期的不一致的情况。

在排查此类问题时，由于所见非所得，往往会花上比较多的时间。填报调试插件可以将一部分的后台计算结果转化为前端可视化的数据，也可以查看数据库配置情况和提交过程日志，让用户能在制作模板的时候清晰地看到过程和结果，方便出问题时排查。

1.3 功能描述

主要功能

1）根据填报设置查看数据在提交时的状态，并针对可能出现问题的数据进行提示

2）查看提交过程和结果的日志信息

3）查看数据库常见配置信息

4）支持导出提交日志，后续可发送给技术支持排查问题

当前限制

1）不支持「决策报表」和「移动端」

2）不支持「内置sql」中设置的「提交事件」

3）数据详情页不支持展示「未修改不更新」设置的结果

4）不支持IE内核浏览器

5）需要展示工具栏才会弹出调试对话框

6）启用调试对话框时，不支持同时再打开其他对话框

7）调试对话框不支持跟随网页大小自适应

8）不支持和「定制展示列插件」共用

2.1 插件安装

点击下载插件：填报调试插件

设计器插件安装方法请参见：设计器插件管理

服务器安装插件方法请参见：服务器插件管理

2.2 进入调试模式

1）在模板填报预览的url后面加上参数&debug=true进入填报调试预览界面。

2）进入界面后，右下角会自动显示调试对话框，也可以通过工具栏的按钮来打开调试对话框。

注：如未显示调试窗口，或者页面报错，可以排查是否因为1.3功能描述里的当前限制因素。

2.3 查看数据详情

1）在调试对话框中点击「数据详情」页，在提交列表中选择需要查看的提交设置，并点击刷新按钮。

2）数据详情页可以看到的信息有：数据库字段类型和长度限制；填报属性字段配置；数据在入库前的值。

3）当在页面上插入，更新或者删除数据后，可以点击调试对话框里的刷新按钮，来查看本次操作后的数据计算结果。有变化的数据会呈现绿色字体，其数据所在行的背景色会变为蓝色。

数据状态列会呈现该条数据的状态，一共三种：默认、修改和删除。默认状态即初始化状态，代表未对该数据做过操作；修改状态包括了更新和插入行并填写两种动作；删除状态则代表该数据从页面上被删除了。

注：由于插件的计算时机在提交前，而数据要和数据库交互后才能知道是插入还是更新，所以插件无法区分更新和插入，统一标记为修改状态。

4）「是否支持提交」功能可用于测试当前设置的数据库是否支持填报，该功能还在测试阶段，会在后续版本上线。

2.4 查看调试日志

1）在调试对话框中点击「调试日志」页，在提交后，该页可以查看提交过程的所有信息，以及相关的数据库配置信息。调试日志支持导出和导入，在无法独立解决问题的情况下，可以导出该日志，发送给技术支持协助分析处理。

2）在完成提交后，「调试日志」页会展示出本次提交过程的信息。在主页面上，每一个提交都会包括2条信息：数据过滤结果和数据提交结果。

3）点击过滤结果，在「详细信息」页可以查看本次过滤的详细信息。

4）点击提交结果，在「详细信息」页可以查看本次提交的数据库配置信息、填报属性配置信息、入库语句和入库结果。

在「执行日志」页可以查看该提交执行的sql模板，以及每个过程的耗时。

如果平台日志等级为debug，则还可以看到每个提交的具体sql语句，方便排查数据问题。

1）now()，uuid()等会不断变化的公式，且勾选了「填报/分析时，保留公式用于计算」时，每次刷新调试对话框，该公式的结果都会被标记为绿色的修改状态。

2）被「提交条件」过滤掉的数据不会出现在调试对话框中。比如设置提交条件为产品ID=1时，结果如下：

3）主键字段会统一靠前展示

4）模板存在笛卡尔积时，会有如下报错。

5）在调试对话框中刷新数据后，页面上的数据修改状态（红色小三角）会清空。

6）数据在调试对话框中的展示顺序和最终入库后的顺序不保证一致。

7）调试对话框每次刷新后，绿色标记展示的都是当次操作后的结果，所以如果连续刷新2次，就不会有绿色的状态显示了。