UAP开发文档U8官方正版.doc

UAP开发样例指导 用友研发中心 U8平台技术部 本文档适用于U871版本 目 录 一、 摘要 3 二、 样例开发前提 3 三、 建立UAP项目 3 四、 建立表单模型 5 (一) 新建实体 6 (二) 新建实体属性 8 五、 建立表单布局 12 六、 行为对象开发 13 (一) 表单开发 15 (二) 列表开发 29 (三) 联查报表 31 (四) 联查UAP列表 32 (五) UAP列表联查U8单据 32 (六) 用户自定义控件开发 35 (七) U8单据引用UAP档案 36 七、 行为对象注册 49 功能介绍： 49 使用说明： 49 应用技巧： 51 八、 建立数据引擎 51 功能介绍： 51 使用说明： 53 应用技巧： 74 九、 设置过滤条件 74 功能介绍： 74 使用说明： 75 应用技巧： 79 十、 设置栏目 80 功能介绍 80 使用说明 80 应用技巧 81 十一、 权限 81 功能权限 81 记录级权限 82 字段级权限 83 十二、 部署 84 附录：功能介绍 85 1、行为对象升级说明 85 2、LoginInfo 对象介绍 87  摘要 本文以U8-ERP中的销售订单为应用原型，介绍了如何通过UAP进行软件开发，文中给出了开发方法和丰富样例。内容包括： UAP表单开发原理 UAP项目的建立和导入、导出 UAP表单的模型设计和布局设计 UAP表单的行为对象开发 UAP表单列表设计与开发 UAP表单列表的行为对象开发 如何对UAP表单的缺省按钮进行扩展性开发 如何对UAP表单的缺省按钮进行取代性开发 如何为UAP表单增加新的按钮及行为 如何用程序代码调用UAP报表 如何用程序代码调用UAP表单列表 如何在UAP表单中增加权限控制：功能权限、字段权限、记录权限 如何为UAP表单开发自定义控件 如何开发树形档案 如何维护UAP数据引擎 如何维护栏目 如何维护过滤条件 如何调用U8API U8单据自定义项如何引用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系统在发布时自动创建，特殊的应用场景中可以使用“使用已存在的对象”或“无”，这两