最新JAVAEDI平台开发流程.docx

1、最新JAVAEDI平台开发流程JAVA-EDI平台开发流程1. 功能说明 21.1. EDI 报文处理功能 21.1.1. EDI报文接收功能 21.1.2. EDI报文导入功能 21.1.3. EDI报文接收导入流程图 41.1.4. EDI报文导出功能 41.1.5. EDI报文发送功能 51.1.6. EDI报文导出发送流程图 61.2. EDI数据处理监控跟踪 62. 数据结构 73. 定时调度实现方式 154. 报文处理主要接口说明 174.1. 报文接收主要接口 174.2. 报文发送主要接口 174.3. 报文导入主要接口 174.4. 报文导出主要接口 184.5. 导入监控日

2、志发送主要接口 184.6. 导出监控日志发送主要接口 184.7. EDI报文格式转换及监控日志处理类 185. EDI接口开发说明 185.1. 编写EDI接口所需的解析映射文件 185.1.1. 编写规则文件 185.1.2. 编写报头处理文件 195.1.3. 编写Map文件 205.2. EDI基本配置和相关的编程 215.2.1. EDI报文导入和导出均需要的配置 225.2.2. 导出-数据抽取任务配置 265.2.3. 导出-报文封装任务 285.2.4. 导出-FTP发送任务 285.2.5. 导出-MAIL发送任务 295.2.6. 导入-FTP接收任务 295.2.7.

3、导入-报文解析任务 305.2.8. 导入-数据导入任务 301.功能说明1.1.EDI 报文处理功能1.1.1.EDI报文接收功能EDI文件接收管理，主要包括以下几个方面：1）导入FTP接收任务配置信息维护：维护FTP接收EDI文件任务配置信息，包括FTP与FILE COPY两种方式接收，主要维护任务启动与关闭、任务状态、传送类型、发送方服务器、文件路径、文件类型、登录用户名以及登录密码等配置信息；2）EDI文件接收：将EDI文件拷贝到EDI监控目录供后续处理，支持FTP/EMAIL/FILE COPY三种方式接收报文，完全配置化环境，根据用户需要，可针对不同类型EDI定制不同的接收方式；1

4、.1.2.EDI报文导入功能EDI导入基本流程管理，主要包括以下几个方面：1）导入报文解析任务配置信息维护：维护EDI报文解析任务配置信息，主要是任务启动与关闭以及XML规则文件的配置；2）导入报头处理任务配置信息维护：维护EDI报头处理任务配置信息，主要是任务启动与关闭以及XSLT报头处理文件的配置；3）导入数据导入任务配置信息维护：维护EDI数据导入任务配置信息，主要是任务启动与关闭的配置；4）EDI预处理：将报文处理为符合解析平台的格式，针对不同格式报文提供灵活的预处理平台，通过预处理把不符合解析平台的报文格式处理为符合解析平台的报文格式，对于不同类型EDI的预处理过程封装在不同的jav

5、a文件中，java文件的位置可通过配置来指定；5）EDI报文解析：将规则化、结构化的EDI文件解析为易于平台处理的XML文件，基于XML技术的报文解析平台，支持TEXT/EXCEL/XML三种报文格式的解析：对于TEXT格式，通过编制各自的规则XML文件来实现各种不同EDI类型的解析，灵活化的XML规则描述，方便EDI报文格式的个性化配置；对于EXCEL格式，通过统一的解析接口，提供两种解析结构，即需要执行数据校验与不需要执行数据校验，对于需要执行数据校验的解析方式，在EXCEL格式方面要求更为规范化，数据解析准确度更高，三种报文的解析结果均为XML结构化文件；6）EDI数据校验：校验EDI数

6、据，主要涉及必输性、数据类型以及数据长度，灵活的报文数据验证平台，通过编制不同的XML结构文件，可实现各种不同EDI类型的数据校验，包括必输性、数据类型以及数据长度等校验，可根据特殊需要通过编辑XML结构文件实现灵活的校验逻辑个性化调整；7）EDI数据映射：主要组织XML数据结构、EDI取数以及初步业务逻辑实现，基于XSLT技术的报文数据映射平台，其主要任务包括：组织XML数据结构、EDI取数以及初步业务逻辑实现。经解析之后且成功通过数据格式校验的XML结构文件，采用基于XSLT技术的数据映射技术，对该XML结构文件执行基于预先定义好的XSLT映射文件MAPPING为另外一种结构更加接近系统平

7、台数据结构的XML结构文件；8）EDI报头处理：主要记录EDI执行信息，将经MAPPING之后的XML结构文件再进行一次XSLT处理，其主要目的是记录下该EDI执行信息，以提供后面EDI数据重复导入的识别标志；9）EDI数据写入数据库：首先对一些系统内部业务逻辑执行校验，以确报导入EDI数据的准确性，若校验通过，记录主要业务信息并通过邮件反馈，若为手工导入，还要将成功导入信息反馈到EDI导入操作界面；若校验失败，记录错误信息并通过邮件反馈，若为手工导入，还要将错误信息反馈到EDI导入操作界面；把EDI数据写入业务数据库，若写入成功，记录主要业务信息并通过邮件反馈，若为手工导入，还要将成功导入信

8、息反馈到EDI导入操作界面；若写入失败，记录错误信息并通过邮件反馈，若为手工导入，还要将错误信息反馈到EDI导入操作界面；1.1.3.EDI报文接收导入流程图1.1.4.EDI报文导出功能EDI导出基本流程，主要包括以下几个方面：1）导出数据抽取任务配置信息维护：维护EDI数据抽取任务配置信息，主要是任务启动与关闭设定、抽取数据XML参数配置、任务执行状态等配置信息的维护；2）导出报头处理任务配置信息维护：维护EDI报头处理任务配置信息，主要是任务启动与关闭设定以及XSLT报头处理文件的配置；3）导出报文封装任务配置信息维护：维护EDI报文封装任务配置信息，主要是任务启动与关闭以及XML规则文

9、件的配置；4）EDI发送任务指令：根据具体业务要求，用户通过EDI导出操作界面，按照一定的业务逻辑，输入查询条件，获取系统业务数据，在确认发送之后，将形成EDI发送任务指令，并存储在EDI数据抽取任务队列中；5）EDI数据抽取：遍历EDI数据抽取任务队列，识别出需要执行的EDI任务，读取任务配置信息项抽取数据XML参数，按照一定的业务逻辑，抽取业务系统中的相关数据，然后按照业务数据结构要求把抽取出来的数据拼装成一个EDI报文单位的树型层次结构XML数据。并将XML数据以文件格式保存到指定的数据拼装目录下面，同时记录处理过程到EDI运行日志文件并及时更新任务执行状态；6）EDI报头处理：对抽取出

10、来的EDI数据经拼装之后的XML结构文件执行报头处理，其主要目的是记录EDI执行信息以及读取报文报头信息，比如获取发送方代码、接收方代码、报文标准等报头信息，以在报文中记录相关信息以方便接收方识别；7）EDI数据映射：主要是实现业务逻辑分析并拆分相应业务数据以及数据项取数，将经报头处理之后的XML结构文件，采用基于XSLT技术的数据映射技术，对该XML结构文件执行基于预先定义好的XSLT映射文件MAPPING为另外一种结构更加接近EDI标准描述的XML规则格式数据结构的XML结构文件；8）EDI数据校验：校验EDI数据，主要涉及必输性、数据类型以及数据长度，灵活的报文数据验证平台，通过编制不同

11、的XML结构文件，可实现各种不同EDI类型的数据校验，包括必输性、数据类型以及数据长度等校验，可根据特殊需要通过编辑XML结构文件实现灵活的校验逻辑个性化调整；9）EDI报文封装：依据基于XML结构化技术的封装逻辑，将经数据映射之后的XML结构文件，封装为符合配置要求的EDI文件类型，根据配置项EDI文件类型要求，系统可支持TEXT/EXCEL/XML三种EDI文件格式的封装：对于TEXT格式，通过编制各自的规则XML文件来实现各种不同EDI类型的封装，灵活化的XML规则描述，方便EDI报文格式的个性化配置；对于EXCEL格式，通过统一的封装接口，采用POI接口技术，将XML结构文件直接转换为

12、EXCEL格式EDI文件；对于XML格式，无需执行封装，直接获取经数据映射之后的XML结构化EDI文件即可；1.1.5.EDI报文发送功能EDI文件发送管理，主要包括以下几个方面：1）导出FTP发送任务配置信息维护：维护FTP发送EDI文件任务配置信息，包括FTP与FILE COPY两种方式发送，主要维护任务启动与关闭、任务状态、连接类型、传送类型、接收方服务器、文件路径、文件类型、登录用户名以及登录密码等配置信息；2）导出MAIL发送任务配置信息维护：维护MAIL发送EDI文件任务配置信息，主要维护任务启动与关闭、任务状态、发送方服务器、发送方端口、发送方用户、发送方密码、发送方地址、接收地

13、址、抄送地址、是否批次发送、邮件标题以及邮件内容等配置信息；3）EDI文件发送：将EDI文件从系统配置的EDI文件生成目录发送到EDI接收方指定机器的指定目录下，支持FTP/EMAIL/FILE COPY三种方式发送报文，完全配置化环境，根据用户需要，可针对不同类型EDI定制不同的发送方式；1.1.6.EDI报文导出发送流程图1.2.EDI数据处理监控跟踪为了可以监控跟踪EDI数据报文在处理过程中所处的流程状态，设置了EDI导入和导出状态监控表。EDI报文处理任务开始运行时，在监控表中为每个EDI报文记录一条监控记录，主要记录EDI报文处理是否成功或者正在处理过程中，同时会生成对应的日志文件记

14、录详细的状态，在处理EDI数据的各个阶段的开始和结束均会在对应的日志文件中记录详细的处理信息。报文处理失败的详细原因可以在日志文件中得到体现，用户可以主动通过客户端监控EDI的处理状态和处理日志，或者可以定制邮件反馈服务，系统将实时把EDI运行情况或者运行日志通过邮件方式反馈用户，日志邮件标题标识EDI运行成功或失败，方便用户及时对运行失败的EDI任务进行跟踪调整。用户通过界面监控EDI处理状态日志示图：2.数据结构（一）报文数据映射配置 表名: IMS.EDI_MAPPING_RULE中文名称字段名称字段类型字段长度NULLMapping Rule IdMAPPING_RULE_IDVARC

15、HAR50Y映射代码MAPPING_CODEVARCHAR30Y映射描述MAPPING_DESCRIPTIONVARCHAR50N映射处理文件MAPPING_RULE_FILEVARCHAR255N最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATEN船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（二）日志邮件发送任务 表名: IMS.EDI_LOG_MAIL_TASK中文名称字段名称字段类型字段长度NULLLog Mail Task IdLOG_MAIL_TASK_IDVARCHAR50Y交换代码INTERCHANG

16、E_CODEVARCHAR30Y是否执行ENABLE_FLAGNUMERIC1N任务状态TASK_STATUSVARCHAR50N接收地址MAIL_TO_ADDRESSVARCHAR500N抄送地址MAIL_CC_ADDRESSVARCHAR500N初始化时间INTERNAL_TIMENUMERIC12N下一次执行时间NEXT_RUNNING_TIMEDATEN发送方服务器MAIL_SEND_SERVERVARCHAR50N发送方端口MAIL_SEND_PORTNUMERIC4N发送方用户MAIL_SEND_USERVARCHAR50N发送方密码MAIL_SEND_PASSWORDVARCHA

17、R50N发送方地址MAIL_SEND_ADDRESSVARCHAR50NInterchange IdINTERCHANGE_IDVARCHAR50Y最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATEN船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（三）报文解析参数配置 表名: IMS.EDI_INT_ENVELOPE中文名称字段名称字段类型字段长度NULLInt Envelope IdINT_ENVELOPE_IDVARCHAR50YInterchange IdINTERCHANGE_IDVARCHAR50Y交换代码

18、INTERCHANGE_CODEVARCHAR30Y发送方标识INT_SENDER_ID_QUALIFIERVARCHAR10N发送方代码INT_SENDER_CODEVARCHAR35N接收方标识INT_RECEIVER_ID_QUALIFIERVARCHAR10N接收方代码INT_RECEIVER_CODEVARCHAR35N标准类型INT_EDI_STANDARD_TYPECHAR1N版本INT_CTRL_VERSIONVARCHAR20N报文总执行次数INT_CTRL_NUMNUMERIC12N业务主键INT_TRACK_KEY_NO_TYPEVARCHAR10N超时设定INT_ACK

19、_REQUESTEDCHAR1N超时设定值INT_ACK_REQUESTED_TIMEOUTNUMERIC12N用于测试INT_TEST_INDCHAR1N报文组标识代码FG_IDENTIFICATIONVARCHAR6N报文组发送方标识FG_APP_SENDER_QUALVARCHAR10N报文组发送方代码FG_APP_SENDER_CODEVARCHAR35N报文组接收方标识FG_APP_RECEIVER_QUALVARCHAR10N报文组接收方代码FG_APP_RECEIVER_CODEVARCHAR35N报文组责任代理FG_RESPONSIBLE_AGENCYVARCHAR3N报文组总

20、执行次数FG_CTRL_NUMNUMERIC12N报文组版本类型FG_CTRL_VERSION_TYPEVARCHAR10N报文组版本号FG_CTRL_VERSION_VALUEVARCHAR10N报文段标识代码TS_IDENTIFIER_CODEVARCHAR14N报文段总执行次数TS_CTRL_NUMNUMERIC12N段分隔符RECORD_DELIMITERNUMERIC5N元素分隔符ELEMENT_DELIMITERNUMERIC5N子元素分隔符SUBELEMENT_DELIMITERNUMERIC5N字符删除RELEASE_CHARNUMERIC5N进制转化DECIMAL_IND_C

21、HARNUMERIC5N特殊字符替换ESCAPE_CHARNUMERIC5N是否换行REC_END_WITH_CRNUMERIC1N是否回车REC_END_WITH_LFNUMERIC1N段标识名长度SEGMENT_ID_LENGTHNUMERIC2N最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATEN船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（四）导出-报头处理任务配置 表名: IMS.EDI_OUT_ENVELOPE_TASK中文名称字段名称字段类型字段长度NULLOut Envelope Task IdEN

22、VELOPE_TASK_IDVARCHAR50YInterchange IdINTERCHANGE_IDVARCHAR50Y交换代码INTERCHANGE_CODEVARCHAR30Y是否执行ENABLE_FLAGNUMERIC1N任务状态TASK_STATUSVARCHAR10N报头处理文件ENVELOPE_CMD_FILEVARCHAR255N初始化时间INTERNAL_TIMENUMERIC12N下一次执行时间NEXT_RUNNING_TIMEDATE-1N最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATE-1N船公司组PRINCI

23、PAL_GROUP_CODEVARCHAR50Y（五）导出-报文封装任务配置 表名: IMS.EDI_OUT_MAPPING_TASK中文名称字段名称字段类型字段长度NULLOut Mapping Task IdMAPPING_TASK_IDVARCHAR50YInterchange IdINTERCHANGE_IDVARCHAR50Y交换代码INTERCHANGE_CODEVARCHAR30Y是否执行ENABLE_FLAGNUMERIC1N任务状态TASK_STATUSVARCHAR10N报文封装处理文件OUT_MAPPING_CMD_FILEVARCHAR255N初始化时间INTERNAL

24、_TIMENUMERIC12N下一次执行时间NEXT_RUNNING_TIMEDATEN最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATEN船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（六）导入-数据导入任务配置 表名: IMS.EDI_IN_IMPORT_TASK中文名称字段名称字段类型字段长度NULLIn Import Task IdIMPORT_TASK_IDVARCHAR50YInterchange IdINTERCHANGE_IDVARCHAR50Y交换代码INTERCHANGE_CODEVARCHAR3

25、0Y是否执行ENABLE_FLAGNUMERIC1N任务执行状态TASK_STATUSVARCHAR10N导入处理文件IMPORT_CMD_FILEVARCHAR255N初始化时间INTERNAL_TIMENUMERIC12N下一次执行时间NEXT_RUNNING_TIMEDATEN最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATEN船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（七）导出-MAIL发送任务配置 表名: IMS.EDI_OUT_MAIL_TASK中文名称字段名称字段类型字段长度NULLOut Mail

26、 Task IdMAIL_TASK_IDVARCHAR50YInterchange IdINTERCHANGE_IDVARCHAR50Y交换代码INTERCHANGE_CODEVARCHAR30N是否执行ENABLE_FLAGNUMERIC1N任务状态TASK_STATUSVARCHAR50N是否成批发送MAIL_BATCH_SEND_FLAGNUMERIC1N邮件标题MAIL_SUBJECTVARCHAR500N邮件内容MAIL_BODYVARCHAR3998N接收地址MAIL_TO_ADDRESSVARCHAR500N抄送地址MAIL_CC_ADDRESSVARCHAR500N初始化时间I

27、NTERNAL_TIMENUMERIC12N下一次执行时间NEXT_RUNNING_TIMEDATE-1N发送优先级PREFERENCE_SENDNUMERIC12N发送方服务器MAIL_SEND_SERVERVARCHAR50N发送方端口MAIL_SEND_PORTNUMERIC4N发送方用户MAIL_SEND_USERVARCHAR50N发送方密码MAIL_SEND_PASSWORDVARCHAR20N发送方地址MAIL_SEND_ADDRESSVARCHAR50N最后更新人员UPDATED_BY_USERCHAR10N最后更新时间UPDATED_DTM_LOCDATE-1N船公司组PRINCIPAL_GROUP_CODEVARCHAR50Y（八）数据交换基本配置 表名: IMS.EDI_INTERCHANGE中文名称字段名称字段类型字段长度NULLInterchange IdINTERCHANGE_IDVARCHAR50YMapping Rule IdMAPPING_RULE_IDVARCHAR50Y交换代码INTERCHANGE_CODEVARCHAR30Y交换描述INTERCHANGE_DESCRIPTIONVARCHAR50N交换方向INT_DIRECTIONCHAR1N业务主键INT_TRACK_KEY_NO_TYPEVARCHAR