U8UAP开发手册.docx

UAP开发样例指导用友研发中心U8平台技术部<本文档适用于U871版本>目录一、 摘要 3二、 样例开发前提 3三、 建立UAP项目 3四、 建立表单模型 5(一) 新建实体 6(二) 新建实体属性 8五、 建立表单布局 14六、 行为对象开发 15(一) 表单开发 17(二) 列表开发 30(三) 生单二次开发 36(四) 联查报表 37(五)联查UAP列表 38(六)UAP列表联查U8单据 39(七)用户自定义控件开发 42(八)U8单据引用UAP档案 43七、 行为对象注册 56功能介绍: 56使用说明: 56应用技巧: 58八、 建立数据引擎 59功能介绍: 59使用说明: 60应用技巧: 82九、 设置过滤条件 82功能介绍: 82使用说明: 82应用技巧: 87十、设置栏目 88功能介绍 88使用说明 88应用技巧 89十一、权限 89功能权限 89记录级权限 90字段级权限 91十二、部署 92附录:功能介绍 931、行为对象升级说明 932、 LoginInfo对象介绍 95摘要本文以U8-ERP中的销售订单为应用原型,介绍了如何通过 UAP进行软件开发,文中给出了开发方法和丰富样例。内容包括:IUAP表单开发原理IUAP项目的建立和导入、导出IUAP表单的模型设计和布局设计IUAP表单的行为对象开发IUAP表单列表设计与开发IUAP表单列表的行为对象开发I如何对UAP表单的缺省按钮进行扩展性开发I如何对UAP表单的缺省按钮进行取代性开发I如何为UAP表单增加新的按钮及行为I如何用程序代码调用UAP报表I如何用程序代码调用UAP表单列表如何在UAP表单中增加权限控制:功能权限、字段权限、记录权限I如何为UAP表单开发自定义控件如何开发树形档案I如何维护UAP数据引擎I如何维护栏目I如何维护过滤条件I如何调用U8APIU8单据自定义项如何引用UAP档案本文档中使用的示例文件为“销售订单二次开发”,可以通过UAP将该文件导入到帐套中。项目名称为"SaleVoucher”,导入后在项目中包括几个自定义单据: “销售订单”为二次开发的Demo示例;“零售日报”为自定义空间二次开发的Demo示例;“列表档案示例”“树形编辑档案示例”、“树形导航档案示例”分别为各个对应的档案类型的示例。样例开发前提首先,需要安装U8产品,并建立一个帐套。其次,您需要向用友公司购买 UAP表单设计许可;不过您可以使用 UAP的演示版本,但是演示版本不能新建UAP项目,也不能注册行为对象。三、建立UAP项目使用UAP登录您的帐套后,在系统界面上的新建项目选项卡,选中“供应链”后,在右边的列表中选择“销售管理”,在界面下方的几个文本框中输入项目名称, 编号,描述等;顺序选择框使用“默认”即可。点击“确定”如果输入信息与先前创建的项目信息不冲突,项目就可被成功创建。您也可以导入我们为您提供的 UAP样例项目,导入方法如下。1、 登录UAP;2、 打开菜单“文件一导入和导出”;3、选中“导入项目数据到目前的服务器” ,点“确定”按钮;4、点“导入”按钮,选取U8安装目录下的“uap'sdk”目录中的文件“Samplefile”;5、导入成功后;6、在UAP已存在的项目中产生了一个名称为" SaleVoucher”的项目;四、建立表单模型选中“自定义表单”节点,单击右键,使用“新建自定义表单”功能创建一个新的表单。然后在弹出的选择界面中选择“表单类型”下的“单据” ,在名称文本框中输入一个表单名字,不要与以前创建的表单名字重复。在成功创建后,系统界面会如下图(图表 1)所示:图表1在上图所示的实体节点,默认有两个子节点,分别为“主表和第一子表” ,根据当前表单的需要设计实体,包括增加实体和实体属性等。(一)新建实体需要为实体填写“实体名称”,和选择“实体类型”。除此以外,还可以通过实体的属性编辑窗口为实体设置各项信息。实体的相关属性:名称:实体显示的名称,仅用于设计时。发布状态:实体是否已发布,只读。功能:为实体定义自定义功能,在运行时显示为表格对应的工具栏按钮。状态设置:设置实体属性、功能在表单运行时的状态,决定实体属性、 功能在不同的环境下是否可用。物理表模式:设置实体物理表的创建模式,默认为由 UAP在发布时自动创建。在特殊的应用场景中可以使用“使用已存在的对象”或“无” 。后两种情况下UAP不负责实体物理表的维护。物理表:设置该实体在数据库存储时使用的物理表, 一般情况下一个实体对应一个物理表。数据引擎模式:设置实体运行时数据的访问方式。默认为 UAP系统在发布时自动创建,特殊的应用场景中可以使用“使用已存在的对象”或“无” ,这两种情况下系统不负责实体数据的读取,只能通过用户定义的接口获取数据集。数据引擎:当数据引擎模式为“使用已存在的对象