J2EE平台eOffice项目实施手册

J2EE平台eOffice项目实施手册一．概述本手册对产品做一个简单的介绍，并就如何配置系统做详细的介绍。涉及到开发的部分，将在《项目开发手册》中体现。二．产品简介该产品建立在J2EE平台之上，后台使用关系数据库。在公司的测试开发版本的依赖平台是：Tomcat+MySql。客户使用较多的是WebSphere/WebLogic+Oracle。理论上，任何关系数据库都支持，因为我们的系统开发采用了标准SQL语法。但事实上还是有些修改。基本上，没有什么问题。该产品围绕着“配置化开发”而设计，实现了内容管理、流程设计等工具，通过这些工具，搭建一些功能应用基本上不需要编写代码。不过对于用户的一些细节要求譬如操作的方便性、功能的增加等方面还是有或多或少的代码开发量。对于这些开发，系统都提供了接口，即不需要进入修改核心代码，只需要将编写的代码通过系统提供的接口来关联，对系统的数据进行操作。三．实施元素实施涉及到元素全部在“系统管理”模块中，通过该模块可以实现模块实施。1．内容类别：这是该产品中最重要的元素之一。在这里包含了：建立数据表结构、建立简单的表单工作界面、建立视图界面、实现一些新建、删除、查询、修改等一些通用的功能。2．系统角色：设置一些基本的角色，主要是为了权限的控制。这些角色将具有一定的权限，而这些角色又可以分配给个人，这样，权限就可以比较方便的控制到个人。3．系统用户：建立使用本系统的用户。在这里建立用户名、密码。以及设置用户的手机号码、系统角色、签名图像等。4．目录权限：可以设置每个内容能被具有哪些权限的人员使用或维护。在设置内容类别的时候，所有需要目录管理支持的内容都在这里体现。5．系统菜单：本产品使用自定义的菜单，通过这个方式可以让系统的菜单配置比较简单。这里的菜单设置之后，将会在界面上体现出来。6．数据字典：有一些选择项是变动的，数据字典解决的就是这方面的问题。可以在这里设置数据字典，相关的内容将会自动被获取到相应的选择项中。7．定时事件：有些事件需要定时执行譬如定时删除一些垃圾、定时检查通知公告等，系统为定时事件提供了接口，所有定时事件都采用可以由程序员编写class,系统将通过接口程序定时调用class来执行有关工作。8．UMS服务：9．UMS日志：提示信息的发送日志10． 操作日志：重要操作的日志11． 刷新设置：有些更新譬如内容类别、人员、部门的增加等操作之后，需要执行该操作才能让相应的内容正确显示。如果在设置信息之后发现结果和想象的不符，先执行一下该操作即可。12． 文档模板：系统中要使用到很多模板，用户在这里可以设置各相应的模板。包含有word模板和eword模板两种（eword是公司自行开发的编辑器）。13． 特殊日期：有很多文件有限办日期等要求，有些是要按工作日计算。所以，系统考虑到有节假日、加班/调休工作日等因素存在，所以设置该特殊日期。14． 机构设置：系统建立完用户之后，还需要根据实际的组织机构、人员在流程中承担的角色等方面来为每个用户进行组织机构和角色的分配。在这里可以设置人员的排序，也可以设置所有人员具备的角色。15． 过程定义：过程即流程，在这里可以设置系统需要的流程，流程涉及到的角色等多个方面。四．实施步骤在本手册中，我们将就一个项目如何开发展开讨论，涉及到和本产品有关的将以具体详细的描述来进行说明。前提：已经完成了系统的需求调研。第一步：分析整理需求1．分析需求，将系统按模块划分，分成各大模块、各子菜单

模块1模块2模块3模块4菜单1菜单1菜单1菜单1子菜单子菜单子菜单子菜单菜单2菜单2菜单2菜单22．分析各模块数据彼此之间的关联可以采用数据库建模工具。也可以简单的分析，如：合同管理中，和合同信息有关联的有：客户信息、工程项目信息等多个方面。并且通过这些数据关联的分析，对你的每张表的数据结构设计提供帮助。3．分析每张表的数据结构，包括：每个字段名称、类型、长度、是否选择项等表名：合同管理tblHeTong字段名称字段描述类型长度备注id数字型自增长fldName合同名称文本型255fldgcxm对应工程项目文本型255从工程项目列表中选择fldkhname客户名称文本型255从客户名称列表中选择4．分析每张表对应的办理界面，即工作表的排版。以及视图查询界面中的排序和字段分布。♦工作表的排版工作表名：合同管理合同名称工程项目客户名称预签日期合同金额♦视图的布局视图名称：合同查阅排序方式：按时间排序；分类方式：无分类合同名称客户名称预签日期验收日期

5．分析该表是否和流程相关，如果是，流程如何。该表将要进入流转。流程如下：是否会签?工程服务部门会签计划财务部门会签可同时或 顺序发送形成专会签意见法律部门审核合同审批申请是否会签?工程服务部门会签计划财务部门会签可同时或 顺序发送形成专会签意见法律部门审核合同审批申请领导签发反馈法律部门办结6．如果和流程相关，分析涉及到的角色，并定义角色名称以及具备该角色的人员流程名称：合同审批流程序号角色描述对应人员1合同审批申请起草合同审批申请人具备的角色所有人员2合同审核法律事务部专职负责审核合同的人员具备的角色法律部门合同审核人员和法律部门领导3合同会签可能会签合同的部门具备的角色所有部门的领导4合同签发负责签发合同的领导具备的角色局长、主管副局长第二步：开始建表1． 单击菜单“系统管理”——〉“内容类别”，系统右侧分类列出所有已经设置好的内容类别2． 单击上方的“新建”按钮，系统出现字段设置界面如下：保存取消'—' 内容类别雅本届性字段；表单观粵数据库连接：艇连接-分类：1--类别名毎:1别名：t1主键：1目录管理支持：广需要e不需要映射表名；：.1是否重建表结构＜■.厂是拧否读者域：厂是否可用：冷是广否Copyright(c)2000_2003,EESYSTechnologyCo.^Ltd.该界面分为四个卡片：“基本属性”、“字段”、“表单”和“视图”。各自的功用分别如下：基本属性：数据库连接：使用缺省连接就可以。分类：录入“合同管理”，该字段表示在“内容类别”视图中显示了所有内容中的第一列即折叠分类的列。分类让用户的信息更容易找到，譬如，所有合同相关的内容都放到一起。类别名称：录入“tblHeTong”，即合同审批申请表单的名称。别名：录入“合同审批申请”，用中文名称，让用户显示更直观。主键：设置该数据表的主键，如果设置了目录管理支持，则不需要设置。目录管理支持：选择目录管理支持，则可以控制所有的用户对该表单的访问、维护等相应权限，且只要选择了该项，系统将自动生成主键，所以，主键可以不设置。映射表名：指可以映射到外部任何数据库中的表，对应第一项“数据库连接”，主要是集成其他数据库的数据时有用。是否重建表结构：在修改表结构之后，可以选择重建，则该数据表被完全重新建立。千万注意——已经有正式数据的时候，不能执行该操作，否则数据将会完全丢失。读者域：和流程相关的时候，该流程一定需要读者域，该域中将会存储所有经手该文件的人员ID,由于任何一个读者域最大只有255个字节，考虑到实际情况中可能超出，可以使用多个读者域，譬如在这里，我们可以设置3个读者域如：fldReaders,fldReaders1,fldReaders2。是否可用：选择“是”。字段：单击字段卡片首先看到的是显示所有字段的视图，单击“新建”按钮，系统将出现字段的录入界面，在这里按照预定的数据结构录入相应的内容，每录入完成一个，单击保存就可以，如此反复的使用该功能，将字段完整的录入。保存取消内容字段基本屋性字段輪号：0字段名：别名L 1类型：字符型（可变:绘度） V字段畏度：0星小长度:;E 1枚举数誓参薮枝省值琴数:厂是否用于查询二斥是广否Copyright（c）2000-2003^EESYSTechnologyCo.Ltd.字段编号：该字段是为所有字段的排序用，根据界面的需要可以设置相应的顺序。以合同审批申请为例，对字段“合同名称/fldName”进行设置。录入字段编号“0”字段名：录入字段名称“fldName”别名：录入字段描述“合同名称”。该别名将体现在工作表的操作界面上类型：选择“字符型（可变长度）”，相当于数据库中的varchar类型。在本系统中共包含有以下几种字段：字符型（固定长度）：相当于数据库中的char类型。表示该字段的数据是固定长度的文本。字符型（可变长度）：相当于数据库中的varchar类型。表示该字段的数据是文本型，且长度可变，长度范围在最小长度和字段长度之间均可。短文本型：设置为短文本型后，数据长度还是在255字节以内，但不同的是在界面上显示的是多行的录入框即textarea。长文本型：设置为长文本型后，数据长度没有限制，不同的是在界面上显示的是多行的录入框即textarea。数字型：包含了整型、小数等所有数字型。日期型：日期。枚举型：有一些字段需要实现选择功能，在这里设置枚举型即可达成该目的。具体的选择内容在“枚举参数”中体现。eword文本：我们在系统中内置了一个自行开发的编辑器eword，在其中可以实现文字录入和简单的排版。对于很大的内容，可以将其体现在这里。字段长度：录入“255”。这里体现该字段的最大长度，当实际工作中超过了预定的字段长度，则系统会有相应的提示。小数位数：如果是数字型，可以根据需要设置该项内容。最小长度：确定该项录入的最小长度，譬如可以用来设置是否为空。枚举数据参数：枚举参数在本系统中分为两种。其一是，直接设置的枚举参数，譬如可以在这里直接设置枚举参数为——优秀:良好:一般。该参数的设置通过“冒号”分开。；其二是，通过数据字典来设置枚举参数。示例：假设在数据字典里面设置了类别为“评价结果”（别名）的一系列参数，其类别名称为“categoryPJ”（具体的设置方法请参考后面的“数据字典”），则只需要在枚举参数这里设置函数系统提供的方法即可，如——“sys_enumerations:/categoryPJ/:EnumID:EnumName”，这是对只有一级分类的数据字典的获取方法，如果有两级或多级，只需要在categoryPJ/之后再增加类别名即可。基本上的格式是：/一级类别/二级类别/…/。缺省值参数：表示该字段的缺省值。如果是文本型，直接写上该缺省值就可。如果是日期。是否用于查询：表示该字段是否被自动列入该表对应视图的查询条件中。表单：表单即工作界面，表单的设置步骤基本如下：选择卡片“表单”，下方列出该内容类别已经设置好的所有表单，单击“新建”按钮，系统出现表单的设置界面。表单的设置界面中包含两部分“基本属性”和“表单字段”。在基本属性中设置表单的一些基本内容。表单名称：default。无需修改别名：缺省表单。无需修改是否扫描图像：如果需要在本表单中增加扫描图像功能则选择“是”，否则选择“否”。该功能选择后需要修改表单对应的JSP文件，具体操作请参考开发手册。是否上传附件：需要上传附件则选择“是”，否则选择“否”。该功能选择后需要修改表单对应的JSP文件，具体操作请参考开发手册。工作流相关：如果要应用到工作流中，选择“是”，在这里选择是。是否只读：根据表单在操作中是否可以修改内容，选择该属性。JSP文件：是否生成JSP文件，缺省为auto。将其删除后，则生成对应的JSP文件，譬如在这里生成tblHeTong_form.jsp。该jsp文件要在通过IE显示该页面之前才会生成。生成后，用户可以对其进行修改。所有的表单JSP都被存放在目录formadmin目录之下。表单级别：对于不通过其他表单打开的表单，通常级别为0，而后依次为1，2，3…。事件类名称：为该表单提供的事件接口，可以编写class在此处调用。标签页标题：可以将表单中相应的字段分别组合，在界面中体现到不同的卡片中。其工作界面的卡片就像目前我们操作的表单卡片一样。如果只有一个卡片，可以设置为“基本信息”或较为通俗的名称设置表单字段。单击表单字段，系统将会将已经设置好的表单字段全部按照既定的顺序列示出来，对于需要显示在表单中的字段进行一次设置。设置中涉及的字段在用户界面中将按照从左到右，从上到下的方式进行排列。具体的设置方法如下：字段编号：按照需要进行设置，录入相应的数字即可。缺省的使用在字段中已经设置好的字段编号。字段名：从原有字段种选择来，通常无需修改。输入框长度：分为“长格式”和“短格式”两种，当选择长格式时，该字段在用户界面上将占据一行，如果是短格式，则仅占据一行的1/2。是否密码格式：如果选择是，则该字段的录入显示码是加密的譬如显示“*”代替了所有的录入字符。标签页编号：根据上面设置的“标签页标题”进行分配。表示该字段分配到相应的标签页。设置完成之后，单击“保存”即可完成表单的设置或修改。视图：视图即用来显示所有符合条件数据的列表，视图的设置步骤基本如下：i.选择卡片“视图”，下方列出该内容类别已经设置好的所有视图，单击“新建”按钮，系统出现视图的设置界面。视图的设置界面中包含两部分“基本属性”和“视图字段”。保存职消内容视图-缺省视图華車■屋牲 视图字段視船名瑶：|default别名：缺省视图是否显示查诲栏总忖是广否是否昱示目录：广是件否关联内容类別:groups固定条件：c.fldZBBMID=groups.MemberDirlPJSP文件：£awenlist.jsp視阙皱别:0是否自动刷新：广是於否是否自动SE计：广是样否排序方式：,c.fl.iZEEMin李件类名8：:内容表单：default是苦只读：a是厂否Copyright(c)2000-2003.,EESYSTechnologyCo.,Ltd.ii.在基本属性中设置视图的一些基本内容。视图名称：default。无需修改别名：缺省视图。无需修改是否显示查询栏：如果选择“是”，则在该视图的用户界面上，将出现“组合检索”和“显示搜索条”两个按钮，单击后显示条件的设置栏目中将会列出在所有可用于“查询”的字段。如果选择“否”，则不提供查询功能。是否显示目录：关联内容类别：固定条件：设置该视图的条件，即哪些内容可以在该视图中显示。JSP文件：是否生成JSP文件，缺省为auto。将其删除后，则生成对应的JSP文件，譬如在这里生成tblHeTong」ist.jsp。该jsp文件要在通过IE显示该页面之前才会生成。生成后，用户可以对其进行修改。所有的表单JSP都被存放在目录listadmin目录之下。视图级别：对于不通过其他页面打开弹处的视图，通常级别为0，而后依次为1，2，3…。是否自动刷新：是否自动统计：排序方式：事件类名称：内容表单：是否只读：视图字段是设置在该视图界面上要显示的一些相关内容和属性。单击视图字段，系统将会将已经设置好的字段全部按照既定的顺序列示出来，对于需要显示在视图中的字段进行一次设置。设置中涉及的字段在用户界面中将按照从左到右的方式进行排列。具体的设置方法如下：字段编号：按照需要进行设置，录入相应的数字即可。缺省的使用在字段中已经设置好的字段编号。字段名：从原有字段种选择来，通常无需修改。列示方式：分为不显示、显示为文本和显示为连接三种。如果显示为连接，则表示在视图界面中用鼠标点击该列的内容时，可以进入相应的记录中。列示宽度：可以录入百分比，表示该列在视图中占有多少宽度。统计类型：关联内容类别：设置完成之后，单击“保存”即可完成视图的设置或修改。3． 在以上的所有内容都设置完成之后，单击“保存”即可将设置存入后台。由于完整的设置过程耗时比较长，所以，建议中间过程频繁的使用该“保存”功能将内容存储下来。第三步：设置系统的角色初始的情况下，系统分为“超级管理权限”和“查看全部内容”两个选择项，如果两个都不选择，则表示为“一般用户”。大多数用户应该为一般用户。通过该模块，可以设置很多小组，根据需要，可以在人员设置的时候，让各小组中包含相应的人员。关键是可以在“设置目录权限”时，让小组具有对任何一个表单具有指定的权限。操作方式：单击“新建”——〉“录入角色名称”——〉“选择系统权限”——〉“保存”即可。第四步：设置系统用户系统所有的登录用户都在这里设置，可以认为这里就是管理员注册用户的地方。为了让用户的设置更加方便查看，系统提供“通过目录进行设置”的功能，即可以将用户所属

的部门作为目录设置，而将人员设置到指定的目录之下，就一目了然了。1．设置目录如果是设置顶级目