pentaho Adhoc 分析
Adhoc 技术分析
1. 汉化页面
页面所有的信息都在两个js的资源包：
/webContent/adhoc/js/common/ui/messages/nls/message_strings.js
/webContent/adhoc/js/ui/messages/nls/message_strings.js
汉化需要在/webContent/adhoc/js/ui/messages/nls/下面新建zh-cn文件夹，并将nls/message_strings.js复制到/webContent/adhoc/js/ui/messages/nls/zh-cn，然后将message_strings.js的相应的英文翻译为中文。
注意：如果没有找到zh-cn下的message_strings.js，系统会采用/nls/message_strings.js。所以直接修改/nls/message_strings.js也可以。模型、视图等信息要修改metadata里面的地方，具体参见下文metadata designer使用指南。
参考文献：http://wiki.pentaho.com/display/PentahoDoc/Localization
2. 报表模版
模版位于Solutions/system/waqr/templates下面，Solutions为pentaho的方案。
新建自己的文件夹，index.xml中描述要建立的文件夹的信息以及其它信息，这个文件很重要，系统会依照它来标示一个模版。简单的变化可以修改report.xreportspec、thumbnail.png等相关文件里面的内容，更高的要求要用Report Designer来做。详情参照后文Report Designer使用指南。
index.xml，report.xreportspec等文件具体参数的含义请参照参考文献。
参考文献：
http://wiki.pentaho.com/display/ServerDoc1x/Adhoc+Reporting+Templates
3. metadata designer指南
这里面涉及了一些概念如 domain、business models、business table、business view等，要先有所了解，可以参见 http://blog.csdn.net/wengyupeng/archive/2008/08/07/2782655.aspx
或去http://d.download.csdn.net/source/479228下载，我做的一点概念翻译。
首先要pentaho-metadata-editor，打开以后
连接选择要连接的数据库
然后创建业务模型、关系、视图等
各种操作可以通过右键、提示信息等完成。完成保存以后，可以通过菜单file下面的publish来发布到solution里面。具体如下图，
发布密码在Solutions/system/publisher_config.xml里面设定，用户、密码为登陆pentaho平台的用户、密码（password默认）。
更多信息参照参考文献。
参考文献：http://wiki.pentaho.com/display/PentahoDoc/Pentaho+Metadata+Editor
4. Report designer指南
要使用pentaho- Report-designer，打开以后
左边为一些可拖移的控件
右边是结构、属性
单击data sets右键,可以和数据库连接。
报表函数提供很多函数作为数据计算的工具，可以依据自己要求向报表里面添加
File 菜单下面的publish to server 可以用来发布做好的报表到solution
Import pentaho reporting report definition (xml) 可以导入 xml和.xreportspec（模版文件）文件
通过report wizard可以快速生成一些既有格式的报表，最后生成的文件为.xreportspec
其它具体操作细节可参照参考文献。
参考文献：http://wiki.pentaho.com/display/Reporting/Report+Designer
5. adhoc js概述
Adhoc 的首页是waqr.html，用到了很多js 以及ajax的dojo包。
所有的页面初始化都是通过html标签的id进行的，比如页面的
<td id='busyContainer' style='width:100%;'>
Js 里面会依据'busyContainer'，进行相应的初始化，所以要跟踪任何控件只要在eclipse里面搜对应的id就可以。上面的<td id='busyContainer'对应的效果为
在webContent/adhoc/js目录下发应了adhoc相应的功能结构
Controller里面的Controller.js是整个部分的控制器，负载加载model等。RepositoryBrowserController.js是负责页面从solution获取路径的，model里面的js 负责将metadata editor 生的metadata.xmi（位于Solutions/samples下面）文件转化分解为系统的数据格式。结果如下图所示
这些里面的数据，都是model里面的js从metadata.xmi提取出来的。
有几个重要的js ,位于/webContent/adhoc/js/ui下面
WizPg0.js-WizPg3.js对应的adhoc查询的1-4步。WaqrWizard.js是总的控制器。这几个js是分析页面逻辑的入口。
其它每个部分对应一个js，具体不再赘述。2页左边位置，对应的js是AvailableItemsCtrl.js。