箱管業(yè)務(wù)應(yīng)急處理系統(tǒng)項目建設(shè)方案

箱管業(yè)務(wù)應(yīng)急處理系統(tǒng)版本：<1.0>建設(shè)方案日期：<2015/02>機密億通國際,DATE\@"yyyy"2015頁碼）技術(shù)路線采用目前億通使用成熟技術(shù)，系統(tǒng)將基于J2EE規(guī)范，采用B/S與C/S混合模式進行開發(fā)，其中C/S模式主要應(yīng)用于堆場打印操作界面采用億通成熟的C/S框架（EPCF）。平臺端采用B/S模式提供接口，采用億通成熟的easyweb框架。圖表STYLEREF2\s4.1SEQ圖表\*ARABIC\s21體系結(jié)構(gòu)如圖所示，J2EE是多層的分布式體系結(jié)構(gòu)，使系統(tǒng)的操作和運行具有很好的靈活性。先進的Java計算方案如面向?qū)ο?、獨立于平臺、快速集成、代碼重用以及豐富的界面開發(fā)API等，是實現(xiàn)這種結(jié)構(gòu)的關(guān)鍵，并使系統(tǒng)具有良好的可移植性和可擴展性。（1）使用Tag、POJO（Java對象），和EJB等技術(shù)使得系統(tǒng)容易集成和具有最大的生產(chǎn)能力。在開發(fā)、發(fā)布、管理和重用應(yīng)用邏輯等方面具有很大的靈活性。（2）基于工業(yè)標準保證數(shù)據(jù)交換的一致性和安全的網(wǎng)絡(luò)架構(gòu)，可以在應(yīng)用和平臺上達到高效的集成。因此，這種開放式結(jié)構(gòu)特別適合于開發(fā)面向Web以及富客戶端的應(yīng)用系統(tǒng)。（3）豐富的基于Java技術(shù)的行業(yè)標準框架（Struts、Spring、Hibernate等），為提高系統(tǒng)的開發(fā)效率和開發(fā)質(zhì)量提供了有效的保障。方案建設(shè)問題客戶端應(yīng)急方案雖然能不受網(wǎng)絡(luò)、平臺等各種故障限制，最大程度的保證打印EIR功能的可用性，但這種方案也存在很大的局限性，具體如下：由于該客戶端與平臺端有數(shù)據(jù)的雙向交互，系統(tǒng)實現(xiàn)比較復(fù)雜； 數(shù)據(jù)同步客戶端堆場后，無法有效控制用戶，存在不應(yīng)急的情況也使用客戶端打印、數(shù)據(jù)被篡改等，然后將錯誤的數(shù)據(jù)上傳到平臺上，干擾平臺正常的業(yè)務(wù)數(shù)據(jù)，影響平臺后續(xù)業(yè)務(wù)出現(xiàn)混亂和不準確等一系列問題；船公司在打印EIR時會進行很多的校驗，比如MSK存在13項校驗、PIL存在11項校驗，客戶端由于數(shù)據(jù)不完整，無法進行如此全面的校驗，需要重新梳理需求并得到船公司認可；船公司在打印EIR時，需要根據(jù)數(shù)據(jù)庫中設(shè)置的規(guī)則打印箱標識等數(shù)據(jù)，這些數(shù)據(jù)在用戶申請小票之后到打印EIR前可能會發(fā)生變化，由于客戶端系統(tǒng)無法獲取全部基礎(chǔ)數(shù)據(jù)，數(shù)據(jù)也無法做到實時，可能會引發(fā)放箱問題；補充數(shù)據(jù)回傳時，如果客戶端的狀態(tài)和平臺端的狀態(tài)不一致，如何處理；比如客戶端已經(jīng)打印EIR，但是平臺端已經(jīng)取消了小票等情況；計費信息回傳：由于客戶端數(shù)據(jù)不完整，部分船公司復(fù)雜的計費邏輯在堆場客戶端系統(tǒng)將無法實現(xiàn)。運維工作問題：初裝及后期的不定期系統(tǒng)強制更新；數(shù)據(jù)同步的異常情況跟蹤及處理問題等均需要運維力量的投入。應(yīng)用系統(tǒng)設(shè)計功能模塊框架圖表6.4-11功能模塊框架圖應(yīng)急系統(tǒng)是一個涉及平臺端,客戶端，數(shù)據(jù)傳輸，用戶管理等綜合業(yè)務(wù)系統(tǒng)，它不僅要服務(wù)于各類使用用戶，同時也需要與各類內(nèi)外部信息系統(tǒng)進行互聯(lián)和數(shù)據(jù)交換。根據(jù)應(yīng)急業(yè)務(wù)需求，目標系統(tǒng)被分為3個業(yè)務(wù)模塊，業(yè)務(wù)模塊主要包括應(yīng)急系統(tǒng)平臺端，應(yīng)急系統(tǒng)客戶端EPCF，數(shù)據(jù)同步客戶端。模塊功能描述應(yīng)急系統(tǒng)平臺端模塊結(jié)構(gòu)圖功能說明對系統(tǒng)中的平臺端應(yīng)急信息進行采集，管理和維護。應(yīng)急Eir數(shù)據(jù)采集由EIR2MA_TICKET數(shù)據(jù)入庫，同時生成通知報文，解析報文獲得唯一barcode，根據(jù)barcode進行EIR的如下操作：應(yīng)急Eir信息采集輪詢EIR2MA_TICKET的報文目錄，獲取最新入庫的報文。解析報文EIR2MA_TICKET取得barcode。調(diào)用標準eir接口獲取eir數(shù)據(jù)/eirMobileComnInterface.do/searchYardPrintEir.doEir數(shù)據(jù)入庫eir_emergency應(yīng)急Eir數(shù)據(jù)同步應(yīng)急Eir數(shù)據(jù)同步，采用FTP報文方式傳輸，報文格式采用json格式。向下同步：向下同步應(yīng)急Eir數(shù)據(jù)同步平臺端給每個客戶端按orgCode開始ftp下載目錄，客戶端通過登陸用戶的orgCode到指定目錄同步屬于自己的數(shù)據(jù)。同時實現(xiàn)本地業(yè)務(wù)數(shù)據(jù)更新。向上同步：所有客戶端將向上同步的數(shù)據(jù)上傳到唯一指定的目錄，由平臺端入庫程序掃描入庫，并同時抄送各個eir應(yīng)用。應(yīng)急Eir數(shù)據(jù)管理應(yīng)急eir數(shù)據(jù)查詢輸入barcode和相關(guān)狀態(tài)查詢此eir數(shù)據(jù)人工干預(yù)用戶根據(jù)系統(tǒng)羅列客戶端數(shù)據(jù)和平臺端數(shù)據(jù)出現(xiàn)沖突，決定是否收費等后續(xù)業(yè)務(wù)和出具報表。數(shù)據(jù)采集實現(xiàn)由EIR2MA_TICKET數(shù)據(jù)入庫，同時生成通知報文。第一步：輪詢采集報文目錄，（報文結(jié)構(gòu)見EIR2MA_TICKET表結(jié)構(gòu)）解析報文獲得唯一barcode，根據(jù)barcode第二步：根據(jù)barcode查詢箱表和Bill表取得yard_code和location再根據(jù)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中值即為該堆場的組織機構(gòu)代碼

如果CODE_DESC為‘，’分割的多個值，則需要按照逗號分割分別取，獲取SQL同上，取REL_CODE值3、如果2的SQL查不到值，則用selectrel_codefrommskeir_cod_mappingmwherem.data_type='MSKEIR_DEPOT_INFO'andcode='?yard_code'andlocation='??'

REL_CODE則為組織機構(gòu)代碼第三步：獲取業(yè)務(wù)數(shù)據(jù)（調(diào)用標準eir接口/eirMobileComnInterface.do/searchYardPrintEir.do參數(shù)為第一步和第二步的barcode和orgCode）。第四步：將獲取的json數(shù)據(jù)和location，yardCode，orgCode（多個用逗號分開）入數(shù)據(jù)采集表，同時生成小票報文，存放對應(yīng)的orgCode的ftp目錄。現(xiàn)有系統(tǒng)的改造EIR2MA_TICKET數(shù)據(jù)入庫端，新增報文生成功能，將打印申請單和修改申請單的數(shù)據(jù)生成報文，供平臺端采集程序輪詢現(xiàn)有標準eir接口有通過登錄用戶orgcode校驗打印點及提箱地點正確性，針對數(shù)據(jù)采集接口不這個驗證。各個eir應(yīng)用端新增報文入庫功能。應(yīng)急系統(tǒng)客戶端EPCF模塊結(jié)構(gòu)圖功能說明考慮到目前eir打印都具有共性，當前設(shè)計成統(tǒng)一打印界面。Eir信息查詢輸入barcode查詢此eir數(shù)據(jù)考慮降低epcf客戶端的開發(fā)和維護成本，EIR信息查詢打印頁面采用通用頁面，通用頁面涵蓋所有船公司所需的信息。不同船公司顯示差異表如下OOCLMSK（上海）MSK（寧波）ZIM（上海）ZIM（青島）HJSSTXPILNYKMOL提單號1111111111進港代碼1碼頭預(yù)約號1111合同號11111111箱子頭1111111箱標識11111111套用箱原訂艙號1船名航次1111中轉(zhuǎn)港111111實際船名1實際航次1目的港1ZIM放箱要求1船公司logo1111111111船公司1111111111車隊備注1訂艙確認時間1備注1注：1顯示2可編輯Eir信息修改在查出而后用戶可以修改或補錄，箱號、車牌號、箱封號、是否外堆場提箱等信息。如圖紅色編輯區(qū)。不同船公司箱信息顯示差異表如下OOCLMSK（上海）MSK（寧波）ZIM（上海）ZIM（青島）HJSSTXPILNYKMOL箱型1111111111提箱地點1111111111狀態(tài)1111111111箱號2222222222封號222222222車牌號2222222222設(shè)備交接單號22外堆場提箱2高代平2減免沒用/原因2備注1其他1打印eir時間1注：1顯示2可編輯Eir打印在用戶填寫完整eir信息后，用戶可以打印eir。每個船公司eir都有自己的格式，所以我們?yōu)槊考夜局贫ú煌哪０?，打印時選擇不同的模板打印。打印樣張如下：操作日志查詢用戶可以查詢在客戶端所有操作日志。例如修改信息和打印日志。數(shù)據(jù)同步客戶端模塊結(jié)構(gòu)圖模塊功能說明 這是個后臺同步程序，是部署在用戶端服務(wù)器上，7X24小時不間斷從億通平臺同步可打印eir數(shù)據(jù)并同時將用戶端的打印的數(shù)據(jù)上傳到平臺。 同步服務(wù)提供系統(tǒng)配置功能，設(shè)置FTP賬號、FTP用戶名及密碼、FTP下載目錄、FTP回傳目錄、自動收取的時間間隔、回傳時間間隔； 設(shè)置規(guī)則：以orgCode分類開設(shè)目錄，并分配用戶密碼，打印終端通過orgCode和分配的用戶密碼收取服務(wù)器對應(yīng)的目錄報文。（注：以orgCode為用戶名好處是可以根據(jù)orgCode來控制打印點獲取報文權(quán)限）向下同步數(shù)據(jù)應(yīng)急系統(tǒng)客戶端，采用登錄用戶的orgCode和ftp密碼，定時通過FTP方式，到指定的ftp目錄（以orgCode分類開設(shè)目錄）收取，屬于自己堆場或打印點的報文，解析入庫。向上同步數(shù)據(jù)當網(wǎng)絡(luò)恢復(fù)，F(xiàn)TP能連接上平臺ftp服務(wù)器，就開始回傳用戶打印和修改的eir數(shù)據(jù)。采集本地需要向上同步的已打印eir數(shù)據(jù)（data_status=未上傳，ctn_status=已打印）生成回傳報文報文標準采用json，格式見EIR_EMERGENCY表結(jié)構(gòu)將本地數(shù)據(jù)狀態(tài)設(shè)置成已同步工作量估算具體工作量有待客戶端的功能范圍劃定后才能估算。但總體來說工作量會比較大。只要原因為：由于客戶端數(shù)據(jù)不全等限制，客戶端系統(tǒng)的需求和目前正式使用的系統(tǒng)的需求會有很大不同，需要分船公司重新梳理定義。不同船公司由于控制邏輯不同、打印格式不同等，均需要進行不同的開發(fā)。系統(tǒng)分兩階段進行，第一階段完成上海10家船公司出口業(yè)務(wù)的應(yīng)急，工作量如下：序號項目數(shù)量(人月)1EIR平臺端服務(wù)改造32應(yīng)急系統(tǒng)平臺端73應(yīng)急系統(tǒng)客戶端EPCF64數(shù)據(jù)同步客戶端1總計17第二階段：完成上海進口、退關(guān)改配業(yè)務(wù)的應(yīng)急及外地業(yè)務(wù)的應(yīng)急系統(tǒng)，工作量估算如下：序號項目數(shù)量(人月)1EIR平臺端服務(wù)改造62應(yīng)急系統(tǒng)平臺端33應(yīng)急系統(tǒng)客戶端EPCF84數(shù)據(jù)同步客戶端1總計18數(shù)據(jù)管理方案業(yè)務(wù)數(shù)據(jù)來源Eir系統(tǒng)數(shù)據(jù)項機構(gòu)基本信息表名EIR_EMERGENCY列名數(shù)據(jù)類型描述空/非空約束條件idNUMBER(18)idY系統(tǒng)自動生成的唯一ID,PKLocationVarchar2(500)船公司代碼YYard_codeVarchar2(500)堆場代碼YOrg_codeVarchar2(500)組織機構(gòu)代碼Y多個打印點逗號隔開barcodeVarchar2(500)barcodeYEir_dataVarchar2(4000)Eirjson串YData_statusVarchar2(500)數(shù)據(jù)狀態(tài)Y1新數(shù)據(jù)2已上傳3數(shù)據(jù)沖突Ctn_statusVarchar2(500)箱狀態(tài)Y1未打印2已打印3撤銷conflictVarchar2(500)沖突原因RemarkVarchar2(500)RemarkC1Varchar2(500)C1擴展字段C2Varchar2(500)C2擴展字段C3Varchar2(500)C3擴展字段update_timeDATE最后更新時間create_timeDATE創(chuàng)建時間表名EIR_LOG列名數(shù)據(jù)類型描述空/非空約束條件idNUMBER(18)idY系統(tǒng)自動生成的唯一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修改數(shù)據(jù)3平臺撤銷RemarkVarchar2(500)Remarkcreate_timeDATE創(chuàng)建時間eirJSON串數(shù)據(jù)項名稱代碼描述箱IDctnId箱表中ID條形碼barcode取自MSKEIR_BIZ_CTNR表barcode字段船公司代碼businessType提單表中的LOCATION船公司中文名稱shipper根據(jù)LOCATION和dataType='MSKEIR_SHIP_INFO'查詢表MskeirCodMapping，如果CodeName非空，則返回，如果CodeName為空，則以LOCATION作為船公司中文名稱經(jīng)辦日期dateOOCL,CMA,MOL:無；STX:當前數(shù)據(jù)庫時間，格式：yyyy-MM-dd用箱人/運箱人containerUserOOCL，CMA，STX：根據(jù)‘a(chǎn)pply.applicant_code+MSKEIR_TRANSCARRIER+港口代碼’匹配代碼映射表code+data_type+location，從而獲取code_name；匹配不到則取apply.applicant_codeMOL：根據(jù)箱表中的PRINT_NOTICE_ORG和DATA_TYPE=MSKEIR_TRANSCARRIER查詢MSKEIR_COD_MAPPING表，返回對應(yīng)的CODE_NAME字段值提箱地點yardNameOOCL：打印堆場的中文名稱。如果提箱地點不為外堆場（ctnr.cy_code≠WDC），則根據(jù)‘ctnr.cy_code+MSKEIR_DEPOT_INFO+港口代碼’匹配代碼映射表的code+data_type+location，從而獲取code_name;如果提箱地點為外堆場（ctnr.cy_code＝WDC），則根據(jù)ctnr.specyard_id關(guān)聯(lián)到MSKEIR_COD_SPEC_YARD表，從而獲取外堆場名稱（wdc_name），匹配不到，則固定打印‘外堆場’CMA，STX：ctnr表cy_code對應(yīng)的中文和地址MOL：如果是SOC（c.soc_tag=’Y’），則返回為空；否則根據(jù)箱表的CY_CODE和DATA_TYPE=MSEIR_DEPOT_INFO查詢MSKEIR_COD_MAPPING表，取CODE_NAME字段船名vesselOOCL,CMA,STX:BILL中vesselMOL:根據(jù)BILL表中的VESSEL、VOYAGE、LOCATION到LBS系統(tǒng)獲取對應(yīng)的船名，若有能成功返回，則取LBS返回的船名，如果沒有成功返回，取BILL表中的VESSEL航次voyageOOCL,CMA,STX:BILL中VOYAGEMOL:根據(jù)BILL表中的VESSEL、VOYAGE、LOCATION到LBS系統(tǒng)獲取對應(yīng)的船名，若有能成功返回，則取LBS返回的航次;如果沒有成功返回，取BILL表中的VOYAGE提單號bookingNoOOCL,CMA,STX:BILL中bookingNoMOL:MOLU+BOOKING_NO集裝箱經(jīng)營人ctnOprCodeOOCL：根據(jù)箱表MSKEIR_BIZ_CTNR的soc_tag字段判斷如果soc_tag=’Y’，則固定打印‘SOC’；如果soc_tag=’N’，則固定打印‘OOCL’CMA，STX：根據(jù)箱表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（在尺寸/箱型欄打?。㎝OL：根據(jù)箱表的CTN_TYPE和DATA_TYPE=MSKEIR_CTNTYPE、LOCATION=MOL查詢MSKEIR_COD_MAPPING表，獲取CODE_DESC字段值，若匹配不上則返回空；類型type空狀態(tài)status無；運載工具牌號，車牌號plateNoOOCL，MOL：取自MSKEIR_BIZ_CTNR表plate_noCMA，STX：無發(fā)往地點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：根據(jù)BILL表中的IN_HARBOUR_CODE、LOCATION、DATA_TYPE=MOLEIR_IN_HARBOUR_CODE查詢MSKEIR_COD_MAPPING表獲取CODE_NAME字段值；免費使用期限freeTimePeriodOOCL：無CMA，STX：打印日期~打印日期+箱型對應(yīng)免費日期(無對應(yīng)免費日期箱子只顯示’~’)，格式舉例:2011-12-07~2011-12-17MOL：開始時間為系統(tǒng)當前時間若箱表中的HAND_TYPE含有REEF，則結(jié)束時間為開始時間+4天；否則以開始時間+6天計算；格試：yyyy-MM-dd~yyyy-mm-dd進出場日期timeInOutOOCL：無CMA，MOL:出場日期：系統(tǒng)當前日期（MM月dd日HH時）STX：空備注：remarkOOCL:合同號:先從ctnr.contract_no字段獲??；如果為空，再根據(jù)ctnr.specyard_id獲取特種箱堆場分配規(guī)則表MSKEIR_COD_SPEC_YARD表的contract_no字段；如果匹配不到，則此項不打印箱字頭:根據(jù)ctnr.specyard_id獲取特種箱堆場分配規(guī)則表MSKEIR_COD_SPEC_YARD表的ctn_prefix