如果这些问题困扰着你，那这篇文章就是你的解题密钥了。今天，小编带你了解苍穹平台V5.0新特性功能：单据体引入。

该功能适用版本为金蝶云·苍穹V5.0.002及以上。

本期文章，小编将详细讲述单据体引入的4个步骤，分别包括：配置单据体引入模板、录入数据、引入数据和插件干预。

模板可以通过两个入口进行配置，路径一为：【配置工具】→【引入引出模板】→【单据体引入模板】，如下图所示：

模板进入路径一

路径二为：“单据体引入”按钮→【单据体引入起始页】→【模板下载】→【下载单据体引入模板】，如下图所示：

模板进入路径二

两个入口均可进入单据体引入模板的表单编辑界面，其中从单据体引入起始页进入，业务对象固定为当前所在表单，如下图所示：

单据体引入后业务对象示例

模板编辑界面中，可以在多选下拉框中选择单据体，未勾选的单据体不参与生成模板。配置好需要引入的字段、基础资料的引入属性（可选编码/名称），填入模板的编码及名称保存即可。

下载的模板中，单据体数据根据Excel页签隔离，页签名称为单据体名称，按照列中字段标识录入数据。如下图所示：

引入数据的流程有以下三步：

首先，选择“单据体引入”操作并进行配置，如下图所示：

单据体引用操作示例

其次，引入单据。数据录入完成后，上传文件，后台进行文件校验，校验通过后（校验不通过时，文件无法上传成功），点击“引入数据”开启引入流程，引入完成后，可查看每个单据体的引入结果统计，如下图所示：

最后，查看引入效果。如果数据全部引入成功，下方显示“关闭”按钮，如下图所示：

引入结果

如存在错误数据，下方显示“导出Excel错误数据”按钮，错误信息统一录在单据体页签的第一列，如某页签的单据体不存在错误信息，则该页签不会输出至错误文件。

按照错误提示修改对应数据后，错误文件可再次作为数据文件进行引入。

修正后的数据文件再次导入示例

目前有两种方式对单据体引入进行插件干预：

方式一：模板下载。

在模板编辑界面中，通过“插件”编辑框，录入插件的相关信息（插件类全路径、说明）。插件可以在下载模板时，将模板中“基础资料”类型的列，修改其单元格格式为下拉格式，并给下拉项赋值。

例：将标识为“basedatafield1”的字段，下拉值列表设置为"0002", "0003", "0004","0005","0006","0007"。

public class TestImportEntryBaseDataPlugin implements ImportEntryTemplateListener{ 
    //将标识为“basedatafield1”的字段 
    //下拉值列表设置为"0002", "0003", "0004","0005","0006","0007" 
    @Override 
    public void beforeSetBaseData(BeforeDownloadImportEntryTemplateEvent evt) { 
        evt.getBaseDataDropDownValues().put("basedatafield1", Arrays.asList("客户","0002","0003","0004","0005","0006","0007")); 
    } 
}

设置效果如下