统一查询面板配置傻瓜手册V02.docx

1、统一查询面板配置傻瓜手册V02统一查询面板配置傻瓜手册 -戴明利1 概述葵花宝典之引刀自宫，精简配置。自定义查询，只需配置三项即可：a.)、配置导航树 b.)、配置新专题 c.）、配置新面板。2 配置导航树 先配置monitor_menu的monitor_id，monitor_name，monitor_parent_id，state；后续添加面板的时候再修改monitor_url。上述 monitor_id，monitor_name，monitor_parent_id 均可自行配置，只要每个新专题根节点的 monitor_parent_id 为空即可 。如下图：3 配置新专题3.1 在主页添加

2、 1）提单添加或修改首页链接图标 2.)修改 work_link 表链接地址 如：把相应新专题的link_value 设置成javascript:displayMaxWindow(workshop/queryTemplate/main.html?id=4,true) 其中ID 是 monitor_menu 对应该专题导航树根节点的monitor_id。 如下图，则 monitor_id=4：3.2 在 网管监控-稽核报告 处添加（或其他地方添加）网管监控-稽核报告，新增一个自定义查询，如下图：在高额分析下添加一个“统一面板查询配置测试“”专题。1.）添加一个“统一面板查询配置测试”专题2.）其

3、配置SQL在自定义查询报表中没用，如下：3.）修改链接地址select * from privilege t where t.privilege_name =统一面板查询配置测试 把相应添加的专题链接地址改成新专题的链接地址，如：SERVER_URL_NAME=workshop/queryTemplate/main.html?id=11SCRIPT_NAME=doMenu_open()4.）点击相应链接即可看到新专题了。如下图：4 配置新面板 4.1 单列表4.1.1 配置面板BASE_PANELBASE_PANEL 配置面板ID和标题，ID值可以自行配置，标题可以不配置，如下图有两个面板。注

4、：a.）此处的面板ID在monitor_menu配置标签页时用到，见下图（html?panel=1）ID=1:b.) 标题见下图标红处：4.1.2 配置工具条信息PANEL_TOOLBAR, PANEL_TOOLBAR_CFG1.) PANEL_TOOLBAR（存放所有面板的工具条配置信息，通过PANEL_TOOLBAR_CFG实现TYPE=param的工具条与BASE_PANEL的多对多关系。）2.) PANEL_TOOLBAR_CFG在PANEL_TOOLBAR中配置的工具条需要在这里配置一下归属于那个面板4.1.3 配置查询控件及默认值 PARAM_COMPONENT1.) PARAM_

5、COMPONENT（存放所有面板的查询控件，也是SQL_PARAM_CFG的“已存在的控件（COMP_ID=13）”类型的数据来源，存放所有面板的查询控件， ，配置显示控件的名称）注：a.）PARAM_COMPONENT 的COMP_ID为查询控件的类型: 普通文本框（comp_id=1），日期选择框（comp_id=2），SQL下拉（comp_id=4），树形控件（通过指定SQL）（comp_id=7）等；CMOP_DS是相应查询控件SQL的语句。b.) PARAM_COMPONENT 的PARAM_COMP_ID 在 SQL_PARAM_CFG的COMP_DS中相对应，且SQL_PARAM

6、_CFG 的COMP_ID=13. c.) PARAM_COMPONENT的 DEFAULT_VALUE 该查询控件的默认值。 当DEFAULT_VALUE 不是JS、SQL语句时，GET_TYPE=text 当DEFAULT_VALUE 是一个JS语句时，GET_TYPE=js。 当DEFAULT_VALUE 是一个SQL语句时，GET_TYPE=sql。 如：i. )DEFAULT_VALUE=$TODAY 时， GET_TYPE=text。 ii.)DEFAULT_VALUE=select to_char(sysdate,yyyy-mm-dd) from dual 时， GET_TYPE

7、=sql。 d.) PARAM_COMPONENT的PARAM_COMP_ID =33时COMP_DS的内容如下： 2.) PANEL_TOOLBAR_BY_PARAM（存放TYPE=param的工具条的具体配置信息。PARAM_COMPONENT中的那些查询控件需要在这里配置一下归属于那个工具条）其中SORT_ID是查询控件在界面展示的顺序。4.1.4 配置报表SQL语句SQL_CFG 测试列表的主要配置如下：SQL_ID=20401SQL_TEXT=Select to_char(t.create_time,yyyy-mm-dd hh24:mi:ss)create_time ,t.kpi_i

8、d,b.kpi_name,t.alarm_titlefrom ne_alarm_list t,kpi_code_list bwhere t.create_time=to_date(:begindate,yyyy-mm-dd)and t.create_time=to_date(:begindate,yyyy-mm-dd)and t.create_time=to_date(:begindate,yyyy-mm-dd)and t.create_timeto_date(:enddate,yyyy-mm-dd)+1group by to_char(t.create_time,yyyy-mm-dd)ord

9、er by to_char(t.create_time,yyyy-mm-dd)3.)4.2.2 配置图形标题，类型等GET_CHART_CFG1.) GET_CHART_CFG中的GET_VALUE_CFG_ID与GET_VALUE_CFG中的GET_VALUE_CFG_ID一致2.) GET_CHART_CFG中的CHART_TYPE为图表类型(line曲线，pie 饼图，column柱状图)3.) GET_CHART_CFG中的TITLE即为图表标题4.) GET_CHART_CFG中的X_LABEL，X轴显示标签5.) GET_CHART_CFG中的Y_LABEL，Y轴显示标签4.2.3

10、 配置存放显示图形X轴和Y轴的信息CHART_COLUMN_CFG(插入配置信息（使用一个X轴多个Y轴的情况）)1.）CHART_COLUMN_CFG 中的GET_VALUE_CFG_ID与GET_VALUE_CFG中的GET_VALUE_CFG_ID一致2.) CHART_COLUMN_CFG 中的TYPE=METRIC即X轴，TYPE=attribute即Y轴；COL_NAME 与 SQL_CFG的SQL_TEXT中X/Y轴对应字段名称相对应，COL_LABEL 对应字段的显示名称。4.2.4 存放图中每条曲线（柱子）的个性化定义CHART_LINE_CFG(可不配置)1.）CHART_L

11、INE_CFG中的GET_VALUE_CFG_ID与GET_VALUE_CFG中的GET_VALUE_CFG_ID一致。2.) CHART_LINE_CFG中的Line_name= Count(*)+100000（声明对那条线或柱进行定制，填入字段名）3.) CHART_LINE_CFG中的Line_type= column（转换为线或柱，取值为line，column，放空为不改变）4.) CHART_LINE_CFG中的Line_color= #FF0000（显示颜色，放空为不改变）5.) CHART_LINE_CFG中的Style=（个性化定制接口，提供个性化需求，放空为不改变）配置后刷新

12、页面显示效果如下4.2.5 配置数据源到MONITOR_MENU相应的MONITOR_URL中。MONITOR_URL=标签页1TemplateFourChart.html?panel=1&grid=30401/图表标签页TemplateFourChart.html?panel=1&chart=30402,-1,-1,30403& height=300,200&flex=1,1,1,14.2.6 查看配置效果4.3 配置列表+图表四图表+列表的模板支持配置出最多四个图表和一个列表的面板配置模板，可配置出不定数(最多四个)图表+列表(列表也可不配置)的页面。1.）

13、一列表：tabtitleTemplateFourChart.html?panel=1&grid=32）两列表：tabtitle TemplateTwoGrid.html?panel=1&grid=3,43.）一图表：tabtitleTemplateFourChart.html?panel=1&chart=3&height=3004.）两图表(左右结构)：tabtitleTemplateFourChart.html?panel=1&chart=3,2&height=3005.）一图表+列表： tabtitleTemplateFourChart.ht

14、ml?panel=1&chart=3,-1&grid=3&height=300,2006.）两图表+列表，flex可不配： tabtitleTemplateFourChart.html?panel=1&chart=3,2&grid=3&height=300,200&flex=1,27）两图表+两图表，flex可不配：tabtitleTemplateFourChart.html?panel=1&chart=3,2,4,6& height=300,200&flex=1,2,2,18）一图表+两图表，flex可不配:ta

15、btitleTemplateFourChart.html?panel=1&chart=3,-1,4,6& height=300,200&flex=1,1,2,19）一图表+一图表，flex可不配，上下、左右结构均可配。上下结构配置如下:tabtitleTemplateFourChart.html?panel=1&chart=3,-1,-1,6& height=300,200&flex=1,1,1,110.) 两图表+两图表+列表，flex可不配:tabtitleTemplateFourChart.html?panel=1&grid=3&a

16、mp;chart=3,4,5,6&flex=1,2,2,1&height=300,300,25011.) 一图表+两图表+列表，flex可不配:tabtitleTemplateFourChart.html?panel=1&grid=3&chart=3,-1,5,6&flex=1,1,2,1&height=300,300,25012.) 一图表+一图表+列表，flex可不配:tabtitleTemplateFourChart.html?panel=1&grid=3&chart=3,-1,-1,6&flex=1,1,1,1&a

17、mp;height=300,300,2504.4 PARAM_COMPONENT查询控件上面的例子里我们使用了文本输入框（Comp_id=1）来实现对sid和name这两个参数的赋值。系统目前支持的控件类型都存放在component中，使用控件时它的配置信息由3部分构成，分别为comp_Id，comp_ds，comp_cfg（目前使用这些控件的配置表为sql_param_cfg和param_component）。comp_Id 配置使用何种控件，数据来源于component。comp_ds 配置控件的数据来源，需要配置的控件包括数组下拉、SQL下拉、树形控件（通过指定URL）、树形控件（通过指

18、定SQL）、树形控件（通过指定valuecfg）、树形控件（通过指定无Level的SQL）、分步加载树、域下拉、已存在的控件。comp_cfg 程序留有的接口，使用json格式。用以拓展控件的功能或配置控件的一些特有属性，以满足一些个性化需求。接下来就依次介绍不同控件类型的配置方法，下面的演示还是建立在之前那个例子的配置数据上，选择不同控件时，默认须将sql_param_cfg的comp_id修改为相应控件的comp_id。4.4.1.1 普通文本框（comp_id=1）普通的文本输入框，无需配置comp_ds，控件显示效果如下图4.4.1.2 日期选择框（comp_id=2）日期选择框，无需

19、配置comp_ds，使用的日期格式为“YYYY-MM-DD”。配置的SQL如果是使用时间过滤，则必须用to_date函数来转换参数值或者使用to_char函数来转换日期型字段，这个时候Sql_Param_Cfg的Data_type配置成STRING。控件显示效果如下图4.4.1.3 数组下拉（comp_id=3）下拉菜单的一种，需要配置comp_ds。Comp_ds配置为一个嵌套的json数组，第一层数组描述有几个下拉项（系统默认会添加一个“-无-”的下拉选项以方便清空该查询条件），第二层数组的第一个元素表示下拉项的value，第二个元素表示下拉项的text。如配置comp_ds= 1,测试数

20、据1,2,测试数据2,3,测试数据3，则显示如下图4.4.1.4 SQL下拉（comp_id=4）下拉菜单的一种，需要配置comp_ds。Comp_ds配置为一段sql文本，sql需要返回2个字段。sql的第一个字段表示下拉项的value，第二个字段表示下拉项的text，如果只有一个字段则同时表示value和text。如配置comp_ds= Select code,mean From codelist Where code_type = DOMAIN_CIM_LINKTYPE Order By sort_id，则显示如下图4.4.1.5 模糊输入框（comp_id=5）与普通文本框类似，也无需

21、配置comp_ds，显示效果也一样。只是会在值的前后加上“%”，与sql里like配合使用。4.4.1.6 树形控件（通过指定URL）（comp_id=6）树形下拉的一种，需要配置comp_ds。comp_ds配置能返回符合树形控件XML数据格式的URL（基本是现有代码已经提供的，如/resource/xml/TreeType.xml中提供的一些地址）。如配置comp_ds= /servlet/RegionTree?action=4，则显示效果如下图4.4.1.7 树形控件（通过指定SQL）（comp_id=7）树形下拉的一种，需要配置comp_ds。comp_ds配置为一段使用CONNECT

22、 BY的sql文本，sql需要返回3个字段，sql的第一个字段表示树节点的value，第二个字段表示树节点的text，第三个字段为关键字level。如配置comp_ds = SELECT ORG_ID, ORG_NAME, LEVEL FROM ORGANIZATION CONNECT BY PRIOR ORG_ID = PARENT_ORG_ID START WITH ORG_ID = 0，则显示效果如下图4.4.1.8 树形控件（通过指定valuecfg）（comp_id=8）树形下拉的一种，需要配置comp_ds。comp_ds配置为另一个自定义查询的get_value_cfg_id。因

23、为采用树形控件（通过指定SQL）和树形控件（通过指定无Level的SQL）这两种树形控件所配置的sql均为静态sql，即sql中不能使用参数。如果需要在配置sql中使用参数，则必须将这段sql配置为一个自定义查询，即配置sql_cfg和get_value_cfg。而这个时候新定义的自定义查询的参数只能通过url的方式赋值。如现在树形控件还是显示组织树，但根节点必须动态指定。配置如下1) 添加sql_cfgsql_id = 2Sql_text= SELECT ORG_ID, ORG_NAME, LEVEL FROM ORGANIZATION CONNECT BY PRIOR ORG_ID = P

24、ARENT_ORG_ID START WITH ORG_ID = :root（注意：这里把之前写死的0改成使用root参数）Sql_type=SQL2) 添加get_value_cfgGET_VALUE_CFG_ID=3（将配置到comp_ds）GET_VALUE_TYPE=SQLGET_VALUE_ID=23) 配置comp_dscomp_ds=3（新添的那个自定义查询GET_VALUE_CFG_ID）4) 执行show_result.html执行show_result.html?reuslt=2&root=0（通过url传入GET_VALUE_CFG_ID=3中定义的查询参数值），显示效果如下（因为传入是0所以与之前静态sql效果一样）执行show_result.html?reuslt=2&root=2（这里的root=2是根据我数据库里一个org_Id，大家可以依据各自数据库里实际org_Id来测试效果），显示效果如下4.4.1.9 树形控件（通过指定无Level的SQL）（comp_id=9）树形下拉的一种，需要配置comp_ds。comp_ds配置为sql文本（不使用CONNECT BY），sq