金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册金蝶软件（中国）有限公司2012年10月目录目录..11.系统概述.11.1产品功能概述.11.2产品特性介绍.12.应用流程及概念.22.1应用流程.22.2基本概念.52.2.1解决方案.52.2.2业务组别.52.2.3业务单元.52.2.4主菜单.62.2.5子系统树.62.2.6发布.62.2.7部署.73.业务视图.73.1业务单元管理视图.93.2业务单元对应页面编辑视图.114.解决方案管理.114.1导入解决方案.114.2设置解决方案.144.2.1基本属性.154.2.2测试设置.164.3打开解决方案.194.4删除解决方案.214.5更新解决方案.224.6定义解决方案.244.6.1主菜单管理.244.6.2权限项管理.304.6.3日志项管理.375.业务组别管理.405.1新增业务组别.405.2删除业务组别.426.业务单元管理.446.1开发步骤.446.2新建业务单元.476.2.1新增基础资料.476.2.2新增业务单据.496.3删除业务单元.496.4编辑业务单元.506.4.1业务单元信息管理.506.4.2页面设计.586.4.3其他设计.716.5复制业务单元.726.6元数据的发布.747.Web组件管理..777.1新建Web组件.777.2编辑Web组件.797.3删除Web组件.827.4自定义Web组件的使用..837.4.1发布组件代码.837.4.2导出组件.867.4.3导入组件.888.模板管理.898.1新建业务模板.908.2编辑业务模板.928.2.1数据对象的引入.928.2.2功能的创建.968.3删除业务模板.989.测试调试功能.9810.工具系统功能.10110.1更新数据库.10110.2发布元数据.10310.3校验业务单元.10410.4生成子系统树.10510.5导入导出业务单元.10710.6更新BOS工具.10811.部署功能.11012.其他设置.11613.典型开发技巧.11713.11.实体数据对象拖放..11713.1.1单独选择一个实体对象.11713.1.2拖放实体和子项属性.11813.1.3只选择实体上的子项属性.11813.1.4单独选择一个实体的分录属性.11813.1.5选择实体的分录和子项属性.11913.1.6只选择实体分录的子项属性.11913.22.查询数据对象拖放..12013.2.1单独选择一个查询对象.12013.2.2选择查询对象和子项属性.12013.2.3只选择查询对象的子项属性.12113.33.功能拖放..12113.3.1拖放单个功能.12213.3.2拖放多个功能.12213.44.控件类型的快速转换..12214.工具FAQ..12314.1如何设置web页面和菜单权限？..12314.1.1设置web页面权限..12314.1.2设置菜单权限.12914.2选择如何设置编码规则？.13314.3如何设置工作流？.135金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册1/1371.系统概述BOSWAFⅡ是BOS平台新一代Web应用开发平台，与GUI应用框架共用EASBOS服务端组件，协同BOS框架和业务建模工具(WebBIM)实现模型驱动架构(MDA)。WAFⅡ提供统一的业务开发模型，简化纯Web应用开发逻辑，形成一致的互联网风格的应用模式，最大限度实现各种组件的重用机制，同时采用开放的技术框架，形成了强大而灵活的Web应用系统开发及管理平台。WAFⅡ平台包括运行框架、组件库及WebBIM工具三部分。WebBIM工具是在原BOSBIM工具上发展起来的、专门应用于Web业务应用开发的建模工具，它拥有BIM的开发主要功能，同时用Web页面设计与发布取代了原有的GUI界面设计与发布，根据开发人员的使用习惯对于设计开发过程进行了优化，以达到简单方便、快速开发的目的。WebBIM的很多功能操作是与BIM完全一样的，只是有些具体的实现根据WAF运行框架进行了修改，因此部分完全相同的功能操作，本手册不再具体描述，如有疑问请查看BOSBIM用户手册。1.1产品功能概述WebBIM和GUIBIM一样，提供包括基础资料定义、业务单据定义、业务功能定义、主菜单管理、生成子系统树、权限管理和解决方案设置等功能。此外WebBIM另行提供了业务组件定义等功能，对业务模板定义、业务单元复制等功能重新进行了实现。1.2产品特性介绍WebBIM同样具有可视化的操作界面，可快速的绘制表单，创建菜单及工具栏，定义页面操作事件及检验等逻辑，减少80％的代码编写工作量。WebBIM同样能够实现版本控制及方案管理，支持分布式团队协同研发模式。WebBIM是依托于BOS平台的，因此可在EAS运行期平台，进行单据转换等系统配置定义，丰富了解决方案的应用范畴。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册2/137WebBIM可提供多维度的权限管理功能，支持多组织架构的管理模式，能够应用于大型、集团化企业解决方案的设计开发。2.应用流程及概念下面我们就用一个集成了编码规则、单据转换、工作流、权限控制等多服务的单据定义流程来向大家详细阐述WebBIM工具的使用方法。2.1应用流程WebBIM的应用流程与GUIBIM一致。针对使用业务建模工具的设计开发的一个完整的过程如下：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册3/137金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册4/137对于Web应用开发而言，相比于GUI开发，有自己的一些特色，如业务组件/业务模板两层共享封装的自定义支持。因此应用WAFⅡ开发一个业务模块，应该遵循下述的流程。开始业务组件/模板规划组件/模板开发应用设计业务单元开发工作流/BOTP定义权限定义编码规则/打印模板设置集成测试结束金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册5/1372.2基本概念各种基本概念也是完全一样的。2.2.1解决方案解决方案是基于BOS架构的整体系统，包含了元数据、代码、本地测试环境等完整的BOS方案。例如标准的EAS系统就是一个基于BOS的解决方案。2.2.2业务组别业务组别是业务单元的展示结构，表现为package包元数据的形式存在，所有业务单元和元数据都要存放在具体的业务组别下，最终子系统树的生成主要依据业务组别和对应的元数据信息生成。2.2.3业务单元 业务单元概念业务单元分为业务单据和基础资料两类具体表现，业务单据和基础资料统称为业务单元，系统中存放为后缀bizunit类型的元数据文件。基础资料是相对静态的、稳定的业务数据，基础资料分单级、多级、分组、分组多行表四种。业务单据是单据信息的载体，记录动态的、经常变化的业务数据，业务单据分单分录体和多分录体单据。 单据表头和分录体业务单元由单据头和分录体组成。在表单的上半部分内容，在每张表单填写过程中只需填写一次，习惯性称这部分内容为单据表头。分录体记录单据的明细信息，以单据中的一个明细表来展现，在表单的下半部分。在每张表单填写过程中以列表的方式展现和填写的，我们称之为单据表体，即分录体。一张业务单据原则上只能有一个单据头，没有分录体、一个或多个分录体。多分录体通金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册6/137常放置在不同的页签容器上展现。 主业务组织主业务组织表示单据的业务类型，明确了主业务组织，才能明确单据的组织范围，明确单据的授权类型，形成完整的业务流，明确上下文环境。 字段和控件字段对应一个数据表的列，控件对应一个界面的元素。业务单元提供绑定了字段的部分数据字段，可以直接建立，此处字段的实际上表示为字段控件；业务单元同时提供各类界面控件，可以根据需要不做字段绑定，并可绑定实际的事件和业务逻辑。字段和控件在业务单元编辑界面的选用板表现为数据字段和界面控件，可以根据需要使用。2.2.4主菜单系统框架提供主菜单方式集成二次开发的业务单元，可以通过主菜单快速配置定义新的业务单元打开的相关入口，并可通过菜单管理功能调整主菜单的位置和顺序等基本的属性。2.2.5子系统树业务子系统树是系统中不同类型元数据文件的一个结构化载体，主要用于展示业务单元、功能等相关元数据的位置结构，按照业务单元的类型或元数据的类型展示相关内容，业务系统运行时通过选择其中对象实现相关的配置操作。例如，BOTP单据规则配置是通过BOTP相关的业务子系统树展示相关的业务单据并选择业务单据进行规则配置。子系统树的生成主要是根据业务组别以及相关的元数据类型产生，目前系统产生多种类型的子系统树支持不同的业务配置场景应用。2.2.6发布业务单元通过建模工具设计完成后，需要通过发布动作产生具体的实现类代码用于开发实现模型，同时业务单元会根据定义自动生成数据表元数据发布数据库生成对应的数据库表。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册7/137业务单元发布主要经过业务单元关联元数据校验、元数据文件发布、生成元数据文件对应的代码、代码编译、生成业务单元的数据库表等步骤，最终完成业务单元的发布。同样后续的业务单元更新需要重新发布以支持更新内容的展示。业务单元在发布的主要过程：发布之前计算、装载业务单元相关元数据；发布相关元数据，包括校验、发布生成代码；生成部署文件，生成相关的属性文件；编译发布生成的代码文件；根据目标数据库类型和对象生成数据库升级脚本；执行数据库脚本生成、更新表结构；提供日志记录发布过程，发生错误时日志记录在错误日志视图。2.2.7部署完成系统开发后，需要通过部署功能将相关二次开发内容发布到服务端。部署过程主要根据发布的元数据目录进行元数据的校验、Java类代码编译、更新数据库、打包上传服务器、服务器部署等步骤。3.业务视图业务视图主要基于业务单元为设计单位，集成部分常用系统功能，提供可视化编辑视图，快速设计开发业务单元并实现测试和部署等主要功能的视图。下面简单介绍业务建模工具视图的组成：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册8/137菜单和工具栏区域：系统主要功能调用入口，根据当前对象的不同，菜单项和工具栏项相关功能可能表现不同的可用或不可用状态。业务管理视图：业务单元等对象展现的视图，主要展现业务对象和元数据文件并用于各个功能操作。大纲视图：大纲视图反映了当前编辑的业务单元对应页面的内部对象，可以快速选择和定位并操作。业务单元编辑视图：业务单元编辑视图主要用于业务单元的设计和编辑，包括业务单元基本信息维护和字段维护属性视图：属性视图主要显示当前对象的属性，并可用于编辑和配置相关属性操作。控制台视图：控制台视图一般用于展示操作的过程信息，可用于输出信息的查看。其他视图：当需要查看其他视图时，可以通过菜单窗口-显示视图功能显示其他需要查看的视图。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册9/1373.1业务单元管理视图【WebBIM的特征】：对于WebBIM来说，有以下规则：1、在BOS/web平台下，固定存放着基础的业务模板及业务组件，供参考。如下图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册10/1372、当创建业务组别进行业务有用开发时，相关元数据的目录如下图所示：在“其他”目录下存放维护相关的元数据类型。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册11/1373.2业务单元对应页面编辑视图业务单元对应页面编辑分为界面编辑区域和选用板。界面编辑区域支持可视化操作和布局，通过鼠标完成相关的设计操作。选用板主要包含可使用的各种界面控件和WEB组件，通过点击或拖拽方式进行配置操作。4.解决方案管理解决方案管理提供基于解决方案级别的打开、导入、设置、删除、更新等功能，实现对解决方案的各项设置和管理。【WebBIM与GUIBIM在本部分没有操作上的区别】4.1导入解决方案业务建模工具，可以管理企业的整个解决方案的业务单元和业务流程，也可以管理EAS的解决方案。因此，可以导入EAS的解决方案进行企业的业务建模，在业务建模工具主界面的左边视图中，点击鼠标右键，如下图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册12/137然后选择〖导入解决方案〗功能，会弹出导入解决方案的向导，如图：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册13/137金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册14/137可以选“从远程服务器导入”和“本地服务器导入”两种方式。“从远程服务器导入”表示：EAS实际运行服务器和业务建模工具不在同一台机器，导入解决方案需要从远程导入；“本地服务器导入”表示：EAS实际运行服务器与业务建模工具在同一台机器上。选择“本地服务器导入”，需要设置服务器安装目录，然后点“下一步”，弹出选择帐套信息页面。选择从远程服务器导入，需要输入远程服务器信息。注意：如果是需要在开发环境中运行门户应用，需要选择从本地服务器导入。注意：使用被动模式连接：选中可以避免本地防火墙对下载限制，不选中可以避免服务器防火墙对下载限制。请根据防火墙的配置情况进行选择，默认使用被动模式连接。点击完成开始导入解决方案。4.2设置解决方案注意：通常建议按照默认的设置即可，用户无需修改。对导入解决方案的相关设置，在日常业务处理中可以进行相关的维护，在业务建模工具金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册15/137主管理界面，在菜单【工具】【解决方案设置】下，如图所示： 选择“设置解决方案”功能，弹出解决方案的相关设置界面，如图所示：4.2.1基本属性修改解决方案的别名和描述。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册16/1374.2.2测试设置4.2.2.1测试账套可以设置测试的账套信息，如图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册17/137如果已有帐套列表中没有测试的帐套，则点击“更新帐套”：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册18/137其中：从本地服务器目录更新：一般会有一个默认的EAS服务器目录，也可以通过“浏览”按钮来定位新的EAS服务器目录。从远程更新服务器更新：更新服务器地址：表示数据库所在服务器名称，可以为机器名，也可以是数据库服务器的IP地址；更新服务登陆名：具有管理这个数据库权限的用户名；更新服务密码：管理这个数据库的用户名的口令密码。使用被动模式连接：选中可以避免本地防火墙对下载限制，不选中可以避免服务器防火墙对下载限制。请根据防火墙的配置情况进行选择，默认使用被动模式连接。设置完成以后，点击“更新”按钮则可更新帐套列表。选中帐套后，点击“测试帐套连接”按钮，如果连接成功，会弹出如下提示：4.2.2.2其它测试设置可以设置界面登录的账套信息，如图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册19/137此设置一般在使用“业务单元界面测试”功能时使用。“界面测试登陆用户名”和“界面测试登陆密码”分别相当于登录EAS界面时账套的用户名和密码。调试模式运行：勾选后，从BOS工具启动服务器后，可以进行代码的调试，在二次开发中用的比较多。是否Java工程：缺省是java工程，可以在Java视图打开并编辑代码，构建项目。元数据和资源文件支持热替换：本地测试热部署模式支持，可以实现元数据文件的热替换。4.3打开解决方案对于已有的解决方案，可以直接打开。在业务单元管理中点鼠标右键，选择“打开已有解决方案”，如图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册20/137系统会提供界面选择方案所在路径，如图：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册21/137选择方案文件所在目录后，点“完成”即可。4.4删除解决方案对于不需要的解决方案，可以删除，选择方案根目录，然后点鼠标右键，选择“删除解决方案”，如图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册22/137系统会给出提示：如果希望继续保留解决方案，可选择“保留文件及目录”，则解决方案仅从工作区中移除，还可以重新打开。4.5更新解决方案部署服务端或者服务端更新了解决方案时，可以通过更新解决方案功能获取服务器最新金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册23/137的解决方案的lib下class包和metas下元数据包。更新解决方案过程，lib路径下class包直接更新到本地解决方案的lib路径下；metas包会更新到本地解决方案的newMetas目录，如果需要最新的metas包，需要进行元数据合并后放入本地解决方案的basemetas目录下。选择菜单【方案】【更新解决方案】进入更新解决方案向导界面打开向导，选择更新方式，提供本地更新和远程服务器更新两种方式本地更新通过本地文件目录直接更新解决方案文件。远程更新通过BIM服务进行更新，需要确保远程服务器BIM服务启动并且没有其他工具同时更新的情况下进行连接更新操作。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册24/1374.6定义解决方案4.6.1主菜单管理主菜单管理提供系统主菜单的维护和定义功能，此处仅可以对用户自定义的菜单项进行维护和定义。主菜单与解决方案设置的数据库帐套实时同步的，菜单编辑内容直接进入到帐套，不需要再次发布或者部署。主菜单管理通过菜单【方案】【主菜单管理】选择进入：主菜单管理的界面如下所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册25/137主菜单管理界面由三部分组成：上部为工具栏，包括新建菜单组、新建菜单项、删除、最上、上移、下移和最下，用户可以选择相应的功能进行操作。左边是一棵浏览树，显示解决方案主菜单的结构，用户可以选择某个菜单组或菜单项查看其详细信息。分为GUI主菜单和Web主菜单，这里选择Web主菜单右边是属性字段部分，显示并可以修改维护某个菜单组或者菜单项的具体属性值。对于使用者而言，最常用的是新建菜单组或菜单项，删除菜单组或菜单项和调整菜单顺序的操作。新建菜单组的操作步骤如下：1.选中浏览树上的某个菜单组或菜单项；2.选择工具栏上的-新建菜单组-，则新建立的菜单组出现在浏览部分的最下方，并且为选中状态，系统已经自动命名了菜单组的名称为'新建菜单组'：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册26/137用户可以修改名称并补充描述、图标等信息。新建菜单项的操作步骤如下：1.选中浏览树上的某个菜单组；2.选择工具栏上的-新建菜单项-，则新建立的菜单项出现在浏览部分的最下方，并且为选中状态，系统已经自动命名了菜单组的名称为'新建菜单项'：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册27/137名称和状态字段旁有-*-标记，为必录项，不能为空。业务单元字段确定了点击EAS系统主菜单所打开的界面，状态有两种：序时簿和录入。分别对应于EAS系统界面打开时的列表浏览状态和单条记录维护状态。注意：导入的菜单项没有对应业务单元，但用户可以为其分配一个新的业务单元，点击-浏览-出现如下界面：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册28/137选中业务单元后，点击-确定-即可。权限字段定义了该菜单项拥有的权限。点击-浏览-，出现如下界面：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册29/137如有权限项可以直接选择，如没有权限项可以自定义，具体的定义操作请查阅-第14章权限定义与权限控制集成-。删除菜单组或菜单项的操作步骤如下：1.选中待删除的浏览树上的某个菜单组或菜单项；2.点击工具栏上的-删除-按钮；3.系统提示是否确认删除：1.选择-是-则所选菜单组或菜单项被删除，选择-否-返回。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册30/137注意：注意在删除菜单组时，下面的菜单项也会一起删除，所以在删除操作的时候要特别小心。调整菜单组或菜单项的操作步骤如下：1.选中需要移动的菜单组或菜单项。2.选择工具栏上的最上、上移、下移和最下等按钮。3.也可用拖放的方式完成调整。4.6.2权限项管理权限定义提供基于业务单元操作功能的权限项定义，定义发布后，可以在权限管理、权限分配、操作权限等功能进行权限的管理和控制。权限定义的界面从【方案】【权限管理】进入，界面如下：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册31/137界面由三部分组成：上部为工具栏，包括新建组别、新建权限项、根据功能创建权限项、删除、上移、下移及选择权限文件…，用户可以选择相应的功能进行操作。左边是一棵浏览树，显示权限解决方案的结构，用户可以选择某个组别或权限项查看其详细信息。右边是属性字段部分，显示并可以修改维护某个组别或者权限项的具体属性值。金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册32/137对于使用者而言，最常用的是新建组别、新建权限项或根据功能创建权限项，删除组别或权限项等操作。权限组的字段包括：名称、别名。名称必须录入且不得重复。权限的字段包括：名称、别名、描述、业务单元和功能。名称必须录入且不得重复，功能录入必须在选择了相应的业务单元后才可以使用。定义权限项的操作步骤：1.新建组别、新建权限项，并将组别和权限项的属性分别定义为'样板工程'、'测试'：1.点击-增加功能-，出现如下界面：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册33/1371.点击-浏览-，选择业务单元：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册34/1371.在该单元的功能列表中选择功能项（示例中先是全选，然后去掉了'打印'和'打印预览'两个功能）：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册35/1371.点击-确定-后，则选中的功能会出现在右下方业务单元的功能列表中：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册36/1371.在这个界面中还可以通过-删除功能-按钮来删除已选中的功能。2.所有操作完成后点击-确定-即完成了新建权限项的定义。-根据功能创建权限项-和-新建权限项-在功能上是一样的，只是保存的路径不同：-选择权限文件…-可以选择已有的权限方案，点击后出现如下界面：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册37/137选中后点-确定-即可导入权限方案。权限控制定义好权限项之后，通过元数据相关的发布部署到服务端后，然后通过用户管理-同步权限项功能即可同步生效权限项，并可以对权限项关联的业务单元功能进行权限控制。4.6.3日志项管理日志定义提供日志项定义，可定义业务单元相关功能操作的日志属性，定义发布部署后，运行时相关日志定义操作会主动记录在系统上机日志中，可根据日志对核心功能操作记录进行监控。日志定义的界面从【方案】【日志管理】进入，界面如下：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册38/137日志定义的操作同权限定义相似，请参考配置金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册39/137日志控制，运行中可以通过【系统管理】–【安全管理】-【上机日志】进行日志监控金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册40/1375.业务组别管理5.1新增业务组别在解决方案中增加组别来管理我们的系统的各种业务，在业务单元管理视图中，选择某个目录，然后点鼠标右键，选择-新建--业务组别-，如图所示：金蝶EASV7.5BOSWeb应用开发平台WAFⅡ用户手册41/137选择后，会弹出新建组别的向导.
