AEAI-Portal门户平台技术手册.docx

分享SOA平台软件 传递敏捷集成机制AEAI Portal门户平台技术手册（V3.5）目 录1概要42部署过程52.1安装JDK52.2安装及配置MySQL52.3部署PortalServer53预置模块73.1信息门户73.2认证中心83.3综合门户93.4知识门户103.5产品门户113.6开发社区133.7移动门户144基本配置164.1展示视图164.2编辑视图174.3配置装饰175门户管理185.1门户管理195.1.1导航管理195.1.2主题管理215.1.3装饰管理225.2组件管理235.2.1Portlet设置235.2.2Portlet应用255.2.3Widget组件255.2.4Handler设置265.3组织权限275.3.1群组管理275.3.2角色管理275.4内容管理295.4.1信息管理305.4.2资源管理355.5数据管理375.5.1组件模板375.5.2静态数据385.5.3表格设置395.6单点登录415.6.1应用分组415.6.2应用管理425.7论坛管理425.7.1用户管理435.7.2模块管理435.7.3论坛编码445.8编码管理455.8.1编码分组455.8.2编码配置466关于我们481 概要门户集成平台Portal可以作为企业的应用中心，或者是企业应用的入口，在统一的界面上聚合现有各业务系统的数据、菜单、界面，为各类用户如：合作伙伴、客户、公司领导、员工提供多渠道（如：PC、移动设备等）方式访问接入，沈阳数通畅联软件技术有限公司的门户产品命名为AEAI Portal。基于AEAI Portal可以快速构建常见的门户项目，如：信息门户、知识门户、数据门户、应用门户，当然可以构建综合应用门户或者综合信息门户，AEAI Portal自带信息门户、数据门户、知识门户、应用门户、开发社区、移动网站、移动门户等样例。AEAI Portal主要特性如下：1) 基于Java构建、可以跨平台部署；2) 底层基于Pluto，符合各种Potlet相关标准，页面片段动态聚合；3) 底层具备缓存和Ajax机制，响应速度快，操作友好；4) 内置多套主题、装饰器，同时具备灵活的扩展机制便于客户化定制； 5) 热部署方式的Portlet应用加载，快速Portlet注册、配置模块；6) 内置导航、菜单、页面管理，以拖拽方式对布局拖拽式的调整与配置；7) 基于主题、导航的扩展机制，可以专门为大屏幕、PC、Pad、智能手机定制不同的门户页面，同时复用既有的Portlet和信息资源；8) 预置组织、用户、角色以及灵活的授权体系，同时自带基于Jasig CAS的统一身份认证模块；9) 自带集成信息门户、知识门户、数据门户、知识门户样例可以快速上手；10) 预置丰富的各类Portlet组件来丰富的信息门户、知识门户、应用门户；11) 预置强大的内容管理模块可以对信息、图片、附件等资源以资源仓库方式管理，为信息门户、知识门户相关Portlet提供信息源；12) 基于Miscdp应用开发平台可以快速扩展开发客户化Portlet组件。本文档主要介绍AEAI Portal的部署过程、简要说明门户集成的常见功能以便于快速上手使用。2 部署过程2.1 安装JDK在数通畅联公司网盘下载JDK介质，/s/1zx7iu，安装步骤略。2.2 安装及配置MySQL1. 在数通畅联公司网盘下载MySQL介质，/s/1hqGgeCs。2. 安装过程略，配置MySQL数据库时，字符集一定要为UTF-8。3. 创建数据库aeai_portal，在后续配置过程中会使用到。2.3 部署PortalServer解压PortalServer环境介质portal_server_x86_vXXXX.rar，解压后执行portal_server_x86_vXXXXbin文件夹下startconfigtool.cmd文件会弹出门户平台设置窗口，如下图所示：这时需要在服务器配置下的“JDK路径”的文本框中填写本机的JDK路径，然后在选择数据库配置，如下图所示：在“连接URL”处需要修改成之前已经在MySql中建好的aeai_portal数据库，填写之前设置好的数据库用户名及密码，点击“测试连接”按钮，如果配置正确会提示连接成功，点击“应用”按钮后关闭。注意 “初始化数据”按钮，如果是首次安装portalServer且portal数据库是空的，那么这时点“初始化数据”会自动在portal数据库中生成portalServer运行时所需要的数据表及数据，否则会覆盖既有的数据表。配置完成后即可运行portal_server_x86_vXXXXbin文件夹下的startup.bat文件，出现下图样式表示运行结束，即可在浏览器上登入。在浏览器输入：http:/localhost:8080，默认显示的是信息门户。如下图，详情参加3.1。3 预置模块基于AEAIPortal门户平台可以快速构建信息门户、知识门户、数据门户、应用门户、移动门户，还可以构建综合应用门户或者综合信息门户来作为企业信息系统的统一入口。AEAI Portal预置样例模块如下：3.1 信息门户信息门户主要是企业对外的信息展现门户，一般指公司的网站，如企业的发展历程、产品业务信息、招聘信息等。本产品中在浏览器地址栏输入http:/localhost:8080后，默认预制就会显示数通畅联的网站页面，即：数通畅联的官方网站也是基于AEAI Portal配置而成的。3.2 认证中心AEAI Portal 预置统一认证CAS模块，负责各集成系统的统一身份认证，在浏览器地址栏上输入http:/localhost:8080/portal/login.jsp，回车跳转至统一认证页面，显示如下图：输入系统管理员的账户和密码（演示账户：admin 密码：admin）登陆成功后跳转至应用门户如图，应用门户详情参见3.3。3.3 综合门户综合门户包括应用门户、数据门户等信息整合到一起综合地进行展现，还有很多常用的功能，如：通讯录、日程安排等。点击信息门户左侧菜单的功能，可以直接跳转相应的界面。在应用门户中点击左侧菜单“知识门户”、“产品介绍”，对应跳转至知识门户、产品门户界面。3.4 知识门户知识门户，即企业的知识中心，主要为企业文化沉淀、知识积累的分享平台，也包括对外的面向企业内部的资源。3.5 产品门户产品门户是企业各产品的统一展现平台，里面记录了企业的产品信息介绍等。3.6 开发社区开发社区为数通畅联的官方论坛，链接配置后，点击链接到论坛。在论坛中可以对数通畅联的产品及方案进行深入的交流和讨论，同时可以查看数通畅联的公司信息、服务、报价体系等。3.7 移动门户移动门户包括首页、知讯、问答和我的等信息整合到一起在移动端进行展现，还有很多常用的功能，如：待办任务、最新消息等。点击信息门户左侧菜单的功能，可以直接跳转相应的界面。在手机端浏览器直接输入网址链接就可以进行移动端访问。 4 基本配置前面已经简单介绍了登陆AEAI Portal应用中心的方法，现在将具体讲解配置方法，我们可以在页面右上角看到“编辑组件”按钮，如下图所示：编辑组件是对整个页面的portlet进行编辑调整，当点击编辑组件按钮时跳转到如下页面：4.1 展示视图上图所显示的即是展示视图，在编辑组件状态下，页面上每个portlet右上角会有一个下拉可选框，里面包括（VIEW、EDIT两个选项）VIEW状态显示的是预览功能，EDIT状态显示的是编辑功能，如下图所示：展示视图即展现配置完成的portlet最终显示效果。4.2 编辑视图当选择EDIT状态时，会展现如下视图：根据portalet类型不同，当然展现的编辑视图也是不一样的，上图是一个全动态portalet的编辑视图，以上图为例，在编辑视图时可以对portlet的高度、html模版（即展示视图所展现的布局、样式等）、回调函数、数据URL（数据来源）、默认值、解析方式、是否缓存、缓存时间等属性进行设置，点击保存就可以生效。4.3 配置装饰在下拉选择框的左边有一个隐藏的齿轮状按钮，当鼠标光标浮动到portlet的标题栏时按钮就会出现。如下图：点击此按钮会弹出配置窗口外观窗口，如下图所示：可以对此portlet的外观进行相应的设置。5 门户管理登陆AEAI Portal应用中心，我们可以在页面右上角看到“门户管理”按钮，如下图所示：当点击“门户管理”按钮时跳转到下面的页面：此页面是门户管理控制台，菜单项包括“门户管理”、“组件管理”、“组织权限”、“内容管理”、“数据管理”、“单点登录”、“论坛管理”、“编码管理”、“返回门户”等功能。菜单项下面的两个按钮分别是“编辑组件”、“退出系统”。5.1 门户管理门户管理模块主要包括：导航管理、主题管理、装饰管理三个功能，鼠标指向门户管理菜单时会弹出子级菜单如下图：5.1.1 导航管理点击上图的“导航管理”可以跳转到下面的页面： 管理导航管理导航主要是对“门户管理”、“组件管理”、“组织权限”、“内容管理”、“单点登录”、“论坛管理”、“编码管理”现有的导航进行增删改管理，也可以对导航进行扩展。当双击“管理导航”可以跳转到下面的页面：可以通过左侧树型菜单对导航进行增删的操作。以及对树型菜单里面的子菜单进行增删和授权操作，“基本信息”选项卡对下一级菜单进行增删操作，“安全管理”选项卡对菜单进行授权操作，如下图： 综合门户双击“综合门户”跳转到下面的页面：综合门户是登录后的默认门户，在此可对其菜单、页面进行编辑5.1.2 主题管理当点击“主题管理”跳转到下面的页面如图：可以双击每一条记录对主题进行设置，主要的设置就是title、footer等等，都是由我们的“路径”项下面的jsp文件来决定的，这些jsp要由特定人员来编写。编辑页面如下图：5.1.3 装饰管理装饰管理主要是对Portlet组件外观进行配置，对应Portlet配置外观中的装饰器：默认提供了几种装饰器，可以自定义，点击“门户管理”-“装饰管理”弹出下面的页面，可以进行添加。如下图：5.2 组件管理组件管理主要是对Portlet组件进行管理，包括Portlet设置、Portlet应用、Portlet分组、Handler设置，具体说明如下。5.2.1 Portlet设置点击Portlet设置跳转到下面的页面，如下图：上图列表显示的Portlet组件都是现系统内置提供的Portlet组件，可以直接使用，如有组件功能满足不了特殊需要，可以通过AEAI DP开发平台扩展开发Portlet。当点击“新增”时会跳转到下面页面：可以把新开发的portlet组件添加到里面，portlet有四个属性，分别是标题、所属应用、portlet名称、分组。5.2.2 Portlet应用当点击组件管理中Portlet应用时跳转到下面的页面，如下图：现Portlet应用只有两个，分别是portal、portal_portlets，从应用的角度我们给portlet进行分类。也可以根据需要进行增加、删除应用等操作。这个分类就是上面“portlet设置”里面“所属应用”需要的选择项。5.2.3 Widget组件Widget组件主要功能是配置移动门户中的页面组件。当点击组件管理中Widget组件时会跳转到下面的页面，如下图：随便双击一个其中的widget组件时会弹出下面的页面，进行编辑。也可以在上图进行增加删除等操作。5.2.4 Handler设置Handler设置主要功能是配置控制器的访问类型，类型有三种分别是“系统内置”、“认证校验”、“公开访问”。当点击组件管理中的Handler设置时会跳转到下面的页面，如下图：随便双击其中一个Handler时会弹出下面的页面，进行编辑。也可以在上图进行增加删除等操作。5.3 组织权限组织权限模块主要包括：群组管理、角色管理、数据资源、数据授权。可以实现对集团公司组织架构、成员管理以及对模块权限进行管理控制。5.3.1 群组管理点击“群组管理”跳转到下面的页面，如下图：图的左侧是一个树型组织人员树列表，通过根节点（公司集团），可以创建子群组，子群组下面还可以创建其子群组，群组下面可以关联用户。一个用户可以属于多个群组，一个群组可以包含多个用户，它们是双向多对多的关系，更加灵活。5.3.2 角色管理当点击“角色管理”跳转到下面的页面，如下图:图的左侧是一个树型角色人员树列表，通过根节点（系统角色），可以创建不同的角色，角色可以关联用户和群组，也是双向多对多的关系。组织架构，角色都创建完，就可以对“导航”、“菜单”、“页面”进行授权。以菜单授权做一个例子，步骤如下：1. 通过用户名及密码成功登陆门户。2. 点击“门户管理”如图所示：双击“综合门户”弹出下面的页面，如图：点击“工作台”，右侧切换到安全管理，如图：可以对角色、用户、群组进行灵活授权。5.4 内容管理内容管理模块主要包括：信息采编、信息发布、信息分组、关键字分组、图片管理、视频管理、附件管理、资源管理等功能。5.4.1 信息管理 信息分组当点击“信息分组”会跳转到下面的页面，如下图：根据左侧树型列表，创建信息分组，在根节点（信息栏目）依次添加子节点，子节点下面再添加子节点，前一节点就变成文件夹状态可包括多个子节点。 信息采编当点击“信息采编”时会跳转到下面的页面，如下图：“信息采编”通过在“信息分组”创建信息架构，点击树形节点，例如点击“产品文档”中的“门户集成平台”，右侧就会显示分组中的内容。可以通过“新增”、“编辑”、“查看”等功能按钮对“信息模板”下的信息内容进行增删改查操作。 信息发布当点击“信息发布”会跳转到下面的页面，如下图：“信息发布”通过在“信息采编”创建的信息内容，在“信息发布”页面可以对信息进行“发布”和“反发布”等操作。选择采编信息的文件夹，之后在对应的下面点击新增，进入编辑页面写好标题之后点击保存跳转至下方页面，然后点击右上方的正文内容对文章进行编辑。编辑好后回到信息采编界面，点击提交后，在信息发布中点击发布即可，发布后可在知识中心看到发布的文章。 关键字组当点击“关键字组”会跳转到下面的页面，如下图：5.4.2 资源管理资源管理是对门户所需的素材及材料进行统一的管理，如图片、视频、音频、文章等等都可以在资源管理模块下进行管理。 资源管理当点击“资源管理”会跳转到下面的页面，如下图：主要功能是创建“资源管理”可以存储管理的信息类型。是一个典型的树形架构。 图片管理当点击“图片管理”会跳转到下面的页面，如下图：“图片管理”主要功能是对门户平台相关图片进行分类分组管理。 视频资源当点击“视频资源”会跳转到下面的页面，如下图：“视频资源”主要功能是对门户平台相关视频进行分类分组管理。 附件管理当点击“附件管理”会跳转到下面的页面，如下图：“附件管理”主要功能是对门户平台相关附件进行分类分组管理。5.5 数据管理扩展管理模块包括“组件模板”、“静态数据”、“表格设置”三个功能。5.5.1 组件模板组件模板是基于FreeMarker模板引擎开发的显示模板，在这里用于为全动态Portlet提供数据的显示模板。当点击“组件模板”会跳转到下面的页面，如下图：点击“新增”显示如下页面：双击创建的模板，可以在弹出的空白页面中定义显示的样式及显示数据。5.5.2 静态数据静态数据用来定义模拟显示数据，一般用于信息列表显示构造数据。当点击“静态数据”会跳转到下面的页面，如下图：点击“新增”显示如下页面：双击创建的模板，可以在弹出的空白页面中定义显示的样式及显示数据。5.5.3 表格设置当点击“表格设置”会跳转到下面的页面，如下图：点击“新增”跳转到下面的页面，如下图：例：创建“员工时间情况明细表”，如下图：填写完之后保存。如下图：点击选中“员工时间情况明细表”，再点击“字段配置”弹出下面的页面，如下图：点击“新增”编辑完成如上图这些字段。5.6 单点登录单点登录模块，主要包括应用管理、应用分组配置功能。5.6.1 应用分组当点击“应用分组”会跳转到下面的页面，如下图：“应用分组”的功能是为“应用管理”中的应用进行分类。5.6.2 应用管理当点击“应用管理”会跳转到下面的页面，如下图：可以通过“新增”、“编辑”、“查看”、“删除”等操作来对单点登陆的系统进行管理 。点击“新增”跳转到下面的页面，如图：根据门户需要配置应用。这里的“分组”属性就是“应用分组”模块为“应用管理”分类使用的。5.7 论坛管理论坛管理模块主要包括用户管理，模块管理，论坛编码三项功能。论坛的用户信息模块是将激活论坛的用户进行管理，模块管理主要对论坛的模块进行分类管理，论坛编码是将论坛中涉及的编码统一定义。编码管理模块主要包括编码分组，编码配置两项功能。门户的所有编码配置，包括扩展的Portlet涉及的编码都可以再编码管理模块进行统一定义。5.7.1 用户管理当点击“用户管理”会跳转到下面的页面，如下图：可以通过同步，同步系统中的内部用户到论坛用户中。双击用户，会弹出下面的窗口，如下图：5.7.2 模块管理当点击“模块管理”会跳转到下面的页面，如下图：可以通过新增、保存、复制、迁移、上移、下移对模块进