JAVAEDI平台开发流程.docx
《JAVAEDI平台开发流程.docx》由会员分享，可在线阅读，更多相关《JAVAEDI平台开发流程.docx（50页珍藏版）》请在冰豆网上搜索。
JAVAEDI平台开发流程
1.功能说明
1.1.EDI报文处理功能
1.1.1.EDI报文接收功能
EDI文件接收管理，主要包括以下几个方面：
1）导入－FTP接收任务配置信息维护：
维护FTP接收EDI文件任务配置信息，包括FTP与FILECOPY两种方式接收，主要维护任务启动与关闭、任务状态、传送类型、发送方服务器、文件路径、文件类型、登录用户名以及登录密码等配置信息；
2）EDI文件接收：
将EDI文件拷贝到EDI监控目录供后续处理，支持FTP/EMAIL/FILECOPY三种方式接收报文，完全配置化环境，根据用户需要，可针对不同类型EDI定制不同的接收方式；
1.1.2.EDI报文导入功能
EDI导入基本流程管理，主要包括以下几个方面：
1）导入－报文解析任务配置信息维护：
维护EDI报文解析任务配置信息，主要是任务启动与关闭以及XML规则文件的配置；
2）导入－报头处理任务配置信息维护：
维护EDI报头处理任务配置信息，主要是任务启动与关闭以及XSLT报头处理文件的配置；
3）导入－数据导入任务配置信息维护：
维护EDI数据导入任务配置信息，主要是任务启动与关闭的配置；
4）EDI预处理：
将报文处理为符合解析平台的格式，针对不同格式报文提供灵活的预处理平台，通过预处理把不符合解析平台的报文格式处理为符合解析平台的报文格式，对于不同类型EDI的预处理过程封装在不同的java文件中，java文件的位置可通过配置来指定；
5）EDI报文解析：
将规则化、结构化的EDI文件解析为易于平台处理的XML文件，基于XML技术的报文解析平台，支持TEXT/EXCEL/XML三种报文格式的解析：
对于TEXT格式，通过编制各自的规则XML文件来实现各种不同EDI类型的解析，灵活化的XML规则描述，方便EDI报文格式的个性化配置；对于EXCEL格式，通过统一的解析接口，提供两种解析结构，即需要执行数据校验与不需要执行数据校验，对于需要执行数据校验的解析方式，在EXCEL格式方面要求更为规范化，数据解析准确度更高，三种报文的解析结果均为XML结构化文件；
6）EDI数据校验：
校验EDI数据，主要涉及必输性、数据类型以及数据长度，灵活的报文数据验证平台，通过编制不同的XML结构文件，可实现各种不同EDI类型的数据校验，包括必输性、数据类型以及数据长度等校验，可根据特殊需要通过编辑XML结构文件实现灵活的校验逻辑个性化调整；
7）EDI数据映射：
主要组织XML数据结构、EDI取数以及初步业务逻辑实现，基于XSLT技术的报文数据映射平台，其主要任务包括：
组织XML数据结构、EDI取数以及初步业务逻辑实现。
经解析之后且成功通过数据格式校验的XML结构文件，采用基于XSLT技术的数据映射技术，对该XML结构文件执行基于预先定义好的XSLT映射文件MAPPING为另外一种结构更加接近系统平台数据结构的XML结构文件；
8）EDI报头处理：
主要记录EDI执行信息，将经MAPPING之后的XML结构文件再进行一次XSLT处理，其主要目的是记录下该EDI执行信息，以提供后面EDI数据重复导入的识别标志；
9）EDI数据写入数据库：
首先对一些系统内部业务逻辑执行校验，以确报导入EDI数据的准确性，若校验通过，记录主要业务信息并通过邮件反馈，若为手工导入，还要将成功导入信息反馈到EDI导入操作界面；若校验失败，记录错误信息并通过邮件反馈，若为手工导入，还要将错误信息反馈到EDI导入操作界面；
把EDI数据写入业务数据库，若写入成功，记录主要业务信息并通过邮件反馈，若为手工导入，还要将成功导入信息反馈到EDI导入操作界面；若写入失败，记录错误信息并通过邮件反馈，若为手工导入，还要将错误信息反馈到EDI导入操作界面；
1.1.3.EDI报文接收导入流程图
1.1.4.EDI报文导出功能
EDI导出基本流程，主要包括以下几个方面：
1）导出－数据抽取任务配置信息维护：
维护EDI数据抽取任务配置信息，主要是任务启动与关闭设定、抽取数据XML参数配置、任务执行状态等配置信息的维护；
2）导出－报头处理任务配置信息维护：
维护EDI报头处理任务配置信息，主要是任务启动与关闭设定以及XSLT报头处理文件的配置；
3）导出－报文封装任务配置信息维护：
维护EDI报文封装任务配置信息，主要是任务启动与关闭以及XML规则文件的配置；
4）EDI发送任务指令：
根据具体业务要求，用户通过EDI导出操作界面，按照一定的业务逻辑，输入查询条件，获取系统业务数据，在确认发送之后，将形成EDI发送任务指令，并存储在EDI数据抽取任务队列中；
5）EDI数据抽取：
遍历EDI数据抽取任务队列，识别出需要执行的EDI任务，读取任务配置信息项抽取数据XML参数，按照一定的业务逻辑，抽取业务系统中的相关数据，然后按照业务数据结构要求把抽取出来的数据拼装成一个EDI报文单位的树型层次结构XML数据。
并将XML数据以文件格式保存到指定的数据拼装目录下面，同时记录处理过程到EDI运行日志文件并及时更新任务执行状态；
6）EDI报头处理：
对抽取出来的EDI数据经拼装之后的XML结构文件执行报头处理，其主要目的是记录EDI执行信息以及读取报文报头信息，比如获取发送方代码、接收方代码、报文标准等报头信息，以在报文中记录相关信息以方便接收方识别；
7）EDI数据映射：
主要是实现业务逻辑分析并拆分相应业务数据以及数据项取数，将经报头处理之后的XML结构文件，采用基于XSLT技术的数据映射技术，对该XML结构文件执行基于预先定义好的XSLT映射文件MAPPING为另外一种结构更加接近EDI标准描述的XML规则格式数据结构的XML结构文件；
8）EDI数据校验：
校验EDI数据，主要涉及必输性、数据类型以及数据长度，灵活的报文数据验证平台，通过编制不同的XML结构文件，可实现各种不同EDI类型的数据校验，包括必输性、数据类型以及数据长度等校验，可根据特殊需要通过编辑XML结构文件实现灵活的校验逻辑个性化调整；
9）EDI报文封装：
依据基于XML结构化技术的封装逻辑，将经数据映射之后的XML结构文件，封装为符合配置要求的EDI文件类型，根据配置项EDI文件类型要求，系统可支持TEXT/EXCEL/XML三种EDI文件格式的封装：
对于TEXT格式，通过编制各自的规则XML文件来实现各种不同EDI类型的封装，灵活化的XML规则描述，方便EDI报文格式的个性化配置；对于EXCEL格式，通过统一的封装接口，采用POI接口技术，将XML结构文件直接转换为EXCEL格式EDI文件；对于XML格式，无需执行封装，直接获取经数据映射之后的XML结构化EDI文件即可；
1.1.5.EDI报文发送功能
EDI文件发送管理，主要包括以下几个方面：
1）导出－FTP发送任务配置信息维护：
维护FTP发送EDI文件任务配置信息，包括FTP与FILECOPY两种方式发送，主要维护任务启动与关闭、任务状态、连接类型、传送类型、接收方服务器、文件路径、文件类型、登录用户名以及登录密码等配置信息；
2）导出－MAIL发送任务配置信息维护：
维护MAIL发送EDI文件任务配置信息，主要维护任务启动与关闭、任务状态、发送方服务器、发送方端口、发送方用户、发送方密码、发送方地址、接收地址、抄送地址、是否批次发送、邮件标题以及邮件内容等配置信息；
3）EDI文件发送：
将EDI文件从系统配置的EDI文件生成目录发送到EDI接收方指定机器的指定目录下，支持FTP/EMAIL/FILECOPY三种方式发送报文，完全配置化环境，根据用户需要，可针对不同类型EDI定制不同的发送方式；
1.1.6.EDI报文导出发送流程图
1.2.EDI数据处理监控跟踪
为了可以监控跟踪EDI数据报文在处理过程中所处的流程状态，设置了EDI导入和导出状态监控表。
EDI报文处理任务开始运行时，在监控表中为每个EDI报文记录一条监控记录，主要记录EDI报文处理是否成功或者正在处理过程中，同时会生成对应的日志文件记录详细的状态，在处理EDI数据的各个阶段的开始和结束均会在对应的日志文件中记录详细的处理信息。
报文处理失败的详细原因可以在日志文件中得到体现，用户可以主动通过客户端监控EDI的处理状态和处理日志，或者可以定制邮件反馈服务，系统将实时把EDI运行情况或者运行日志通过邮件方式反馈用户，日志邮件标题标识EDI运行成功或失败，方便用户及时对运行失败的EDI任务进行跟踪调整。
用户通过界面监控EDI处理状态日志示图：
2.数据结构
（一）报文数据映射配置表名:
IMS.EDI_MAPPING_RULE
中文名称
字段名称
字段类型
字段长度
NULL
MappingRuleId
MAPPING_RULE_ID
VARCHAR
50
Y
映射代码
MAPPING_CODE
VARCHAR
30
Y
映射描述
MAPPING_DESCRIPTION
VARCHAR
50
N
映射处理文件
MAPPING_RULE_FILE
VARCHAR
255
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（二）日志邮件发送任务表名:
IMS.EDI_LOG_MAIL_TASK
中文名称
字段名称
字段类型
字段长度
NULL
LogMailTaskId
LOG_MAIL_TASK_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
是否执行
ENABLE_FLAG
NUMERIC
1
N
任务状态
TASK_STATUS
VARCHAR
50
N
接收地址
MAIL_TO_ADDRESS
VARCHAR
500
N
抄送地址
MAIL_CC_ADDRESS
VARCHAR
500
N
初始化时间
INTERNAL_TIME
NUMERIC
12
N
下一次执行时间
NEXT_RUNNING_TIME
DATE
N
发送方服务器
MAIL_SEND_SERVER
VARCHAR
50
N
发送方端口
MAIL_SEND_PORT
NUMERIC
4
N
发送方用户
MAIL_SEND_USER
VARCHAR
50
N
发送方密码
MAIL_SEND_PASSWORD
VARCHAR
50
N
发送方地址
MAIL_SEND_ADDRESS
VARCHAR
50
N
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（三）报文解析参数配置表名:
IMS.EDI_INT_ENVELOPE
中文名称
字段名称
字段类型
字段长度
NULL
IntEnvelopeId
INT_ENVELOPE_ID
VARCHAR
50
Y
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
发送方标识
INT_SENDER_ID_QUALIFIER
VARCHAR
10
N
发送方代码
INT_SENDER_CODE
VARCHAR
35
N
接收方标识
INT_RECEIVER_ID_QUALIFIER
VARCHAR
10
N
接收方代码
INT_RECEIVER_CODE
VARCHAR
35
N
标准类型
INT_EDI_STANDARD_TYPE
CHAR
1
N
版本
INT_CTRL_VERSION
VARCHAR
20
N
报文总执行次数
INT_CTRL_NUM
NUMERIC
12
N
业务主键
INT_TRACK_KEY_NO_TYPE
VARCHAR
10
N
超时设定
INT_ACK_REQUESTED
CHAR
1
N
超时设定值
INT_ACK_REQUESTED_TIMEOUT
NUMERIC
12
N
用于测试
INT_TEST_IND
CHAR
1
N
报文组标识代码
FG_IDENTIFICATION
VARCHAR
6
N
报文组发送方标识
FG_APP_SENDER_QUAL
VARCHAR
10
N
报文组发送方代码
FG_APP_SENDER_CODE
VARCHAR
35
N
报文组接收方标识
FG_APP_RECEIVER_QUAL
VARCHAR
10
N
报文组接收方代码
FG_APP_RECEIVER_CODE
VARCHAR
35
N
报文组责任代理
FG_RESPONSIBLE_AGENCY
VARCHAR
3
N
报文组总执行次数
FG_CTRL_NUM
NUMERIC
12
N
报文组版本类型
FG_CTRL_VERSION_TYPE
VARCHAR
10
N
报文组版本号
FG_CTRL_VERSION_VALUE
VARCHAR
10
N
报文段标识代码
TS_IDENTIFIER_CODE
VARCHAR
14
N
报文段总执行次数
TS_CTRL_NUM
NUMERIC
12
N
段分隔符
RECORD_DELIMITER
NUMERIC
5
N
元素分隔符
ELEMENT_DELIMITER
NUMERIC
5
N
子元素分隔符
SUBELEMENT_DELIMITER
NUMERIC
5
N
字符删除
RELEASE_CHAR
NUMERIC
5
N
进制转化
DECIMAL_IND_CHAR
NUMERIC
5
N
特殊字符替换
ESCAPE_CHAR
NUMERIC
5
N
是否换行
REC_END_WITH_CR
NUMERIC
1
N
是否回车
REC_END_WITH_LF
NUMERIC
1
N
段标识名长度
SEGMENT_ID_LENGTH
NUMERIC
2
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（四）导出-报头处理任务配置表名:
IMS.EDI_OUT_ENVELOPE_TASK
中文名称
字段名称
字段类型
字段长度
NULL
OutEnvelopeTaskId
ENVELOPE_TASK_ID
VARCHAR
50
Y
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
是否执行
ENABLE_FLAG
NUMERIC
1
N
任务状态
TASK_STATUS
VARCHAR
10
N
报头处理文件
ENVELOPE_CMD_FILE
VARCHAR
255
N
初始化时间
INTERNAL_TIME
NUMERIC
12
N
下一次执行时间
NEXT_RUNNING_TIME
DATE
-1
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
-1
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（五）导出-报文封装任务配置表名:
IMS.EDI_OUT_MAPPING_TASK
中文名称
字段名称
字段类型
字段长度
NULL
OutMappingTaskId
MAPPING_TASK_ID
VARCHAR
50
Y
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
是否执行
ENABLE_FLAG
NUMERIC
1
N
任务状态
TASK_STATUS
VARCHAR
10
N
报文封装处理文件
OUT_MAPPING_CMD_FILE
VARCHAR
255
N
初始化时间
INTERNAL_TIME
NUMERIC
12
N
下一次执行时间
NEXT_RUNNING_TIME
DATE
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（六）导入-数据导入任务配置表名:
IMS.EDI_IN_IMPORT_TASK
中文名称
字段名称
字段类型
字段长度
NULL
InImportTaskId
IMPORT_TASK_ID
VARCHAR
50
Y
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
是否执行
ENABLE_FLAG
NUMERIC
1
N
任务执行状态
TASK_STATUS
VARCHAR
10
N
导入处理文件
IMPORT_CMD_FILE
VARCHAR
255
N
初始化时间
INTERNAL_TIME
NUMERIC
12
N
下一次执行时间
NEXT_RUNNING_TIME
DATE
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（七）导出-MAIL发送任务配置表名:
IMS.EDI_OUT_MAIL_TASK
中文名称
字段名称
字段类型
字段长度
NULL
OutMailTaskId
MAIL_TASK_ID
VARCHAR
50
Y
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
N
是否执行
ENABLE_FLAG
NUMERIC
1
N
任务状态
TASK_STATUS
VARCHAR
50
N
是否成批发送
MAIL_BATCH_SEND_FLAG
NUMERIC
1
N
邮件标题
MAIL_SUBJECT
VARCHAR
500
N
邮件内容
MAIL_BODY
VARCHAR
3998
N
接收地址
MAIL_TO_ADDRESS
VARCHAR
500
N
抄送地址
MAIL_CC_ADDRESS
VARCHAR
500
N
初始化时间
INTERNAL_TIME
NUMERIC
12
N
下一次执行时间
NEXT_RUNNING_TIME
DATE
-1
N
发送优先级
PREFERENCE_SEND
NUMERIC
12
N
发送方服务器
MAIL_SEND_SERVER
VARCHAR
50
N
发送方端口
MAIL_SEND_PORT
NUMERIC
4
N
发送方用户
MAIL_SEND_USER
VARCHAR
50
N
发送方密码
MAIL_SEND_PASSWORD
VARCHAR
20
N
发送方地址
MAIL_SEND_ADDRESS
VARCHAR
50
N
最后更新人员
UPDATED_BY_USER
CHAR
10
N
最后更新时间
UPDATED_DTM_LOC
DATE
-1
N
船公司组
PRINCIPAL_GROUP_CODE
VARCHAR
50
Y
（八）数据交换基本配置表名:
IMS.EDI_INTERCHANGE
中文名称
字段名称
字段类型
字段长度
NULL
InterchangeId
INTERCHANGE_ID
VARCHAR
50
Y
MappingRuleId
MAPPING_RULE_ID
VARCHAR
50
Y
交换代码
INTERCHANGE_CODE
VARCHAR
30
Y
交换描述
INTERCHANGE_DESCRIPTION
VARCHAR
50
N
交换方向
INT_DIRECTION
CHAR
1
N
业务主键
INT_TRACK_KEY_NO_TYPE
VARCHAR
10
N
超时设定
INT_ACK_REQUESTED
NUMERIC
1
N
超时设定值
INT_ACK_REQUESTED_TIMEOUT
NUMERIC
12
N
映射前文件代码
SRC_DOCUMENT_CODE
VARCHAR
30
N
映射前文件路径
SRC_MAPPING_DOC_PATH
VARCHAR
255
N
映射后文件代码
DST_DOCUMENT_CODE
VARCHAR
30
N
映射后文件路径
DST_MAPPING_DOC_PATH
VARCHAR
255
N
映射代码
MAPPING_CODE
VARCHAR
30
Y
抽取数据执行文件
OUT_EXTRACT_CMD_FILE
VARCHAR
255
N
抽取后文件路径
OUT_EXTRACT_PATH
VARCHAR
255
N
导入数据执行文件
IN_IMPORT_CMD_FILE
VARCHAR
255
N
导入前文件路径
IN_IMPORT_PATH
VARCHAR
255
N
是否过滤接收代码
IS_ACK
NUMERIC
1
N
接收代码设定
EXPECT_ACK_INT_CODE
VARCHAR
10
N
是否过滤发送代码
REQIRE_SEND_ACK
NUMERIC
1
N
发送代码设定
SEND_ACK_INT_CODE
升级会员 