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

箱管業(yè)務應急處理系統(tǒng)版本：<1.0>建設方案日期：<2015/02>機密億通國際,DATE\@"yyyy"2015頁碼）技術路線采用目前億通使用成熟技術，系統(tǒng)將基于J2EE規(guī)范，采用B/S與C/S混合模式進行開發(fā)，其中C/S模式主要應用于堆場打印操作界面采用億通成熟的C/S框架（EPCF）。平臺端采用B/S模式提供接口，采用億通成熟的easyweb框架。圖表STYLEREF2\s4.1SEQ圖表\*ARABIC\s21體系結構如圖所示，J2EE是多層的分布式體系結構，使系統(tǒng)的操作和運行具有很好的靈活性。先進的Java計算方案如面向對象、獨立于平臺、快速集成、代碼重用以及豐富的界面開發(fā)API等，是實現這種結構的關鍵，并使系統(tǒng)具有良好的可移植性和可擴展性。（1）使用Tag、POJO（Java對象），和EJB等技術使得系統(tǒng)容易集成和具有最大的生產能力。在開發(fā)、發(fā)布、管理和重用應用邏輯等方面具有很大的靈活性。（2）基于工業(yè)標準保證數據交換的一致性和安全的網絡架構，可以在應用和平臺上達到高效的集成。因此，這種開放式結構特別適合于開發(fā)面向Web以及富客戶端的應用系統(tǒng)。（3）豐富的基于Java技術的行業(yè)標準框架（Struts、Spring、Hibernate等），為提高系統(tǒng)的開發(fā)效率和開發(fā)質量提供了有效的保障。方案建設問題客戶端應急方案雖然能不受網絡、平臺等各種故障限制，最大程度的保證打印EIR功能的可用性，但這種方案也存在很大的局限性，具體如下：由于該客戶端與平臺端有數據的雙向交互，系統(tǒng)實現比較復雜； 數據同步客戶端堆場后，無法有效控制用戶，存在不應急的情況也使用客戶端打印、數據被篡改等，然后將錯誤的數據上傳到平臺上，干擾平臺正常的業(yè)務數據，影響平臺后續(xù)業(yè)務出現混亂和不準確等一系列問題；船公司在打印EIR時會進行很多的校驗，比如MSK存在13項校驗、PIL存在11項校驗，客戶端由于數據不完整，無法進行如此全面的校驗，需要重新梳理需求并得到船公司認可；船公司在打印EIR時，需要根據數據庫中設置的規(guī)則打印箱標識等數據，這些數據在用戶申請小票之后到打印EIR前可能會發(fā)生變化，由于客戶端系統(tǒng)無法獲取全部基礎數據，數據也無法做到實時，可能會引發(fā)放箱問題；補充數據回傳時，如果客戶端的狀態(tài)和平臺端的狀態(tài)不一致，如何處理；比如客戶端已經打印EIR，但是平臺端已經取消了小票等情況；計費信息回傳：由于客戶端數據不完整，部分船公司復雜的計費邏輯在堆場客戶端系統(tǒng)將無法實現。運維工作問題：初裝及后期的不定期系統(tǒng)強制更新；數據同步的異常情況跟蹤及處理問題等均需要運維力量的投入。應用系統(tǒng)設計功能模塊框架圖表6.4-11功能模塊框架圖應急系統(tǒng)是一個涉及平臺端,客戶端，數據傳輸，用戶管理等綜合業(yè)務系統(tǒng)，它不僅要服務于各類使用用戶，同時也需要與各類內外部信息系統(tǒng)進行互聯(lián)和數據交換。根據應急業(yè)務需求，目標系統(tǒng)被分為3個業(yè)務模塊，業(yè)務模塊主要包括應急系統(tǒng)平臺端，應急系統(tǒng)客戶端EPCF，數據同步客戶端。模塊功能描述應急系統(tǒng)平臺端模塊結構圖功能說明對系統(tǒng)中的平臺端應急信息進行采集，管理和維護。應急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到指定目錄同步屬于自己的數據。同時實現本地業(yè)務數據更新。向上同步：所有客戶端將向上同步的數據上傳到唯一指定的目錄，由平臺端入庫程序掃描入庫，并同時抄送各個eir應用。應急Eir數據管理應急eir數據查詢輸入barcode和相關狀態(tài)查詢此eir數據人工干預用戶根據系統(tǒng)羅列客戶端數據和平臺端數據出現沖突，決定是否收費等后續(xù)業(yè)務和出具報表。數據采集實現由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則為組織機構代碼第三步：獲取業(yè)務數據（調用標準eir接口/eirMobileComnInterface.do/searchYardPrintEir.do參數為第一步和第二步的barcode和orgCode）。第四步：將獲取的json數據和location，yardCode，orgCode（多個用逗號分開）入數據采集表，同時生成小票報文，存放對應的orgCode的ftp目錄。現有系統(tǒng)的改造EIR2MA_TICKET數據入庫端，新增報文生成功能，將打印申請單和修改申請單的數據生成報文，供平臺端采集程序輪詢現有標準eir接口有通過登錄用戶orgcode校驗打印點及提箱地點正確性，針對數據采集接口不這個驗證。各個eir應用端新增報文入庫功能。應急系統(tǒng)客戶端EPCF模塊結構圖功能說明考慮到目前eir打印都具有共性，當前設計成統(tǒng)一打印界面。Eir信息查詢輸入barcode查詢此eir數據考慮降低epcf客戶端的開發(fā)和維護成本，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信息修改在查出而后用戶可以修改或補錄，箱號、車牌號、箱封號、是否外堆場提箱等信息。如圖紅色編輯區(qū)。不同船公司箱信息顯示差異表如下OOCLMSK（上海）MSK（寧波）ZIM（上海）ZIM（青島）HJSSTXPILNYKMOL箱型1111111111提箱地點1111111111狀態(tài)1111111111箱號2222222222封號222222222車牌號2222222222設備交接單號22外堆場提箱2高代平2減免沒用/原因2備注1其他1打印eir時間1注：1顯示2可編輯Eir打印在用戶填寫完整eir信息后，用戶可以打印eir。每個船公司eir都有自己的格式，所以我們?yōu)槊考夜局贫ú煌哪０?，打印時選擇不同的模板打印。打印樣張如下：操作日志查詢用戶可以查詢在客戶端所有操作日志。例如修改信息和打印日志。數據同步客戶端模塊結構圖模塊功能說明 這是個后臺同步程序，是部署在用戶端服務器上，7X24小時不間斷從億通平臺同步可打印eir數據并同時將用戶端的打印的數據上傳到平臺。 同步服務提供系統(tǒng)配置功能，設置FTP賬號、FTP用戶名及密碼、FTP下載目錄、FTP回傳目錄、自動收取的時間間隔、回傳時間間隔； 設置規(guī)則：以orgCode分類開設目錄，并分配用戶密碼，打印終端通過orgCode和分配的用戶密碼收取服務器對應的目錄報文。（注：以orgCode為用戶名好處是可以根據orgCode來控制打印點獲取報文權限）向下同步數據應急系統(tǒng)客戶端，采用登錄用戶的orgCode和ftp密碼，定時通過FTP方式，到指定的ftp目錄（以orgCode分類開設目錄）收取，屬于自己堆場或打印點的報文，解析入庫。向上同步數據當網絡恢復，FTP能連接上平臺ftp服務器，就開始回傳用戶打印和修改的eir數據。采集本地需要向上同步的已打印eir數據（data_status=未上傳，ctn_status=已打印）生成回傳報文報文標準采用json，格式見EIR_EMERGENCY表結構將本地數據狀態(tài)設置成已同步工作量估算具體工作量有待客戶端的功能范圍劃定后才能估算。但總體來說工作量會比較大。只要原因為：由于客戶端數據不全等限制，客戶端系統(tǒng)的需求和目前正式使用的系統(tǒng)的需求會有很大不同，需要分船公司重新梳理定義。不同船公司由于控制邏輯不同、打印格式不同等，均需要進行不同的開發(fā)。系統(tǒng)分兩階段進行，第一階段完成上海10家船公司出口業(yè)務的應急，工作量如下：序號項目數量(人月)1EIR平臺端服務改造32應急系統(tǒng)平臺端73應急系統(tǒng)客戶端EPCF64數據同步客戶端1總計17第二階段：完成上海進口、退關改配業(yè)務的應急及外地業(yè)務的應急系統(tǒng)，工作量估算如下：序號項目數量(人月)1EIR平臺端服務改造62應急系統(tǒng)平臺端33應急系統(tǒng)客戶端EPCF84數據同步客戶端1總計18數據管理方案業(yè)務數據來源Eir系統(tǒng)數據項機構基本信息表名EIR_EMERGENCY列名數據類型描述空/非空約束條件idNUMBER(18)idY系統(tǒng)自動生成的唯一ID,PKLocationVarchar2(500)船公司代碼YYard_codeVarchar2(500)堆場代碼YOrg_codeVarchar2(500)組織機構代碼Y多個打印點逗號隔開barcodeVarchar2(500)barcodeYEir_dataVarchar2(4000)Eirjson串YData_statusVarchar2(500)數據狀態(tài)Y1新數據2已上傳3數據沖突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列名數據類型描述空/非空約束條件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修改數據3平臺撤銷RemarkVarchar2(500)Remarkcreate_timeDATE創(chuàng)建時間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關聯(lián)到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系統(tǒng)獲取對應的船名，若有能成功返回，則取LBS返回的船名，如果沒有成功返回，取BILL表中的VESSEL航次voyageOOCL,CMA,STX:BILL中VOYAGEMOL:根據BILL表中的VESSEL、VOYAGE、LOCATION到LBS系統(tǒng)獲取對應的船名，若有能成功返回，則取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（在尺寸/箱型欄打?。㎝OL：根據箱表的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：根據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：開始時間為系統(tǒng)當前時間若箱表中的HAND_TYPE含有REEF，則結束時間為開始時間+4天；否則以開始時間+6天計算；格試：yyyy-MM-dd~yyyy-mm-dd進出場日期timeInOutOOCL：無CMA，MOL:出場日期：系統(tǒng)當前日期（MM月dd日HH時）STX：空備注：remarkOOCL:合同號:先從ctnr.contract_no字段獲??；如果為空，再根據ctnr.specyard_id獲取特種箱堆場分配規(guī)則表MSKEIR_COD_SPEC_YARD表的contract_no字段；如果匹配不到，則此項不打印箱字頭:根據ctnr.specyard_id獲取特種箱堆場分配規(guī)則表MSKEIR_COD_SPEC_YARD表的ctn_prefix