箱管业务应急处理系统项目建设方案

箱管业务应急处理系统版本：<1.0>建设方案日期：<2015/02>机密亿通国际,DATE\@"yyyy"2015页码）技术路线采用目前亿通使用成熟技术，系统将基于J2EE规范，采用B/S与C/S混合模式进行开发，其中C/S模式主要应用于堆场打印操作界面采用亿通成熟的C/S框架（EPCF）。平台端采用B/S模式提供接口，采用亿通成熟的easyweb框架。图表STYLEREF2\s4.1SEQ图表\*ARABIC\s21体系结构如图所示，J2EE是多层的分布式体系结构，使系统的操作和运行具有很好的灵活性。先进的Java计算方案如面向对象、独立于平台、快速集成、代码重用以及丰富的界面开发API等，是实现这种结构的关键，并使系统具有良好的可移植性和可扩展性。（1）使用Tag、POJO（Java对象），和EJB等技术使得系统容易集成和具有最大的生产能力。在开发、发布、管理和重用应用逻辑等方面具有很大的灵活性。（2）基于工业标准保证数据交换的一致性和安全的网络架构，可以在应用和平台上达到高效的集成。因此，这种开放式结构特别适合于开发面向Web以及富客户端的应用系统。（3）丰富的基于Java技术的行业标准框架（Struts、Spring、Hibernate等），为提高系统的开发效率和开发质量提供了有效的保障。方案建设问题客户端应急方案虽然能不受网络、平台等各种故障限制，最大程度的保证打印EIR功能的可用性，但这种方案也存在很大的局限性，具体如下：由于该客户端与平台端有数据的双向交互，系统实现比较复杂； 数据同步客户端堆场后，无法有效控制用户，存在不应急的情况也使用客户端打印、数据被篡改等，然后将错误的数据上传到平台上，干扰平台正常的业务数据，影响平台后续业务出现混乱和不准确等一系列问题；船公司在打印EIR时会进行很多的校验，比如MSK存在13项校验、PIL存在11项校验，客户端由于数据不完整，无法进行如此全面的校验，需要重新梳理需求并得到船公司认可；船公司在打印EIR时，需要根据数据库中设置的规则打印箱标识等数据，这些数据在用户申请小票之后到打印EIR前可能会发生变化，由于客户端系统无法获取全部基础数据，数据也无法做到实时，可能会引发放箱问题；补充数据回传时，如果客户端的状态和平台端的状态不一致，如何处理；比如客户端已经打印EIR，但是平台端已经取消了小票等情况；计费信息回传：由于客户端数据不完整，部分船公司复杂的计费逻辑在堆场客户端系统将无法实现。运维工作问题：初装及后期的不定期系统强制更新；数据同步的异常情况跟踪及处理问题等均需要运维力量的投入。应用系统设计功能模块框架图表6.4-11功能模块框架图应急系统是一个涉及平台端,客户端，数据传输，用户管理等综合业务系统，它不仅要服务于各类使用用户，同时也需要与各类内外部信息系统进行互联和数据交换。根据应急业务需求，目标系统被分为3个业务模块，业务模块主要包括应急系统平台端，应急系统客户端EPCF，数据同步客户端。模块功能描述应急系统平台端模块结构图功能说明对系统中的平台端应急信息进行采集，管理和维护。应急Eir数据采集由EIR2MA_TICKET数据入库，同时生成通知报文，解析报文获得唯一barcode，根据barcode进行EIR的如下操作：应急Eir信息采集轮询EIR2MA_TICKET的报文目录，获取最新入库的报文。解析报文EIR2MA_TICKET取得barcode。调用标准eir接口获取eir数据/eirMobileComnInterface.do/searchYardPrintEir.doEir数据入库eir_emergency应急Eir数据同步应急Eir数据同步，采用FTP报文方式传输，报文格式采用json格式。向下同步：向下同步应急Eir数据同步平台端给每个客户端按orgCode开始ftp下载目录，客户端通过登陆用户的orgCode到指定目录同步属于自己的数据。同时实现本地业务数据更新。向上同步：所有客户端将向上同步的数据上传到唯一指定的目录，由平台端入库程序扫描入库，并同时抄送各个eir应用。应急Eir数据管理应急eir数据查询输入barcode和相关状态查询此eir数据人工干预用户根据系统罗列客户端数据和平台端数据出现冲突，决定是否收费等后续业务和出具报表。数据采集实现由EIR2MA_TICKET数据入库，同时生成通知报文。第一步：轮询采集报文目录，（报文结构见EIR2MA_TICKET表结构）解析报文获得唯一barcode，根据barcode第二步：根据barcode查询箱表和Bill表取得yard_code和location再根据yard_code和location查询mskeir_cod_mapping表获取orgCode具体语句如下：1、0开头的barcode查dataportalschema，1开头的barcode查eirschema2、selectrel_code,code_descfrommskeir_cod_mappingmwherem.data_type='MSKEIR_PRINTEIR_PLACE'andcode='?yard_code'andlocation='??'

如果CODE_DESC为空或者只有一个值，则REL_CODE中值即为该堆场的组织机构代码

如果CODE_DESC为‘，’分割的多个值，则需要按照逗号分割分别取，获取SQL同上，取REL_CODE值3、如果2的SQL查不到值，则用selectrel_codefrommskeir_cod_mappingmwherem.data_type='MSKEIR_DEPOT_INFO'andcode='?yard_code'andlocation='??'

REL_CODE则为组织机构代码第三步：获取业务数据（调用标准eir接口/eirMobileComnInterface.do/searchYardPrintEir.do参数为第一步和第二步的barcode和orgCode）。第四步：将获取的json数据和location，yardCode，orgCode（多个用逗号分开）入数据采集表，同时生成小票报文，存放对应的orgCode的ftp目录。现有系统的改造EIR2MA_TICKET数据入库端，新增报文生成功能，将打印申请单和修改申请单的数据生成报文，供平台端采集程序轮询现有标准eir接口有通过登录用户orgcode校验打印点及提箱地点正确性，针对数据采集接口不这个验证。各个eir应用端新增报文入库功能。应急系统客户端EPCF模块结构图功能说明考虑到目前eir打印都具有共性，当前设计成统一打印界面。Eir信息查询输入barcode查询此eir数据考虑降低epcf客户端的开发和维护成本，EIR信息查询打印页面采用通用页面，通用页面涵盖所有船公司所需的信息。不同船公司显示差异表如下OOCLMSK（上海）MSK（宁波）ZIM（上海）ZIM（青岛）HJSSTXPILNYKMOL提单号1111111111进港代码1码头预约号1111合同号11111111箱子头1111111箱标识11111111套用箱原订舱号1船名航次1111中转港111111实际船名1实际航次1目的港1ZIM放箱要求1船公司logo1111111111船公司1111111111车队备注1订舱确认时间1备注1注：1显示2可编辑Eir信息修改在查出而后用户可以修改或补录，箱号、车牌号、箱封号、是否外堆场提箱等信息。如图红色编辑区。不同船公司箱信息显示差异表如下OOCLMSK（上海）MSK（宁波）ZIM（上海）ZIM（青岛）HJSSTXPILNYKMOL箱型1111111111提箱地点1111111111状态1111111111箱号2222222222封号222222222车牌号2222222222设备交接单号22外堆场提箱2高代平2减免没用/原因2备注1其他1打印eir时间1注：1显示2可编辑Eir打印在用户填写完整eir信息后，用户可以打印eir。每个船公司eir都有自己的格式，所以我们为每家公司制定不同的模板，打印时选择不同的模板打印。打印样张如下：操作日志查询用户可以查询在客户端所有操作日志。例如修改信息和打印日志。数据同步客户端模块结构图模块功能说明 这是个后台同步程序，是部署在用户端服务器上，7X24小时不间断从亿通平台同步可打印eir数据并同时将用户端的打印的数据上传到平台。 同步服务提供系统配置功能，设置FTP账号、FTP用户名及密码、FTP下载目录、FTP回传目录、自动收取的时间间隔、回传时间间隔； 设置规则：以orgCode分类开设目录，并分配用户密码，打印终端通过orgCode和分配的用户密码收取服务器对应的目录报文。（注：以orgCode为用户名好处是可以根据orgCode来控制打印点获取报文权限）向下同步数据应急系统客户端，采用登录用户的orgCode和ftp密码，定时通过FTP方式，到指定的ftp目录（以orgCode分类开设目录）收取，属于自己堆场或打印点的报文，解析入库。向上同步数据当网络恢复，FTP能连接上平台ftp服务器，就开始回传用户打印和修改的eir数据。采集本地需要向上同步的已打印eir数据（data_status=未上传，ctn_status=已打印）生成回传报文报文标准采用json，格式见EIR_EMERGENCY表结构将本地数据状态设置成已同步工作量估算具体工作量有待客户端的功能范围划定后才能估算。但总体来说工作量会比较大。只要原因为：由于客户端数据不全等限制，客户端系统的需求和目前正式使用的系统的需求会有很大不同，需要分船公司重新梳理定义。不同船公司由于控制逻辑不同、打印格式不同等，均需要进行不同的开发。系统分两阶段进行，第一阶段完成上海10家船公司出口业务的应急，工作量如下：序号项目数量(人月)1EIR平台端服务改造32应急系统平台端73应急系统客户端EPCF64数据同步客户端1总计17第二阶段：完成上海进口、退关改配业务的应急及外地业务的应急系统，工作量估算如下：序号项目数量(人月)1EIR平台端服务改造62应急系统平台端33应急系统客户端EPCF84数据同步客户端1总计18数据管理方案业务数据来源Eir系统数据项机构基本信息表名EIR_EMERGENCY列名数据类型描述空/非空约束条件idNUMBER(18)idY系统自动生成的唯一ID,PKLocationVarchar2(500)船公司代码YYard_codeVarchar2(500)堆场代码YOrg_codeVarchar2(500)组织机构代码Y多个打印点逗号隔开barcodeVarchar2(500)barcodeYEir_dataVarchar2(4000)Eirjson串YData_statusVarchar2(500)数据状态Y1新数据2已上传3数据冲突Ctn_statusVarchar2(500)箱状态Y1未打印2已打印3撤销conflictVarchar2(500)冲突原因RemarkVarchar2(500)RemarkC1Varchar2(500)C1扩展字段C2Varchar2(500)C2扩展字段C3Varchar2(500)C3扩展字段update_timeDATE最后更新时间create_timeDATE创建时间表名EIR_LOG列名数据类型描述空/非空约束条件idNUMBER(18)idY系统自动生成的唯一ID,PKLocationVarchar2(500)船公司代码Yard_codeVarchar2(500)堆场代码BarcodeVarchar2(500)barcodeCtn_noVarchar2(500)CTN_NO可编辑Plate_NoVarchar2(500)PLATE_NO可编辑Seal_NoVarchar2(500)SEAL_NO可编辑Opt_typeVarchar2(500)Opt_type操作类型1打印2修改数据3平台撤销RemarkVarchar2(500)Remarkcreate_timeDATE创建时间eirJSON串数据项名称代码描述箱IDctnId箱表中ID条形码barcode取自MSKEIR_BIZ_CTNR表barcode字段船公司代码businessType提单表中的LOCATION船公司中文名称shipper根据LOCATION和dataType='MSKEIR_SHIP_INFO'查询表MskeirCodMapping，如果CodeName非空，则返回，如果CodeName为空，则以LOCATION作为船公司中文名称经办日期dateOOCL,CMA,MOL:无；STX:当前数据库时间，格式：yyyy-MM-dd用箱人/运箱人containerUserOOCL，CMA，STX：根据‘apply.applicant_code+MSKEIR_TRANSCARRIER+港口代码’匹配代码映射表code+data_type+location，从而获取code_name；匹配不到则取apply.applicant_codeMOL：根据箱表中的PRINT_NOTICE_ORG和DATA_TYPE=MSKEIR_TRANSCARRIER查询MSKEIR_COD_MAPPING表，返回对应的CODE_NAME字段值提箱地点yardNameOOCL：打印堆场的中文名称。如果提箱地点不为外堆场（ctnr.cy_code≠WDC），则根据‘ctnr.cy_code+MSKEIR_DEPOT_INFO+港口代码’匹配代码映射表的code+data_type+location，从而获取code_name;如果提箱地点为外堆场（ctnr.cy_code＝WDC），则根据ctnr.specyard_id关联到MSKEIR_COD_SPEC_YARD表，从而获取外堆场名称（wdc_name），匹配不到，则固定打印‘外堆场’CMA，STX：ctnr表cy_code对应的中文和地址MOL：如果是SOC（c.soc_tag=’Y’），则返回为空；否则根据箱表的CY_CODE和DATA_TYPE=MSEIR_DEPOT_INFO查询MSKEIR_COD_MAPPING表，取CODE_NAME字段船名vesselOOCL,CMA,STX:BILL中vesselMOL:根据BILL表中的VESSEL、VOYAGE、LOCATION到LBS系统获取对应的船名，若有能成功返回，则取LBS返回的船名，如果没有成功返回，取BILL表中的VESSEL航次voyageOOCL,CMA,STX:BILL中VOYAGEMOL:根据BILL表中的VESSEL、VOYAGE、LOCATION到LBS系统获取对应的船名，若有能成功返回，则取LBS返回的航次;如果没有成功返回，取BILL表中的VOYAGE提单号bookingNoOOCL,CMA,STX:BILL中bookingNoMOL:MOLU+BOOKING_NO集装箱经营人ctnOprCodeOOCL：根据箱表MSKEIR_BIZ_CTNR的soc_tag字段判断如果soc_tag=’Y’，则固定打印‘SOC’；如果soc_tag=’N’，则固定打印‘OOCL’CMA，STX：根据箱表MSKEIR_BIZ_CTNR的soc_tag字段判断如果soc_tag=’Y’，则固定打印‘SOC’；如果soc_tag为空则打印BILL中的ctn_opr_code;MOL：固定为MOL集装箱号ctno取自MSKEIR_BIZ_CTNR表ctn_no字段铅封号sealNoOOCL,MOL：取自MSKEIR_BIZ_CTNR表sealNoCMA，STX：无尺寸sizeOOCL：箱型：取自MSKEIR_BIZ_CTNR表ctn_typeCMA,STX：ctnr表ctn_type字段,格式:尺寸和箱型用’/’分开,例如20/GP（在尺寸/箱型栏打印）MOL：根据箱表的CTN_TYPE和DATA_TYPE=MSKEIR_CTNTYPE、LOCATION=MOL查询MSKEIR_COD_MAPPING表，获取CODE_DESC字段值，若匹配不上则返回空；类型type空状态status无；运载工具牌号，车牌号plateNoOOCL，MOL：取自MSKEIR_BIZ_CTNR表plate_noCMA，STX：无发往地点deliveryCodeOOCL：取自MSKEIR_BIZ_BILL表的gate_in字段CMA,STX：b.trans_port_code需要映射,取码表中全名,条件MSKEIR_TRANSPORT_CODE,如果映射不到取原值MOL：固定为City返回地点placeOfReturnOOCL,CMA,STX:打印进港码头名称，取自MSKEIR_BIZ_OPENEIR表的place_of_return字段注1：条件openType='V'、openValue='ALL'、vessel、voyage、location和LoadPortCodeMOL：根据BILL表中的IN_HARBOUR_CODE、LOCATION、DATA_TYPE=MOLEIR_IN_HARBOUR_CODE查询MSKEIR_COD_MAPPING表获取CODE_NAME字段值；免费使用期限freeTimePeriodOOCL：无CMA，STX：打印日期~打印日期+箱型对应免费日期(无对应免费日期箱子只显示’~’)，格式举例:2011-12-07~2011-12-17MOL：开始时间为系统当前时间若箱表中的HAND_TYPE含有REEF，则结束时间为开始时间+4天；否则以开始时间+6天计算；格试：yyyy-MM-dd~yyyy-mm-dd进出场日期timeInOutOOCL：无CMA，MOL:出场日期：系统当前日期（MM月dd日HH时）STX：空备注：remarkOOCL:合同号:先从ctnr.contract_no字段获取；如果为空，再根据ctnr.specyard_id获取特种箱堆场分配规则表MSKEIR_COD_SPEC_YARD表的contract_no字段；如果匹配不到，则此项不打印箱字头:根据ctnr.specyard_id获取特种箱堆场分配规则表MSKEIR_COD_SPEC_YARD表的ctn_prefix