
# afterLoadData事件
## 1. 事件介绍
单据界面加载完毕,会根据传入的单据主键值,到数据库加载单据数据包。
插件可在此处根据单据的数据决定业务逻辑的执行。
## 2. 事件触发时机
事件在单据数据包加载完毕后触发。
afterLoadData事件与[afterCreateNewData](https://vip.kingdee.com/article/222735398575848448)的差别:
- 这两个事件的触发时机一样,都是在界面数据包准备完毕之后触发,但数据包来源不同:
1. afterCreateNewData事件的数据包,是全新创建的数据包,适合在此事件调整默认值。
2. afterLoadData事件的数据包则来自于数据库,不建议在此事件修改字段值。
- 这两个事件(互斥),在单据界面加载、刷新过程中,只会触发其中一个:
1. 当单据界面以新增模式打开,不需要到数据库加载单据,触发afterCreateNewData事件;
2. 当单据界面以修改、查看模式打开,需到数据库加载单据,触发afterLoadData事件。
## 3. 参数说明
EventObject e: 通用的事件参数对象,含有事件源
- Object getSource(): 事件源,单据表单视图模型IBillView实例。
## 4. 应用示例
### 4.1 案例说明
在已使用的表单新增字来展示其他数据,此时历史数据为空,兼容历史数据。
### 4.2 实现方案
1. 在修改或查看状态加载数据时,触发afterLoadData事件。
2. 通过DB查询获取并构建所需要展示的数据信息。
3. 获取mod