EAS自定义引入引出模板使用指南
[EAS基础系统部] [潘柱军]
导读
本文档对EAS引入引出管理中的自定义模板使用进行详细说明并对常见问题进行解答。
适用对象
需要引入引出功能的二次开发人员,实施人员,客户
引入引出功能测试人员、开发人员
目录1.简介2
1.1.目的2
1.2.适用对象3
1.3.参考资料3
2.背景3
3.功能描述3
4.自定义模板使用说明4
4.1.制作模板4
4.2.引出模板7
4.3.使用模板8
5.发布自定义模板8
5.1.导出自定义模板脚本9
5.2.分发部署自定义模板10
5.3.使用导入的自定义模板10
6.自动引入数据10
6.1.制定自动引入计划10
6.2.自动执行引入任务11
6.3.立即执行引入任务12
7.常见问题解答12
简介
目的(引入引出管理--(引入引出模板管理,
选择维护自定义模板,出现界面如下图:
其中新增模板针对系统中还没有提供引入功能的业务对象;
修改模板针对业务对象已经存在引入功能,如业务对象经过二次开发增加了字段,需要对增加的字段实现数据引入引出功能。选择维护模板将要求选择一个现有系统模板。
选择下一步,设置基本信息。出现界面如下图:
输入基本信息,从实体对象树中选择需要对其进入引入引出的实体对象。对于二次开发增加的实体,在发布元数据后还需要在管理控制台中执行同步子系统树操作后才能够在这里选择到。
“引出查询对象”是跟“引入实体对象”对应的查询对象,用于获取引出数据。如果二次开发增加字段后需要实现数据引入引出功能,那么要先修改对应的查询对象,增加相关的查询字段。
选择下一步,字段设置。
点击‘增加字段’按钮在实体属性树上选择需要的引入引出字段。
选择字段后,可以对选择的字段进行设置:
‘绑定引出字段’,如果在第二步中选择了‘引出查询对象’,那么可以在下拉列表中选择“引出查询对象”中定义的查询结果字段进行绑定。
‘是否关键字’,当使用‘覆盖引入’方式引入数据时,会根据这里设置的关键字段在数据库中查询是否已经存在关键字相同的数据,如果存在则用引入数据文件中的数据将数据库中的原有数据覆盖。如果不存在则往数据库新增数据。
‘是否必录项’,引入数据时根据这个设置进行检查。
‘备注’,对于系统中的布尔类型,枚举类型将在形成模板时自动生成注释信息,说明其描述与内值的对应关系。
选择完成,完成制作模板
在模板列表中找到刚才维护的模板,设置引入方式。
‘新增引入’,引入数据时不检查系统中是否存在跟引入数据重复的数据,如果系统不允许增加重复的数据,则会引起数据引入失败。
‘覆盖引入’,引入数据时会根据模板配置的‘关键字’在数据库中查询是否已经存在关键字相同的数据。、如果存在则用引入数据文件中的数据将数据库中的原有数据覆盖,如果引入数据有空值,会把数据库中原来的非空值置空。如果不存在则往数据库新增数据。
‘更新引入’,如果存在则用引入数据文件中的数据将数据库中的原有数据更新,如果引入数据有空值,则不会更新数据库中的非空值。如果不存在则往数据库新增数据。
引出模板
在引入引出模板管理的列表界面选择维护的自定义模板,选择工具栏功能“引出模板”,将模板保存在本地,形成模板文件如下图:
在模板文件中录入数据。
使用模板
选择菜单系统平台-(引入引出管理--(引入引出工具,出现界面如下图:
选择维护的自定义模板,选择引入的文件,并运行。
引入完毕浏览界面查看数据是否正常引入。
发布自定义模板
用户使用自定义模板时,有时会先在测试服务器上创建好自定义模板,测试通过后再在正式服务器上创建同样的自定义模板。这样做不但造成重复劳动,而且可能在正式服务器上再次创建自定义模板时因为人为错误生成创建的自定义模板有问题。在“模板编码”界面的工具栏中有一个“引入模板”功能按钮,但是这个“引入模板”功能只是在二次开发创建指定数据转换实现类时方便录入模板字段信息使用的。
为了实现自定义模板的发布,可以利用“引入引出模板管理”中的“数据导出工具”导出自定义模板脚本,然后在目录服务器上执行该脚本就达到发布自定义模板的目的。
下面具体描述操作步骤。
导出自定义模板脚本
在“引入引出模板”界面中按“F11”显示“数据导出工具”界面。
选择“数据类型”为“数据引入引出脚本引出”;
录入“导出数据编码”,就是要导出的自定义模板的编码;
“sql文件的分隔符”指定为“;”。假如自定义模板脚本内容包含“;”时,如果使用EAS的管理控制台的执行脚本功能执行导出的脚本时会报语句不正常结束错误。对于这种情况,需要改用别的分隔符,如“@”,然后重新导出脚本。
点击“导出数据”按钮,