AEAI Portal门户平台学习路径
1.概述
本文根据AEAI Portal的特点，为AEAI Portal门户平台初学者提供相对合理的学习路径，希望能帮助读者快速掌握AEAI Portal相关技能。
2.认识与部署
2.1 认识
Portal是一种Web应用，“portal是一种web应用，通常用来提供个性化、单点登录、聚集各个信息源的内容，并作为信息系统表现层的宿主。聚集是指将来自各个信息源的内容集成到一个web页面里的活动”。
AEAI Portal是国内（沈阳数通畅联软件技术有限公司）发布的一款Portal产品。2014年10月20日其Portal推出第一版“AEAI Portal门户集成平台v3.1版 ”，基于AEAI ESB可以搭建常规的信息门户、数据门户、应用门户。
2.2 部署
包括安装JDK、MySql、以及配置PortalServer。下图为Portal Server的配置对话框。
3.基础配置
3.1 导航配置
在“门户管理—导航管理”中可以对导航进行管理，也可以新建一个导航。
新建一个导航，设置编码、名称、类型（登录前、登录后）、默认主题（登录后的默认主题风格）等。
在新建的导航中添加页面，如首页，其中添加Portlet，浏览器地址栏输入http://localhost:8080/portal/request/xx/xxxNaNml即可访问，其中xx为对应的导航编码，xxx.ptml为新建的页面（首页）编码，还可以在管理导航中的返回门户目录下添加一个链接，链接到新建导航的首页，方便访问。
选中创建后的导航点击编辑，可以修改导航配置信息，添加个性主题（添加个性化主题列表中可以选择的主题）等。
3.2 目录、页面
在新建的导航中添加目录（菜单），包括决策分析、辅助功能。
在决策分析目录下添加页面，以现金流为例（参考综合门户中对应样例），目录下添加一个概览页面、一个现金流情况页面。
在决策分析下新建隐藏页面目录，包括现金流弹出表格页面、现金流明细页面、财年预算页面、财年预算弹出表格以及财年预算明细页，共5个页面（在后面的数据门户配置中使用）。
3.3 布局设置
在前面创建的首页的页面布局中添加4个Portlet：一个全动态Portlet（通知提醒）、一个TabPortlet（待办任务）、一个SSO应用列表Portlet和一个基本图表Portlet，通过扩展列容器扩展为两个列容器，每个列容器中添加两个Portlet。列容器可以配置所占宽度比等、其中的Portlet可以在容器间拖动，改变布局后要点保存按钮，才能保存布局信息。
3.4 Portlet设置
可以在布局中对Portlet高度、装饰等属性进行设置，也可以在页面点击齿轮按钮设置。了解Portlet通用属性设置，如高度、是否缓存等。
4.信息门户
4.1 创建页面、添加Portlet
在知识中心导航中新建目录，其下新建三个页面：一个信息概览页、一个明细页、一个信息正文页面，正文页面Portlet配置完后要隐藏。
在概览页中添加一个信息列表Portlet，明细页中左侧添加菜单列表Portlet（SubMenuListPortlet），右侧添加一个信息表格Portlet（InfomationGridPortlet）。
信息正文页面中添加一个信息正文Portlet。
4.2 信息列表Portlet、信息正文Portlet模板配置
参考组件模板中已有的信息列表和信息正文模板，列表到正文页面跳转在信息列表模板中实现。
4.3 各Portlet配置
4.3.1 信息列表Portlet
信息列表Portlet主要设置“模板”、“信息栏目ID”、正文页面URL三个属性。“模板”添加上面配置的信息列表模板ID；而“信息栏目ID”是内容管理中对应信息分组的ID，在信息分组中选中需要的分组点击“复制信息ID”粘贴到“信息栏目ID”中即可；正文页面URL则填写上面创建的正文页面的链接。其他属性根据需要设置。
4.3.2 菜单列表Portlet
菜单列表Portlet的数据URL等配置参考知识中心里的对应Portlet，默认值可以自己选择，在内容管理—信息分组中拷贝一个分组父节点ID作为columnParentId的值（即可显示该分组下的子节点列表），拷贝其中一个子节点的ID值作为columnParentId的值。
4.3.3 信息表格Portlet
设置展现模板ID、栏目参数key（columnId）、栏目参数默认值、正文页面URL（使用上面创建的正文页面）等属性。
4.3.4 信息正文Portlet
设置展现模板ID、正文ID参数（contentId）、正文ID默认值等属性。正文Id参数值是通过点击信息列表Portlet或信息表格Portlet中的条目传过来的。在内容管理中对应信息采编或信息发布中的分组下的正文的ID（双击分组下的列表文章，复制信息ID）。
4.3.5 内容管理
内容管理中可以新建编辑分组、采编发布文章（在信息采编中新增文章，保存提交后才可以在信息发布中发布，然后页面Portlet中才可以使用）。采编时还可以给文章添加关键字（在关键字组中配置的），这样在按关键字查询时就能找到包含该关键字的文章。
5.数据门户
5.1 基本图表
5.1.1 图表Portlet配置
在概览页中添加两个基本图表Portlet（配置时可以选择不同类型：柱形图、饼状图等，所需XML数据格式基本是相同的），调整高度等使之适合页面显示。分别显示现金流页面的不同部分数据。
5.1.2 静态数据提供
在组件管理—静态数据中添加上面两个基本图表的静态数据（XML数据）；
数据格式参考已有基本图表静态数据样例、数据（属性值）要自己设置；
静态数据中设置clickURL属性使之都链接到现金流页面；
拷贝静态数据地址到图表Portlet的数据URL中测试；
5.1.3 ESB数据提供
通过ESB Http流程可以从数据表中查询出所需统计数据，也可以在赋值转换组件中通过代码生成测试数据，数据放入DataSet或DataRow中。
赋值转换组件选择转换模板（DataSet—XML），扩展代码，添加XML数据相应属性值。
Response节点返回值设为XML数据结果（document）。
将流程访问URL填入图表Portlet的数据URL中，测试。
5.1.4 Handler数据提供
参考《数据模拟配置及handler开发》文档中的相关内容。
创建一个普通Web应用。
在应用下创建一个数据构造类（代码生成测试数据）、一个XML数据提供handler(根据请求参数从数据构造类中获取相应数据转换为XML数据，与ESB中转换方式相同)。
创建对应JSP页面，页面代码参考已有样例（得到返回的XML数据）、配置文件中增加handler配置。
将handler请求地址填写到图表Portlet数据URL中测试，handler请求地址写法参考文档中给出的地址，端口改为6060，应用名、handler的ID改为自己创建的对应应用、handler。
5.2 常规数据分析页面构建
5.2.1 页面各Portlet配置（现金流页面）
顶部添加一个条件查询Portlet（多种查询方式，年月、季度等，支持扩展查询字段）。
左侧添加一个基本数据列表Portlet、数据列表详细配置参见文档。
右侧上部添加一个堆栈图表Portlet和一个多维图表Portlet，这两个Portlet所需XML数据属性与基本图表略有不同，可参考FusionChart 官方说明文档；这两个图表数据由handler提供，注意handler接收条件查询Bar和左侧数据列表传过来的参数，返回相应数据。
右侧下部添加一个数据表格Portlet，直接在上面创建的数据构造类、handler中扩展表格数据构造、转换方法，同图表Portlet数据通过数据类型参数区分（具体代码及表格Portlet配置参考文档）。
5.2.2 页面内交互、参数传递
以现金流页面中Portlet间交互为例，选择查询bar查询条件后会重新加载页面，其它Portlet中通过${}取得的查询参数值也随之刷新，重新加载相应Portlet后图表数据即会随参数变化。左侧列表与图表交互、与表格交互同理。
5.3 页面间交互、参数传递
5.3.1 概览页跳转至分析页
概览页中基本图表的数据中配置clickURL属性，点击图表即可跳转至相应页面，例如上面配置的概览图表跳转到现金流页面。
5.3.2 分析页跳转至关联页
关联页面财年预算相关页面Portlet复用综合门户决策分析中对应Portlet配置即可；
在现金流页面的条件查询Portlet配置中扩展一个链接，链接到关联财年预算页面；
在财年预算页面的条件查询Portlet配置中扩展一个“返回”链接，返回现金流页面；
5.3.3 弹出表格、明细页跳转
现金流页面中点击图表弹出表格数据页面，通过设置clickURL为JS方法实现；
现金流页面表格Portlet点击单条数据弹出明细页面（全动态Portlet），通过在回调函数中调用JS实现
详细配置及JS参数传递请参考“数据模拟配置”文档及“Portal常用JS使用”文档。
6.应用门户
6.1 单点登录
熟悉后台单点登录配置，包括新建应用分组及应用管理配置；
以SMC管理控制台为例配置单点登录，CAS认证及表单认证方式SMC都已支持；
在首页的应用列表Portlet配置中添加该应用；
6.2 全动态Portlet（消息提醒）
配置首页的通知提醒（全动态Portlet），查看全动态Portlet配置文档。
6.2.1 熟悉组件模板功能
参考Portal中常用JS及组件模板使用文档，组件模板中内置了全动态模板样例，使用到了freemarker指令，参照文档理解各属性意义、如何遍历数据等，然后新建一个通知提醒的模板。
6.2.2 数据提供
复用综合门户首页的通知提醒Portlet的数据提供handler即可。
6.2.3 Portlet配置
使用上面配置的模板及数据URL配置首页通知提醒Portlet。
6.2.4 站内通信配置
参照综合门户对应页面配置（在自己创建的导航中新建目录及页面，完成页面Portlet配置），理清全动态Portlet与该页面跳转关系。
6.3 TabPortlet
结合给出的TabPortlet Json数据格式理解该Portlet（参见综合门户待办任务），了解清楚各属性与Tab显示内容的对应关系，然后自己用所给数据在上面创建的首页中配置成功TabPortlet。
6.4 页面集成
在导航中新建一个目录及一个页面，并在页面中添加一个Iframe Portlet；
访问该页面，配置该Portlet，将url填写为导航中任一页面的链接或外部链接地址，测试是否正常显示；
6.5 菜单集成
6.5.1 虚拟菜单配置
参考虚拟菜单配置文档。
在静态数据中配置虚拟菜单所需Json数据(使用SMC菜单数据)，参考Json样例（直接复用亦可、但是要理解清楚数据各属性的意义）；
点击“新建菜单”，在导航中新建一个虚拟菜单，将json数据地址拷贝到虚拟菜单数据地址中；
新建虚拟菜单显示页面（隐藏），添加SSO界面集成Portlet；
6.5.2 配置SSO界面集成Portlet
参考虚拟菜单配置SSO界面集成文档
首先需要在SSO应用列表Portlet中添加配置单点登录的SMC
在Portlet配置中SSO应用选择上面添加的SMC
URl填写“DynamicRetrieve”为通过虚拟菜单动态得到页面URL
其它属性可根据需要配置
在ESBServer启动情况下，点击虚拟菜单会转到显示页面显示菜单页
7.进阶功能
7.1 权限配置
7.1.1 权限体系了解
通过Portal相关PPT、文档等途径了解Portal中完善灵活的权限体系。了解清楚群组、用户、角色三者的关联关系以及其权限继承关系等。
7.1.2 群组、角色、用户关联
在群组管理中可以新增编辑群组，在群组下新建用户；在角色管理中可以新增编辑角色，添加关联群组、关联用户。
Portal中内置了一个所有用户角色，该角色关联的群组、用户默认对所有资源都可以访问。
添加测试数据。
7.1.3 资源权限分配
添加好群组、角色、用户后就可以进行资源访问权限分配了。三种方式：按群组分配、按角色分配和按用户分配（在各资源的安全管理Tab页中分配）。
分配好权限后，使用新建的用户重新登录门户测试。
7.1.4 数据权限分配
数据权限是指对数据专门设立的权限，主要针对群组的用户。即只有被允许的用户才能访问该数据。主要流程是，先通过用户查询到用户所在的组群，通过群组确定有哪些权限。基本上各层级资源都支持权限分配（大至导航、小至一个图片）。
主要步骤就是先对编码分组、配置，接着新增数据资源，然后对新增的资源进行授权。
7.1.5 复用说明
我们实际做一些项目的时候，发现了这样的一个问题，就是在这个系统的资源的权限，与另一个系统里同样存在，那么这个时候就需要权限的复用了。权限复用主要分三种：一种是在两个不同的数据库、一种是在同一个数据库下、最后一种是完全不是我们的系统，即权限的体系完全不同。方法分别为：在新数据库中创建视图、直接使用Portal中的权限表以及用户同步。
7.2 用户个性设置
AEAI Portal支持用户的各种个性设置。包括个性布局、个性主题、个性装饰、收藏夹等等。注意它们在数据库表中的记录位置。
7.2.1 个性布局
使用一个普通的帐号登陆系统，登陆系统之后，可以找到个人设置的按钮。点击激活设置面板，就可以对其进行个性布局了。
7.2.2 主题
管理员可以通过后台控制，对主题个性化设计。用户也可以在页面中选择自己喜欢的主题。
7.2.3 个性装饰
装饰与主题相似，同样分为两个部分，一部分是管理员进行设计，另一部分是用户进行使用。
7.2.4 收藏夹
在用户登陆Portal系统之后，上面导航栏处有一个收藏夹的按钮。
在分隔线上面有两个选项，一个是加入收藏夹，另一个是管理收藏夹。分隔线下面有若干个网页的名称，它们都是被收藏了的网页，直接点击就能跳转到该页面了。
点击加入收藏夹就将该网页添加到收藏夹中
7.3 Portlet开发及配置
7.3.1 Portlet开发
以日程安排Portlet开发为例。
创建一个集成Web应用
通过功能创建向导创建一个Portlet功能模型，生成模型代码、页面
参考日程Portlet开发文档改造代码、页面，重在理解Portlet的交互机制（包括annotion、mode等理解，用到的JS的理解等）
在Portlet配置文件中增加Portlet信息，部署启动应用。（开发平台已经自动生成，但需要读者了解）
7.3.2 门户中添加Portlet配置
在“组件管理—Portlet应用”中添加新建的应用；
在Portlet设置中新增，选择所属应用后就可以选择应用下的Portlet了，选择好所属分组后保存即在门户中添加了该Portlet，然后就可以在页面中添加使用了。
7.4 常用JS的熟练
数据门户中只用到了Portal中几个在数据门户中最常用的JS，还有很多常用的JS，可参考Portal中常用JS文档，然后在Portlet或页面中调用相应JS，通过Chrome的JS调试熟悉这些JS。
AEAI Portal门户平台学习路径文档 下载