1. 场景说明

    产品管理(以下统称 upc)需要使用 base 做统一外框,但需要定制相关功能及 UI,下面将简要说明如何在 base 的基础上定制开发。假设 WEB 工程名称为 upc。

  2. 第一步:同步文件

    1. webframe/lib/base.jar 同步到 upc/WEB-INF/lib/base.jar
    2. webframe/web/base 目录同步到 upc/html/base
    3. webframe/web/WEB-INF/base.application 目录同步到 upc/html/WEB-INF/base.application
    4. webframe/web/upc 目录同步到 upc/html/upc
  3. 第二步:注册页面

    1. 引用 base 公共页面

      修改 upc/html/WEB-INF/upc.application 文件,嵌入 base.application

      <!DOCTYPE application PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN" "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd" [
      	<!ENTITY base SYSTEM "base.application"> 
      ]>
      <application engine-class="com.ailk.web.BaseEngine" name="upc">
      	...
      	&base;
      	...
      </application>
      
    2. 指定默认访问页面 Home

      修改 upc/html/WEB-INF/upc.application 文件,指定 Home 页面为 /base/Home.page

      <!-- base -->
      <page specification-path="/base/Home.page" name="Home" version="1212"/>
      
  4. 第三步:定制业务界面 UI 风格

    修改 upc/config/global.properties 文件

    修改配置参数:ecl.skin=upc,若不存在则创建之


    --- 到这里就可以成功的展现 base 的结构和 upc 的组件风格了 ---

  5. 第四步:定制功能

    1. 定制登录

      1. 在 application 中修改 Home 配置为:<page specification-path="/upc/Home.page" name="Home" version="1212"/>替换默认的登录页

      2. 在 global.properties 中配置acccess.bean.path=com.ailk.appengine.web.view.AppEngineAccess实现数据库访问

    2. 定制欢迎页/首页

      在 global.properties 中修改 welcome.page 为welcome.page=Upc.Welcome


    --- 到这里就可以成功的展现 upc 的登录、主界面了 ---

  6. 第四步:定制区域

    1. 定制 Header 区

      需要显示 header 区、不显示 header 区中的 “更多”、“锁定” 及 “子系统”
      修改 global.properties 文件,配置如下:

      main.show.header=true
      main.show.header.showmore=false
      main.show.header.showsubsys=false
      main.show.header.showlocked=false
      
    2. 定制侧栏

      需要显示侧栏、修改辅助功能去代码片段
      修改 global.properties 文件,配置如下:

      dynamic.sidebar.html.src=com/ailk/base/view/jwcs/dynamic/basehtml/ShortcutSideBar.html
      main.show.sidebar=true
      
    3. 定制主菜单区

      需要显示主菜单区、去掉“收藏”与“搜索”功能
      修改 global.properties 文件,配置如下:

      main.show.mainmenus=true
      main.show.mainmenus.showsearchmenu=false
      main.show.mainmenus.showfavmenu=false
      
    4. 定制状态栏

      需要显示状态栏
      修改 global.properties 文件,配置如下:

      showcopyright=true
      
    5. 定制侧栏显隐按钮

      需要显示侧栏显隐按钮
      修改 global.properties 文件,配置如下:

      main.show.slip=true
      


    --- 到这里就完成了外框对 upc 的定制,客户端展现的所有内容都将是 upc 的风格 ---