用户定义属性组与用户定义属性开发使用指南.doc

用户定义属性组与用户定义属性开发使用指南 版本 维护人 维护时间 相关文档 备注 V60 陈伟 2009-07-07 V6公共服务 V60 陈伟 2009-11-12 界面显示自定义项的方法变更 V60 陈伟 2010-4-6 为解决同一界面多个模板需要多次远程调用来实现用户定义属性显示问题、及一个界面需要显示多个实体的用户定义属性问题，提出container与preparator分离的设计方案，container负责远程查询所有用户定义属性引用，界面可以配置多个preparator来显示用户定义属性 V60 陈伟 2010-4-7 自定义档案为参照时，需要按组织过滤  术语 用户定义属性 即以前版本的自定义项。它的具体含义是指业务对象中预留若干字段，这些字段的数据类型是在系统运行期由用户定义的。在V6版本中，对字段可定义的数据类型进行了扩充：它可以是基本类型，如字符串、整数、数值（小数）、布尔、日期等；也可以引用系统预置档案、枚举或用户自定义档案。 用户定义属性组 用户定义属性的集合升级用户定义属性组，即以前版本的自定义项对象。一个用户定义属性组有自己的编码、名称及包含用户定义属性的数量。抽象出用户定义属性组的目的，是为了允许多个业务对象引用同一组用户定义属性，以保证多个业务对象中的用户定义属性一一对应。如在采购流程中，希望采购单、入库单的自定义项一一对应，可以定义一个公共的“采购流程用户定义属性组”。 用户定义属性组引用 将一个业务对象关联到一个用户定义属性组，以表明这个业务对象的自定义字段的数据类型是由用户定义属性组中包含的用户定义属性所定义的，这时称业务对象与用户定义属性组间的关联关系为用户定义属性组引用。 设计概要 简单类图 图1 用户定义属性类图 使用说明及API 元数据建模时设置自定义属性 元数据建模时，如果该实体需要预留用户定义的属性，需要将该字段的数据类型设置为“自定义项”，如图2所示 图2 元数据建模时指定字段数据类型为自定义项 创建用户定义属性组 在“开发平台/开发配置工具”结点下有一个“用户定义属性组”结点，可在此结点创建和维护用户定义属性组，如图3所示。 图3 用户定义属性组结点 打开结点后，左侧树显示的是现有的用户定义属性组。可以通过左侧树上方的按钮创建和维护用户定义属性组所在的模块，如图4所示。 图4 创建维护用户定义属性组所在模块 通过结点上方可创建和维护用户定义属性，如图5所示。 图5 创建维护用户定义属性组 完成上述功能后，开发人员需要将生成的模块信息和用户定义属性组数据导入到基准库中，模块信息和用户定义属性组的数据记录在bd_userdefrule表中。 创建用户定义属性组引用 创建好用户定义属性组后，需要指定对该属性组的引用。在用户定义属性组结点中，选中一个用户定义属性组后，可在界面右下方的表体中为该属性组指定引用，如图6所示。 图6 为用户定义属性组设置引用 引用用户定义属性组的实体，是通过参照选择的，参照的范围是所有元数据实体。但需要注意的是，最终选择的引用实体必须有数据类型为“自定义项”的属性，并且“自定义项”属性的数量必须与前述用户定义属性组设定的用户定义属性数量相等。如图6所示，用户定义属性组“客商销售信息”设定的用户定义属性数量是30，则在为该属性组设置引用实体时，所中的实体“custsaleinfo”中必须有30个数据类型为“自定义项”的属性，否则系统不允许保存。 开发人员可以在设置用户定义属性组引用时，为该引用设置变更校验类的类名，该字段不是必输的，如图7所示。该校验类应该实现nc.itf.bd.userdefrule.IUserdefitemChangeListener接口，当用户定义属性组中包含的用户定义属性发生变化时，会调用所有引用实体注册的校验类的校验方法（userdefitemChanged(UserdefitemVO, UserdefitemVO)）。如果开发人员在指定引用实体时未指定变更校验类名，则在相应用户定义属性发生变化时按默认的校验规则进行校验。默认的校验规则如下：当某个用户定义属性变更时，如引用实体中的对应字段在数据库中的值不全部为空，则会抛出异常、不允许保存用户定义属性变更。 图7 在引用实体时指定变更校验类的类名 完成上述功能后，开发人员需要将生成的用户定义属性组引用数据导入到基准库中，用户定义属性组引用的数据记录在bd_userdefruleref表中。 用户定义属性设置 用户定义属性可以在全局设置，也可以在集团设置，分别对应“用户定义属性-全局”和“用户定义属性-集团”两个结点，如图8所示。 图8 用户定义属性结点 同一个用户定义属性，在全局设置后，在各集团均可见，并且各集团均不能修改；在任一集团设置后，在全局结点也