BOS - WAFII（beta版）工具使用说明

WAFⅡ工具使用说明

概述

WAFⅡ平台(Web Application Framework Ⅱ)是EAS BOS Web产品开发的核心平台,平台提供统一的业务开发模型，采用开放的技术框架，简化纯Web应用开发过程，最大限度实现各种组件的重用机制，为Web应用系统开发提供完整解决方案。WAFⅡ平台由运行框架、WAFⅡ核心组件库、WAFⅡ业务建模工具组成。

WAFⅡ业务建模工具作为WAFⅡ平台的主要组成部分，对Web应用系统的业务需求、系统设计、程序开发、程序调试运行提供了完整的支撑。工具应用开发过程如下：

业务建模工具应用过程设计阶段需计求人分析员、设根据需求分析对实体、服务、流程、功能进行业务建模开发测试阶段元数据定义部署阶段运行时阶段设计、易用性验证单元测试开发人员界面逻辑开发调试业务逻辑开发调试测试用例编写源程序产品管理人员实施人员发版测试打包、发布、版本更新系统运行客户化修改

基本开发流程

应用WAFⅡ工具进行开发的基本开发流程如下图：

拖放字段以及 组件 在java类中发布出来 的空方法中添加代码

开始 根据模板类型新建业务单元 设置业务单元实体属性 页面调整 调整布局 设置控件属性 创建功能 创建事件 发布元数据 代码调整 在js文件中发布出来的空方法中添加代码 在css文件中维护调整当前页面样式 调试页面程序并提交测试 结束 基本概念

BOS应用视图：业务建模工具应用过程中使用人员的主要交互界面，它由业务管理视图、大纲视图、设计视图、属性视图四个部分组成。如图：

业务管理视图 设计视图

大纲视图 属性视图

业务管理视图：属性视图通过树的方式对所有元数据进行分类展现，同时提供对元数据的新增、删除、发布等功能操作，如图：

设计视图：设计视图有图形化展示区域和托盘组成，托盘中所列组件可以拖放到图形化展示区，图形化展示区中对界面布局外观进行所见即所得设置。如图：

拖放

大纲视图：大纲视图中树形方式分类展示了界面中包含的元素、功能和数据对象，数据对象可以拖放到设计视图的图形化展示区形成表格或界面元素，界面元素可以在视图中移动快速调整。如图：

调整 拖放

属性视图：属性视图中用户可以对当前选中对象进行属性定义和编辑，同时视图提供并对当前属性的必要说明，如图：

编辑

属性说明

开发约定

开发工具发布的代码产物包括：java文件、js文件、css文件，发布文件中存在WAFⅡ平台所需关键字或注解，开发过程中此类关键字或注解不能删除或者修改，否则会导致代码发

布不正确，具体关键字如下：

//@WafPageEnd //@WafComponentEnd //@WafOptions //@WafImports //@WafControllerEnd //@AutoWiredStartEnd //@WafEvent //@WafAction @Controller @RequestMapping @IBOSBizCtrl @Action @Event

典型应用场景

标准基础资料开发 1.业务单元的创建

1) 在业务管理视图中新建业务单元（第一次会比较慢，因为需要加载元数据）

2) 在弹出的创建业务单元新建向导第1页设置基本信息（名称，别名，描述）

3) .在业务向导第2页，选择根据模板创建，然后选择基础资料模板，点击完成

4) .业务单元创建完成后，业务管理视图中可以看见新创建的业务单元，展开后是该业务

单元下的实体，查询，表，编辑页面和列表页面。同时编辑器会默认打开新建业务单元的编辑页面

2.页面的调整

如果不进行客户化修改，可以跳过该步骤，直接发布元数据。通常页面调整主要是对页面的字段的调整。现以增加页面的显示字段说明。

1) 在业务单元管理视图中双击该业务单元节点，将打开业务单元编辑器。在字段管理页签

上点击新增字段，填写字段信息后，点击确定按钮。并保存业务单元。

2) 切换到编辑页面。会弹出下面提示，点击确定。

5) .服务器启动完毕后，右键选中业务单元，启动web测试（默认浏览器如果是ie，会自

动打开ie,目前不支持ie浏览器），拷贝url到谷歌或者火狐浏览器中访问。

标准单据开发 1.业务单元的创建

1) 在业务管理视图中新建业务单元（第一次会比较慢，因为需要加载元数据）

2) 在弹出的创建业务单元新建向导第1页设置基本信息（名称，别名，描述）

3) .在业务向导第2页，选择根据模板创建，然后选择单据模板，点击完成

4) .业务单元创建完成后，业务管理视图中可以看见新创建的业务单元，展开后是该业务单

元下的实体(包括分录)，查询，表(包括分录)，编辑页面和列表页面。同时编辑器会默认打开新建业务单元的编辑页面

2.页面的调整

与标准基础资料类似，区别在业务单据的编辑页面多了分录表格，下面说明如何增加分录表格列。

1) 打开业务单元编辑器，选中分录对象，点击新增字段按钮

1.5选择实体的分录和子项属性

工具会在设计视图中自动分录表格（包含选择的分录属性列），如图：

注意：如果拖放的区域为已存在的分录表格，则工具将不生成分录表格，自动在已有分录表格上添加选择的属性列。

1.6只选择实体分录的子项属性

同1.5所述类似，此种场景要求拖放区域必须是已有分录表格，工具在已有分录表格上添加选择的属性列。

2.查询数据对象拖放

大纲视图中选择查询或者查询包含的属性拖放到设计视图中，工具会自动根据数据类型生成对应控件，并把需要设置的控件属性自动设置，提高开发效率。场景如下：

2.1单独选择一个查询对象

工具会在设计视图中自动表格（包含查询对象的全部属性列），如图：

2.2选择查询对象和子项属性

工具会在设计视图中自动查询表格（包含选择的查询对象属性列），如图：

注意：如果拖放的区域为已存在的查询表格，则工具将不生成查询表格，自动在已有查询表格上添加选择的属性列。

2.3只选择查询对象的子项属性

同2.2所述类似，此种场景要求拖放区域必须是已有查询表格，工具在已有查询表格上添加选择的属性列。

3.功能拖放

大纲视图中选择功能拖放到设计视图中，工具会自动根据数据类型生成对应按钮，并把需要设置的按钮属性自动设置，提高开发效率。场景如下：

3.1拖放单个功能

工具在拖放区域自动生成单个按钮，并自动设置相应属性，如图：

3.2拖放多个功能

工具在拖放区域自动生成多个按钮，并自动设置相应属性，如图：

4.控件类型的快速转换

设计视图中选择需要改变类型的控件，右键

选择改变控件类型

选择新的控件类型，工具会自动完成类型改变，同时保留原有控件必要的属性定义内容。

2) 录入字段信息，确定后，保存业务单元。切换到业务单据编辑页面。在大纲视图中可以

看见新增加的字段name。

3) 将字段拖放到编辑页面的分录表格中，在大纲视图中，可以看见表格新增了一列

3代码的发布和测试

略。请参考标准基础资料开发

标准模板开发 1.标准模板的创建

1） 在业务管理视图中，右键新建模板

2） .新建模板向导，录入模板基本信息后确定

5) 业务模板创建完成后，业务管理视图中可以看见新创建的业务模板，展开后是该业务单

元下的实体，查询，表，页面同时编辑器会默认打开新建模板的页面

2.数据对象的引入

1) 新建的模板页面是个空白页面。如果要设计成编辑页面，则引入实体，如果要设计成列表页面则引入查询。

在大纲视图中，右键新建数据对象

2) 弹出新建功能向导页，输入名称后选择实体还是查询

3) 点击浏览，选择需要引入的数据对象。我们可以选择这个模板中的实体或者查询，也可

以引入别的路径下的实体或者查询

4）引入后，点击确定，在大纲视图中可以看到新建的数据对象

5）拖动query节点到页面中，自动生成一个对应query的数据表格

6) 如果引入数据对象是实体

7) 拖到页面上时，先选择列布局

8） 确定后在页面生成按照列布局排列的表单控件

9）如果想对列表或表单控件进行调整可以参考标准基础资料开发

3.功能的创建

1) 在大纲视图中，右键菜单新建功能

2) 在新建功能向导中录入功能信息后点击完成。

4) 从右边控件托盘中拖动按钮到页面

5）在属性视图中，设置按钮功能绑定属性，选择刚才新建的add功能

4.代码的发布和测试

略。参考标准基础资料开发

单独页面开发 1. 新页面的创建

1) 在业务管理视图中，选择已经存在的业务单元或模板或者选择名称为页面的节点，右键

菜单新建，创建web页面.

2) 两种方式的区别在于，如果是在业务单元下面新建页面，默认会把业务单元的实体或者

查询加入页面的数据对象中(根据页面类型，编辑页面是实体，列表页面是查询)，如果是在页面节点下新建的页面，默认数据对象为空，可以在新建向导中选择数据对象。

3)点击完成，页面创建成功，开始编辑页面

2.数据对象的引入

略。参考标准模板开发

3.功能的创建

略。参考标准模板开发

4.代码的发布和测试

略。参考标准基础资料开发

页面复制

1.选择要复制的页面

2.设置目标页面

注意：如果“复制到业务单元/模板”为空，则复制后创建的页面不属于任何业务单元或者模板，完成后在“其他/页面”分类目录中可以看到新复制创建的页面。

3.调整复制创建的页面 引入自定义组件 1.代码拷贝

组件包括的tag文件拷贝到：

解决方案\\web\\webRoot\\WEB-INF\\tags\\core\\webcom目录下 组件包括的js以及css文件拷贝到：

解决方案\\web\\webRoot\\webviews\\webframework\\webcom\\自定义组件名称\\目录下

2.修改配置文件

修改BOSModular\\webbim\\eclipse\\plugins\\com.kingdee.bos.webstudio_6.1.0\\DTCConfig.xml文件，增加对应自定义组件描述，参见已经定义的套打组件即可，例如：

3.增加组件属性事件配置文件

步骤2中配置过程中会定义一个dtcConfig属性，例如: dtcConfig=\自定义组件.con\，在 BOSModular\\webbim\\eclipse\\plugins\\com.kingdee.bos.webstudio_6.1.0\\dtcConfig目录下创建XXX自定义组件.con文件，文件内容参见Report.con进行配置

4.重启工具

重启工具后在设计视图的托盘中会看到新引入的自定义组件。

典型开发技巧

1.实体数据对象拖放

大纲视图中选择实体或者实体包含的属性拖放到设计视图中，工具会自动根据数据类型生成对应控件或者布局，并把需要设置的控件属性自动设置，提高开发效率。场景如下：

1.1单独选择一个实体对象

拖放到设计视图区域，工具会提示用户设置布局：

工具会根据用户设置的布局类型，在设计视图中自动生成布局以及多个控件（对应实体的全部属性），如图：

1.2拖放实体和子项属性

拖放到设计视图区域，工具会提示用户设置布局(如果拖放区域为布局容器则不会提示)：

工具会根据用户设置的布局类型，在设计视图中自动生成布局以及多个控件（仅对应选择的实体属性），如图：

注意：如果此种场景拖放的位置是一个布局容器，那工具将不生成布局仅生成控件，如图：

1.3只选择实体上的子项属性

同1.2所述类似，工具在设计视图中自动生成多个控件（对应选择的实体属性）。

1.4单独选择一个实体的分录属性

工具会在设计视图中自动分录表格（包含分录的全部属性列），如图：

本文来源：https://www.bwwdw.com/article/obh2.html