
# 1 产品概述
## 1.1 产品介绍
导入导出框架,旨在提供一套统一的解决方案,预封装一批开箱即用的操作和插件接口,可以很方便的实现数据迁移、批量更新、数据抽取、数据备份、基础资料批量分配等功能,并统一对任务进行管理,生成执行日志。
业务领域使用这套统一的框架,可以无需关心后台线程的启动和管理,直接沿用平台已经封装好的功能界面。只需要专注于实现功能逻辑,提升开发效率,保障用户体验。
## 1.2 业务场景
本文将演示如何实现“按导出模板导出”的业务场景,然后介绍导入导出框架对外提供的操作和接口。
# 2 操作步骤
打开列表,找到【更多】>【导出数据(按导出模板)】菜单,点击下载(6.0及以下版本是引入数据(按引出模板))。

**如果存在多个模板,请选择你配置的引出模板下载。下载的excel格式同下图类似。**

**如果导出过程超过10分钟卡住不动,建议检查monitor日志查看是否报错中断。**
# 3 插件干预
## 方案:实现自定义列表插件
第一步:派生kd.bos.list.plugin.AbstractListPlugin类(或IListPlugin接口),实现插件干预执行类,重写下面四个方法:
```java
/** 查询导出数据前事件,可以用来修改过滤条件、排序规则等 */
public void beforeQueryOfExport(BeforeExportFileEvent e) {}
/**查询导出数据后事件,可以用来修改查询返回的数据,比如修改字段数据等 */
public void afterQueryOfExport(ExportFileEvent e) {}
/** 导出文件前事件,目前只可以用来修改导出的文件名 */
public void beforeExportFile(BeforeExportFileEvent e) {}
/** 导出文件后事件,可以用来修改导出的文件内容,比如修改excel数据、格式、加密等 */
public void afterExportFile(ExportFileEvent e) {}
```
第二步:将上面这个实现类注册到列表插件中。

# 4 示例
```java
package kd.bos.designer;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import org.apache.poi.ss.usermodel.CellStyle;
import org.apache.poi.ss.usermodel.FillPatternType;
import org.apache.poi.ss.usermodel.IndexedColors;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import kd.bos.dataentity.entity.DynamicObject;
import kd.bos.form.events.AfterQueryOfExportEvent;
import kd.bos.form.events.BeforeExportFileEvent;
import kd.bos.form.events.BeforeQueryOfExportEvent;
import kd.bos.form.events.ExportFileEvent;
import kd.bos.list.plugin.AbstractListPlugin;
import kd.bos.orm.query.QFilter;
/**
* @author rd_agbyte_yang
*
* 示例代码实现功能: 1.修改按列表导出的文件名为【实体名称】+列表.xlsx 2.修改前三行的第一列为红色字体
*
*/
public class TestExportListPlugin extends AbstractListPlugin {
@Override
public void beforeQueryOfExport(BeforeQueryOfExportEvent e) {
if (e.getFilt