U9 关键性弹性域单据开发范例说明 版 本 号 ：V1.0 作者：彭超 版本记录 【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】 版本 修改与参与人 修改时间 修改原因 修改概述 审批人1.0 彭超 2008-7-1 原始文档建立 一．问题域说明 弹性域是一个由多段组成的，用于解决软件产品客户化的一种软件结构。关键性弹性域是用于为某些档案动态定义复合主键的弹性域。本范例主要讲解如何在 U9 支持关键性弹性域的档案中实现关键性弹性域特性。 二．基本原理 关键弹性域只能针对一部分特定的档案进行定义，这些档案都预留了 20 个段用于保存关键弹性域信息。支持关键性弹性域结构的档案后台需要有如下字段： 其中： Segment1——Segment20：为段值字段，存储用户录入的具体的段值。 KeyFlexFieldStru：为关键性弹性域结构，存储使用的哪个结构,它关联的关键性弹性域结构上定义了上面 20 个段表示的意义以及如何使用。 CombineName：存储上面 20 个段对应的名称。它是由名称 1-名称 2….. 名称 n 的形式构成，其中分隔符由用户在关键性弹性域结构中定义。 关键性弹性域有一个组合码，它是由段值 1-段值 2…..-段值 n 的形式构成，其中分隔符由用户定义，关键弹性域结构+组合码在数据表中必须唯一。组合码一般存储在档案的 Code字段中。 三．关键代码及说明 1、后台开发： (1)、在后台 BE 模型上选择关键性弹性域版型： (2)、生成代码后会在“实体名称.cs”文件中生成如下方法（以地区（Territory）为例）： #region KeyFlexFieldEntity Stereotype /// /// Inserting Method /// public void KeyFlexFieldEntity_Inserting() /// /// Updating Method /// public void KeyFlexFieldEntity_Updating() /// /// Validate Method /// public void KeyFlexFieldEntity_Validating() #endregion (3)、在“实体名称 Extend.cs”中分别调用上一步生成的代码（红色表示）： protected override void OnInserting() { // To do ... base.OnInserting(); KeyFlexFieldEntity_Inserting(); } protected override void OnUpdating() { // To do ... base.OnUpdating(); KeyFlexFieldEntity_Updating(); } protected override void OnValidate() { // To do ... base.OnValidate(); this.SelfEntityValidator(); KeyFlexFieldEntity_Validating(); } 2、前台开发： (1)、说明：Base 中提供公共画面维护各档案中的关键性弹性域字段。 对应画面编号：CBO_UI_S194_01 弹性域段值录入（需求文档位置：U9.VOB.AH\CBO\SPEC\Function\Process\CBO_UI_S194_弹性域段录入及参照_1.0.doc） (2)、调用方法： 拖一个弹性域控件，在它的 form 引用里选择 KeyFlexFieldCtrlUIForm.ubfform（在UFIDA.U9.Base.FlexField.FlexFieldCtrlUI 里），绑定入口参数 StructID（必需）为你的编码结构 ID 和返回参数 Name 到你需要显示组合名称的控件上（可选），以地区为例： 四．源代码使用说明 1. 后台根据需要将实体到 KeyFlexFieldStru 的关联线设置级联删除。 2. 前台应给 KeyFlexFieldStru 字段赋值。如果一个档案只支持一个弹性域结构，则这个字段的值可在软件开发过程中确定。如果支持多弹性域，则由用户通过界面选择指定使用哪个弹性域。 3. 为了提高 UIModel 的效率，前台 UIModel 中不要拖 Segment1——Segment20 字段 4. 本 范 例 是 用 了 地 区 节 点 作 为 样 例 ， 其 前 台 模 型 位 置 为 ： U9UICode\U9.VOB.PD.CBO\Base\Model\TerritoryUI\TerritoryUI.ubfuiproj 五．组装发布说明（可选）
