EBU客户化开发UAP业务提升手册(V890版)_v1[1].1.docVIP免费

ERP 事业部咨询实施客户化开发部用友软件股份有限公司地址：北京市海淀区北清路 68 号用友软件园 电话：010-62436688 网址：www.ufida.com.cn客户化开发 UAP 业务提升手册 起草单位 ：ERP 咨－客户化开发部修正单位 ：第 1 页 共 268 页 ERP 事业部咨询实施客户化开发部批 准 ： 批准日期 ： 第 2 页 共 268 页 ERP 事业部咨询实施客户化开发部目 录1摘要......................................................................................................................................... .72样例开发前提......................................................................................................................... .83建立 UAP 项目.........................................................................................................................84表单、档案开发................................................................................................................... .114.1建立表单模型........................................................................................................... .114.1.1新建实体....................................................................................................... .124.1.2新建实体属性.................................................................................................144.2建立表单布局........................................................................................................... .234.3行为对象开发........................................................................................................... .234.3.1表单开发....................................................................................................... .264.3.2列表开发....................................................................................................... .634.3.3生单二次开发.................................................................................................724.3.4联查报表....................................................................................................... .784.3.5联查 UAP 列表...............................................................................................824.3.6UAP 列表联查 U8 单据................................................................................ .824.3.7用户自定义控件开发.....................................................................................884.3.8U8 单据引用 UAP 档案................................................................................ .91第 3 页 共 268 页 ERP 事业部咨询实施客户化开发部4.3.9行为对象注册...............................................................................................1115报表开发............................................................................................................................. .1155.1摘要......................................................................................................................... .1155.2基本操作................................................................................................................. .1165.2.1新增报表..................................................................................................... .1165.2.2新增数据源...................................................................................................1315.2.3报表查询..................................................................................................... .1385.2.4分组............................................................................................................. .1385.3报表设计开发实例...................................................................................................1415.3.1存储过程模式开发实例（整体条件串）...................................................1415.3.2复杂报表开发实例.......................................................................................1485.3.3图形化报表开发实例...................................................................................1745.3.4UAP 报表脚本抽取......................................................................................1936建立数据引擎..................................................................................................................... .1956.1功能介绍................................................................................................................. .1956.2使用说明................................................................................................................. .1976.2.1登陆 UAP 环境.............................................................................................1976.2.2配制实体..................................................................................................... .1986.2.3业务对象..................................................................................................... .207第 4 页 共 268 页 ERP 事业部咨询实施客户化开发部6.3应用技巧................................................................................................................. .2197设置过滤条件..................................................................................................................... .2197.1功能介绍................................................................................................................. .2197.2使用说明................................................................................................................. .2207.3应用技巧................................................................................................................. .2268设置栏目............................................................................................................................. .2268.1功能介绍................................................................................................................. .2268.2使用说明................................................................................................................. .2268.3应用技巧................................................................................................................. .2299UAP 参照............................................................................................................................ .2299.1功能介绍................................................................................................................. .2299.2使用说明................................................................................................................. .22910权限............................................................................................................................. .23910.1功能权限............................................................................................................. .23910.2记录级权限......................................................................................................... .24010.3字段级权限......................................................................................................... .24111部署............................................................................................................................. .24311.1UAP 表单导出与导入..............................................................................................24311.2UAP 项目导出与导入..............................................................................................245第 5 页 共 268 页 ERP 事业部咨询实施客户化开发部11.3行为对象部署..................................................................................................... .24611.4报表部署............................................................................................................. .24612附录：功能介绍......................................................................................................... .24712.1行为对象升级说明...............................................................................................24712.1.1ReceiptPluginBase 新增接口（与 872 版本的 IReceipt 接口相比）.........24712.1.2ReceiptPluginBase 新增接口（与 871 版本的 IReceipt 接口相比）.........25012.2LoginInfo 对象介绍.................................................................................................254第 6 页 共 268 页 ERP 事业部咨询实施客户化开发部1 摘要本文以 U8-ERP 中的销售订单为应用原型，介绍了如何通过 UAP 平台进行软件开发，文中给出了开发方法和丰富的样例。内容包括：UAP 表单开发原理UAP 项目的建立和导入、导出UAP 表单的模型设计和布局设计UAP 表单的行为对象开发UAP 表单列表设计与开发UAP 表单列表的行为对象开发如何对 UAP 表单的缺省按钮进行扩展性开发如何对 UAP 表单的缺省按钮进行取代性开发如何为 UAP 表单增加新的按钮及行为如何用程序代码调用 UAP 报表如何用程序代码调用 UAP 表单列表如何在 UAP 表单中增加权限控制：功能权限、字段权限、记录权限如何为 UAP 表单开发自定义控件如何开发树形档案第 7 页 共 268 页 ERP 事业部咨询实施客户化开发部如何维护 UAP 数据引擎如何维护栏目如何维护过滤条件如何调用 U8APIU8 单据自定义项如何引用 UAP 档案本文档中使用的示例文件为“销售订单二次开发”，可以通过 UAP 将该文件导入到帐套中。项目名称为“ SaleVoucher ”，导入后在项目中包括几个自定义单据：“销售订单”为二次开发的 Demo 示例；“零售日报”为自定义空间二次开发的 Demo 示例；“列表档案示例”、“树形编辑档案示例”、“树形导航档案示例”分别为各个对应的档案类型的示例。项目源代码：2 样例开发前提首先，需要安装 U8(890)产品，并建立一个帐套。其次，您需要向用友公司购买 UAP 表单设计许可；不过您可以使用 UAP 的演示版本，但是演示版本不能新建 UAP 项目，也不能注册行为对象。第 8 页 共 268 页 ERP 事业部咨询实施客户化开发部3 建立 UAP 项目使用 UAP 登录帐套后，在系统界面上的新建项目选项卡，选中“供应链”后，在右边的列表中选择“销售管理”，在界面下方的几个文本框中输入项目名称，编号，描述等；顺序选择框使用“默认”即可。点击“确定”如果输入信息与先前创建的项目信息不冲突，项目就可被成功创建。您也可以导入我们为您提供的 UAP 样例项目，导入方法如下。1、登录 UAP；2、打开菜单“文件－导入和导出”；3、选中“导入项目数据到目前的服务器”，点“确定”按钮；第 9 页 共 268 页 ERP 事业部咨询实施客户化开发部4、点“导入”按钮，选取培训目录下的 “Samplefile”；5、导入成功后；第 10 页 共 268 页 ERP 事业部咨询实施客户化开发部6、在 UAP 已存在的项目中产生了一个名称为“SaleVoucher”的项目；4 表单、档案开发4.1 建立表单模型选中“自定义表单”节点，单击右键，使用“新建自定义表单”功能创建一个新的表单。然后在弹出的选择界面中选择“表单类型”下的“单据”，在名称文本框中输入一个表单名字，不要与以前创建的表单名字重复。在成功创建后，系统界面如下图所示：第 11 页 共 268 页 ERP 事业部咨询实施客户化开发部图表 1在上图所示的实体节点，默认有两个子节点，分别为：主表、第一子表，根据当前表单的需要设计实体，包括增加实体和实体属性等。第 12 页 共 268 页 ERP 事业部咨询实施客户化开发部4.1.1 新建实体需要为实体填写“实体名称”，和选择“实体类型”。除此以外，还可以通过实体的属性编辑窗口为实体设置各项信息。第 13 页 共 268 页 ERP 事业部咨询实施客户化开发部实体的相关属性：名称：实体显示的名称，仅用于设计时。发布状态：实体是否已发布，只读。功能：为实体定义自定义功能，在运行时显示为表格对应的工具栏按钮。状态设置：设置实体属性、功能在表单运行时的状态，决定实体属性、功能在不同的环境下是否可用。物理表模式：设置实体物理表的创建模式，默认为由 UAP 在发布时自动创建。在特殊的应用场景中可以使用“使用已存在的对象”或“无”。后两种情况下 UAP 不负责实体物理表的维护。第 14 页 共 268 页 ERP 事业部咨询实施客户化开发部物理表：设置该实体在数据库存储时使用的物理表，一般情况下一个实体对应一个物理表。数据引擎模式：设置实体运行时数据的访问方式。默认为 UAP 系统在发布时自动创建，特殊的应用场景中可以使用“使用已存在的对象”或“无”，这两种情况下系统不负责实体数据的读取，只能通过用户定义的接口获取数据集。数据引擎：当数据引擎模式为“使用已存在的对象”时，设置要使用的数据引擎对象。主键：设置实体物理表的主键字段名。主键类型：设置实体物理表主键字段的类型，可选“整数”或“GUID”或“字符串”。行模式：多行或单行。一般主表设置为单行。4.1.2 新建实体属性 实体必须包含实体属性时才有效。可以在 UAP 界面“表单”窗口中，右键点击实体对应的节点，选择“新建实体属性”菜单向实体添加实体属性：实体属性通用属性：第 15 页 共 268 页 ERP 事业部咨询实施客户化开发部类型：该实体属性的类型。描述：对该实体属性的单体描述。属性名称：实体属性的名称。默认值：实体属性的默认值。使用默认值：用户未提供数据时，是否使用实体属性的默认值。发布：该实体属性是否已经发布。常用条件：该实体属性是否可以在过滤中作为常用条件使用。区间条件：该实体属性是否可以在过滤中作为区间条件使用。值更新事件：设置该实体属性值更新时需要处理的脚本列表。基础资料类型字段共有三种类型的值更新事件：“携带当前字段相关参照属性到指定列”、“计算定义公式的值到指定列”、“表达式为真/假时改变指定栏目编辑状态”；其余类型字段比基础资料类型字段缺少第一种类型的值更新事件。1.携带当前字段相关参照属性到指定列第 16 页 共 268 页 ERP 事业部咨询实施客户化开发部2.计算定义公式的值到指定列3.表达式为真/假时改变指定栏目编辑状态第 17 页 共 268 页 ERP 事业部咨询实施客户化开发部表达式为真\假时修改指定栏目的编辑状态第 18 页 共 268 页 ERP 事业部咨询实施客户化开发部表达式为真\假时修改指定栏目的显示状态第 19 页 共 268 页 ERP 事业部咨询实施客户化开发部表达式为真\假时修改指定功能状态表单功能第 20 页 共 268 页 ERP 事业部咨询实施客户化开发部实体功能第 21 页 共 268 页 ERP 事业部咨询实施客户化开发部唯一约束：是否检查该实体属性的值在整个表单范围内唯一。文本对齐：实体属性文本的显示位置。显示...