# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V5.0.022 | 新增了在锁定态，点击查看弹性域明细字段的功能，满足了用户希望独立查看选中弹性域字段的需求 | 2023-06-07 |
# 1 功能介绍
弹性域字段，需要与主基础资料字段配合，录入主资料各种辅助的维度值：
* 必须与主基础资料字段关联（主基础资料，可能是物料、仓库、科目等）；
* 弹性域的维度是不固定的，与主基础资料字段所选的数据有关，每条数据的维度都可以不同；
* 用户录入弹性域字段时，系统弹出一个浮层，只显示、录入主基础资料需要的维度；
* 弹性域维度录入完毕，系统自动向弹性域数据表格，插入一条数据，把主键填写到单据的弹性域字段中；
* 从字段值来看，与基础资料字段一致，DynamicObject类型，引用弹性域数据表格的数据；
典型的弹性域是核算项目：
* 核算项目作为科目的明细信息，维度包括员工、供应商、客户、部门等等；
* 每个科目会启用不同的核算项目维度，如应收款科目，会启用客户维度；而应付款科目，会启用供应商维度；
* 录入核算项目时，只会列出科目需要的维度录入，其他无关的维度，自动隐藏；
# 2 控件对象
`kd.bos.form.field.FlexEdit`
# 3 视觉展示
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 弹性域类型 | 下拉 | - | 配置弹性域的类型，有辅助属性和核算维度两种 |
| 基础资料字段 | 下拉 | - | 配置弹性域关联的基础资料字段 |
| 锁定为空提示信息 | 文本 | - | 当字段内容为空且字段锁定时显示的信息，锁定为空信息会覆盖为空提示信息 |
### 4.3.1 锁定查看明细
弹性域字段锁定时，由于维度字段多，页面难以展示全部内容。为满足用户对弹性域各维度字段独立查看与复制的需求，添加了在锁定态查看明细的按钮，点击单头或单据体弹性域字段后的图标即可展开弹性域维度面板，查看字段明细。
# 5 弹性域字段接口介绍
## 5.1 控件编程模型
### 5.1.1 控件编程模型定义
弹性域字段的控件编程模型FlexEdit，派生自文本字段控件编程模型TextEdit：
```java
package kd.bos.form.field;
public class FlexEdit extends TextEdit implements ICloseCallBack
```
### 5.1.2 控件方法清单
在文本字段的基础上，增加了如下控制方法：
| 方法 | 说明 |
| --- | --- |
| getFlexTypeId | 获取弹性域类型Id |
| setFlexTypeId | 设置弹性域类型Id |
| getFlexType | 弹性域详细信息对象，包含了弹性域类型Id、名称，录入模式、维度数据表格、录入表单的编码等 |
## 5.2 数据模型
弹性域字段派生自基础资料字段，在属性对象、数据结构上，继承了基础资料字段的特点，并进行了相应的扩展，建议先阅读基础资料字段数据模型章节；
弹性域字段的属性对象为FlexProp，派生自基础资料字段属性对象BasedataProp：
```java
package kd.bos.entity.property;
public class FlexProp extends BasedataProp {
```
到数据模型中读取弹性域字段值，与读取普通基础资料字段值一样；
但是给弹性域字段赋值，则与普通基础资料有很大差异：
* 基础资料字段，引用的必须是已经维护好的资料数据，把资料主键赋给基础资料字段即可；
* 弹性域字段，则可以先填写各下级维度的值，然后到数据库检索与维度值组合匹配的弹性域资料数据，如果存在这样的数据，取主键赋给弹性域字段；如果不存在这样的数据，则需即时插入一条数据，把生成的数据主键，填写在弹性域字段上；
## 5.3 插件事件
弹性域字段，继承了文本字段的事件，未增加新插件事件：
| 事件 | 触发时机 |
| --- | --- |
| beforePropertyChanged | 修改字段值之前触发 |
| propertyChanged | 修改字段值之后触发 |
| beforeClick | 用户点击字段的按钮时，触发此事件 |
| click | 用户点击字段的按钮时，触发此事件 |
