EAI数据转换工具

EAI数据转换工具
Eai-tools主要用于对导入数据进行格式化转换。

将execl、txt进行格式定义，转换为VO 的模板设计工具。

数据转换流程如下：
Eai-tools就是设计映射文件，源数据定义文件的可视化工具。

在实际应用中，将转换模块集成的应用系统中，使用设计的映射文件，源数据定义文件以及其他配置文件进行数据的导入。

设计源数据格式文件
建立一个目录(如果需要)，然后在此目录下新建一个excel定义文件
1.增加字段，然后在属性编辑器中修改属性
建立映射文件
在和*.excel同一目录，且名称相等
1.建立映射文件
2.在左侧(右键点击)加载预定义单据同名的excel：
3.在右侧(右键点击)加载对应的VO:
4.建立对应关系。

使用连线拖拽的方式将左侧的源数据格式和右侧的VO字段进行连接。

并且可以在连接线中添加其他的处理（工具箱中的函数）：
属性说明
Page属性：
1.名称：
2.显示名称：
3.数据字典
4.页签标识：当时excel文件时，标识是哪个页签，为空时是execl的第一个页签
5.分隔符：源文件是txt类型时的字段分隔符，默认是“，”
Entry属性：
1.名称：
2.显示名称：
3.数据字典
4.数据类型：?????
5.可重复：
6.起始行：导入时开始的行数，之前的数据忽略。

7.终止行：导入时的终止列，之后的数据忽略
8.起始列：导入时的开始列。

9.终止列：导入时的终止列
10.是否匹配字段：
11.字段标题行
字段属性：
1.名称：
2.显示名称：
3.数据类型：此列数据的类型，包括Integer,int,double,UFDouble,UFDate,UFDatetime,
UFBoolean,BigDecimal
4.允许为空：此列数据是否允许为空，在转换时会进行校验
5.最大长度：此列数据的最大长度，在转换时会进行校验，超出最大长度时会报错,注意
数据类型不为空时才有效
6.小数位数：当此列数据是小数时，此属性标识小数点的位数
7.可重复：
8.跟随上行：此列属性和上一列相同
校验在DataValidator.java中进行
函数说明
函数都包含在包gbu.bs.eai.function中,详细代码可在其中查询。

Sql定义和对照表定义反正在sql.xml和contrast.xml中
一、通用函数：Common.java
a)常量：在转换成VO时使用常量进行填充对应的字段
b)循环：
c)分组：
d)当前组：
e)上下文参数：从上下文参数缓存中取出参数
f)设置上下文参数：将数据放入到上下文参数缓存中
g)语义对照表：通过设置的语义对照表，将导入的数据转换成设定的值(contrast.xml
中设置)，如果没有对应值，则填入默认值
h)设置语义对照表(校验)：通过设置的语义对照表，将导入的数据转换成设定的值
(contrast.xml中设置)，如果没有对应值，则报错
i)行号：
j)生成标识：
k)Iif：
l)优先取值：
二、UAP函数：UapFunc.java
a)生成OID：生成20位的PK值
b)SQL取值：通过sql在数据库中取值(只有一列)，使用数据绑定方式，参数在IDE
定义是给出，如果取值为空，则付空值
c)SQL取值(校验)：通过sql在数据库中取值(只有一列)，使用数据绑定方式，参数
在IDE定义是给出，如果取值为空，则报错
d)SQL对照：通过sql在数据库中取值(只有两列，第一列是Key，第二列是Value)
并缓存在Hashtable中。

导入的数据列作为key在hashtable中取值，如果取值为空，则使用默认值
e)SQL对照(校验)：通过sql在数据库中取值(只有两列，第一列是Key，第二列是
Value)并缓存在Hashtable中。

导入的数据列作为key在hashtable中取值，如果取
值为空，则使用报错
三、日期函数
a)当前时间：取得当前系统时间，格式为hh:mm:ss
b)当前日期：取得当前系统日期，格式为yyyy-mm-dd
c)身份证取日期：在身份证号码中取得出生日期，格式为yyyy-mm-dd
d)日期格式转换：将日期格式进行转换
四、年金函数
a)生成员工编码：
b)公司主键参照：
c)企业主键参照：
d)导入日期参照：
五、字符串函数：详情请查看界面
六、逻辑函数：详情请查看界面
七、数学函数：详情请查看界面
与业务系统整合
在eai-tool\eai-root\eprk文件夹中出现三个文件：corporation.excel、corporation.xsl、corporation.map，将生成的文件拷贝到业务系统的. \config\eai-root\eprk目录下
title是节点的名称，<corp>和<plan>标记是控制界面上是否显示这两个参照。

此配置决定导入界面等参数信息
此配置指定导入的处理方式参数和处理类。

<bo>是此导入文件的后台处理类，<path1>是映射文件的路径，<billtype>是对应该的单据配配置文件（比如企业基本信息单据定义文件名称）。

最终导入节点
校验通过并保存。