U8UAP开发手册.doc

UAP开发样例指导 用友研发中心 U8平台技术部 本文档适用于U871版本 目 录 一、 摘要 3 二、 样例开发前提 3 三、 建立UAP项目 4 四、 建立表单模型 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 附录：功能介绍 93 1、行为对象升级说明 93 2、LoginInfo 对象介绍 95  摘要 本文以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项目建立表单模型 图表 1 在上图所示的实体节点，默认有两个子节点，分别为“主表和第一子表”，根据当前表单的需要设计实体，包括增加实体和实体属性等。 新建实体 需要为实体填写“实体名称”，和选择“实体类型”。除此以外，还可以通过实体的属性编辑窗口为实体设置各项信息。 实体的相关属性： 名称：实体显示的名称，仅用于设计时。 发布状态：实体是否已发布，只读。 功能：为实体定义自定义功能，在运行时显示为表格对应的工具栏按钮。 状态设置：设置实体属性、功能在表单运行时的状态，决定实体属性、功能在不同的环境下是否可用。 物理表模式：设置实体物理表的创建模式，默认为由UAP在发布时自动创建。在特殊的应用场景中可以使用“使用已存在的对象”或“无”。后两种情况下UAP不负责实体物理表的维护。 物理表：设置该实体在数据库存储时使用的物理表，一般情况下一个实体对应一个物理表。 数据引擎模式：设置实体运行时数据的访问方式。默认为UAP系统在发布时自动创建，特殊的应用场景中可以使用“使用已存在的对象”或“无”，这两种情况下系统不负责实体数据的读取，只能通过用户定义的接口获取数据集。 数据引擎：当数据引擎模式为“使用已存在的对象”时，设置要使用的数据引擎对象。 主键：设置实体物理表的主键字段名。 主键类型：设置实体物理表主键字段的类型，可选“整数”或“GUID”或“字符串”。 行模式：多行或单行。一般主表设置为单行。 新建实体属性 实体必须包含实体属性时才有效。可以在UAP界面“表单”窗口中，右键点击实体对应的节点，选择“新建实体属性”菜单向实体添加实体属性： 实体属性通用属性： 类型：该实体属性的类型。 描述：对该实体属性的单体描述。 属性名称：实体属性的名称。 默认值：实体属性的默认值。 使用默认值：用户未提供数据时，是否使用实体属性的默认值。 发布：该实体属性是否已经发布。 常用条件：该实体属性是否可以在过滤中作为常用条件使用。 区间条件：该实体属性是否可以在过滤中作为区间条件使用。 值更新事件：设置该实体属性值更新时需要处理