附件2跨境電子商務進口統(tǒng)一版信息化系統(tǒng)

客戶端軟件使用手冊目錄TOC\o"1-5"\h\z1文檔概述41.1編寫目的41.2用戶對象41.3系統(tǒng)概述41.4術(shù)語定義42運行環(huán)境53軟件安裝說明5.Windows下安裝53.1.1基礎(chǔ)安裝53.1.1.1解壓客戶端壓縮包53.1.1.2啟動客戶端63.1.2注冊服務6Linux下安裝73.2.1基礎(chǔ)安裝73.2.1.1解壓客戶端壓縮包73.2.1.2啟動客戶端73.2.2注冊服務74企業(yè)接入準備8.5系統(tǒng)登錄指南8.6系統(tǒng)操作指南8.6.1系統(tǒng)監(jiān)控86.2配置管理9基本信息管理9企業(yè)對接配置9連接協(xié)議配置10傳輸安全配置106.2.2對接配置管理11數(shù)據(jù)導入服務126.3運維管理13數(shù)據(jù)落地管理13報文異常管理13報文阻塞管理147運行與維護147.1日常維護14常見問題處理15文檔概述編寫目的主要為跨境電商相關(guān)企業(yè)提供跨境電子商務進口統(tǒng)一版信息化系統(tǒng)客戶端軟件（以下簡稱客戶端軟件）正確的安裝說明以及系統(tǒng)操作說明。用戶對象跨境電商相關(guān)企業(yè)用戶，如電商平臺、電商企業(yè)、物流企業(yè)、支付企業(yè)、倉儲企業(yè)、報關(guān)企業(yè)等。系統(tǒng)概述客戶端軟件輔助跨境電商相關(guān)企業(yè)按照《跨境電子商務進口統(tǒng)一版信息化系統(tǒng)企業(yè)對接報文規(guī)范（試行）》與跨境電子商務進口統(tǒng)一版信息化系統(tǒng)進行數(shù)據(jù)傳輸，實現(xiàn)訂單、運單、支付單、清單等單證信息自動化處理或通過EXCEL格式文件半自動化處理?？蛻舳丝稍谄髽I(yè)授權(quán)的情況下進行報文的加簽自動化處理。并提供數(shù)據(jù)發(fā)送和接收查詢功能。術(shù)語定義序號縮略語名稱術(shù)語全稱定義說明1應用傳輸協(xié)議應用傳輸協(xié)議(CommunicationsProtocol)是指計算機通信的共冋語言。本文中泛指AS2（上行）+AS3（下行），IBMMQ,ToprowMQ（華盛信泰消息中間件），RabbitMQ多種方式傳輸協(xié)議的統(tǒng)稱。2數(shù)據(jù)傳輸報文數(shù)據(jù)傳輸報文數(shù)據(jù)傳輸是指在數(shù)據(jù)源和數(shù)據(jù)宿之間傳輸數(shù)據(jù)的過程，也稱數(shù)據(jù)通信。數(shù)據(jù)是指能夠由計算機處理的數(shù)字、字母和符號等，它是信息的一種載體，數(shù)據(jù)是信

息傳輸?shù)囊环N形式，主要指與計算機有關(guān)的信息傳輸。數(shù)據(jù)傳輸報文在本文是指用于存放數(shù)據(jù)傳輸數(shù)據(jù)的載體文件的泛稱。3數(shù)據(jù)格式數(shù)據(jù)格式本文指數(shù)據(jù)傳輸報文的文件類型，主要指XML、EXCEL等數(shù)據(jù)格式。4數(shù)據(jù)格式轉(zhuǎn)換數(shù)據(jù)格式轉(zhuǎn)換從一種數(shù)據(jù)格式轉(zhuǎn)換成另外一種數(shù)據(jù)格式的過程。5節(jié)點節(jié)點在網(wǎng)絡拓撲中，網(wǎng)絡任何支路的終端或網(wǎng)絡中兩個或更多支中的互連公共點。運行環(huán)境類別最低配置推薦配置應用服務器CPU2.0GHZ*4核3.0GHZ*8核內(nèi)存4G以上8G以上硬盤500G500G以上RAID其他百兆帶寬百兆帶寬以上軟件操作系統(tǒng)Linux/Unix/Windowsserver2003及以上版本軟件安裝說明Windows下安裝基礎(chǔ)安裝解壓客戶端壓縮包將跨境電子商務進口統(tǒng)一版信息化系統(tǒng)客戶端軟件安裝壓縮包：“WINDOWS_IMPORTS_CLIENT_V1.0.0.zip”解壓至跨境電商相關(guān)企業(yè)服務器的某硬盤路徑下，具體路徑跨境電商相關(guān)企業(yè)可自行定義，例如：C:\Data。如下圖所示：啟動客戶端進入Client目錄，執(zhí)行startup.bat文件，如下圖所示：2、系統(tǒng)自動在~/Client/Config/ASEUser.xml文件中生成授權(quán)申請碼，授權(quán)碼位于ASEUser.xml文件＜applyCode＞節(jié)點中，如下圖所示：3、跨境電商相關(guān)企業(yè)【郵箱地址】（郵箱地址），郵件主題為XXX企業(yè)客戶端授權(quán)申請，郵件正文錄入格式如下圖所示：郵件內(nèi)容審核通過后管理員將ASE_License.ase（授權(quán)文件）發(fā)送給跨境電商相關(guān)企業(yè)，跨境電商相關(guān)企業(yè)收到ASE_License.ase（授權(quán)文件）文件后，將該文件放置在Client所在根目錄下，系統(tǒng)自動進行授權(quán)認證并完成程序啟動。如下圖所示：注冊服務以管理員方式運行installService.bat文件。如下圖所示：Linux下安裝基礎(chǔ)安裝解壓客戶端壓縮包將客戶端軟件安裝壓縮包“LINUX_IMPORTS_CLIENT_Vl.O.O.zip”解壓至用戶自身home目錄路徑下，例如：#tarzxvf/LINUX_IMPORTS_CLIENT_V1.0.0.zip-C~/Data啟動客戶端進入Client目錄下，執(zhí)行startup.sh文件，如下圖所示：2、系統(tǒng)自動在~/Client/Config/ASEUser.xml文件中生成授權(quán)申請碼，授權(quán)碼位于ASEUser.xml文件＜applyCode＞節(jié)點中，如下圖所示：3、跨境電商相關(guān)企業(yè)【郵箱地址】（郵箱地址），郵件主題為XXX企業(yè)客戶端授權(quán)申請，郵件正文錄入格式如下圖所示：審核通過后，管理員將ASE_License.ase（授權(quán)文件）發(fā)送給跨境電商相關(guān)企業(yè)，跨境電商相關(guān)企業(yè)收到ASE_License.ase（授權(quán)文件）文件后，將該文件放置在Client目錄下，系統(tǒng)自動進行授權(quán)認證并完成程序啟動。如下圖所示：注冊服務以管理員方式運行registInstall.sh文件，進行注冊服務。企業(yè)接入準備企業(yè)傳輸編號（DXPID）向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請傳輸協(xié)議配置信息企業(yè)根據(jù)自身業(yè)務量情況向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請適合的接入配置（MQ或AS2/AS3相關(guān)配置信息）IC卡或Ukey申請向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請一、功能介紹用戶在使用系統(tǒng)前需要先登錄系統(tǒng)。二、操作流程1、在瀏覽器（Chrome或Firefox）中輸入系統(tǒng)地址【網(wǎng)址】，輸入正確密碼（默認密碼88888888），點擊登錄進入系統(tǒng)登錄頁面系統(tǒng)監(jiān)控一、功能介紹跨境電商相關(guān)企業(yè)在系統(tǒng)監(jiān)控查看到當前接收數(shù)據(jù)數(shù)量、發(fā)送數(shù)據(jù)數(shù)量、接收數(shù)據(jù)容量、發(fā)送數(shù)據(jù)容量、當前數(shù)據(jù)監(jiān)控、流量監(jiān)控以及系統(tǒng)監(jiān)控。二、操作流程1、用戶在主菜單欄中選擇系統(tǒng)監(jiān)控即可進入系統(tǒng)監(jiān)控界面,如下圖所示:配置管理基本信息管理一、功能介紹基本信息管理包括企業(yè)對接配置、連接協(xié)議配置、傳輸安全配置三個模塊。為跨境電商相關(guān)企業(yè)提供錄入對接配置基本信息、連接配置協(xié)議信息以及傳輸安全配置信息。二、操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，如下圖所示：企業(yè)對接配置一、功能介紹跨境電商相關(guān)企業(yè)能夠進行對接配置基本信息錄入，可進行高級選項錄入包括傳輸接收編號、報文發(fā)送路徑、報文接收路徑、異?；貓?zhí)路徑等內(nèi)容。二、操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面錄入跨境電商相關(guān)企業(yè)對接配置信息，如下圖所示：2、跨境電商相關(guān)企業(yè)錄入完成跨境電商相關(guān)企業(yè)對接配置信息后，點擊高級按鈕進行信息錄入,如下圖所示：連接協(xié)議配置一、功能介紹連接協(xié)議配置包括RabbitMQ協(xié)議配置、IBMMQ或ToprowMQ協(xié)議配置和AS2/AS3等協(xié)議配置模塊，企業(yè)用戶根據(jù)需要自行選擇要使用的協(xié)議進行配置。二、操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的連接協(xié)議配置進行配置，如下圖所示：＞RabbitMQ協(xié)議配置（推薦量級：＞5000票/天；＞100票/分；＜4096KB/票）＞IBMMQ或ToprowMQ協(xié)議配置（推薦量級：＞5000票/天；＞100票/分；＜4096KB/票）＞AS2/AS3協(xié)議配置（推薦量級：＜5000票/天；＜100票/分；＜1024KB/票）傳輸安全配置功能介紹功能介紹一、功能介紹傳輸安全配置用于IC卡/USBKEY設備的配置，用戶需同意并授權(quán)客戶端使用安全設備服務后才可以進行加簽操作。二、操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的安全配置進行配置，如下圖所示：IC卡/USBKey安全配置1、用戶在錄入完UKEY密碼后，在選擇加簽選項時（加業(yè)務簽、加傳輸簽），系統(tǒng)會提示用戶是否同意授權(quán)客戶端使用安全設備服務，用戶點擊同意按鈕，客戶端進行加簽處理，用戶點擊取消按鈕，客戶端取消當前加簽操作。如下圖所示。2、跨境電商相關(guān)企業(yè)錄入完成全部基本信息后，點擊右下角保存按鈕，系統(tǒng)將保存已填寫好的基本信息。對接配置管理用于跨境電商相關(guān)企業(yè)當前已配置資源查詢并可啟動或停止當前監(jiān)聽資源。二、操作流程1、用戶在主菜單欄中選擇配置管理下的對接配置管理，即可進入對接配置管理界面，系統(tǒng)根據(jù)查詢條件顯示監(jiān)聽資源配置信息，如下圖所示:2、用戶能夠選擇具體資源配置信息，點擊啟動按鈕，啟動當前配置資源,或點擊全部開始按鈕，全部啟動當前配置資源。3、用戶能夠選擇具體資源配置信息，點擊停止按鈕，停止當前配置資源,或點擊全部停止按鈕，全部停止當前配置資源數(shù)據(jù)導入服務一、功能介紹將跨境電商相關(guān)企業(yè)需發(fā)送的EXCLE文件轉(zhuǎn)換成業(yè)務報文進行傳輸,同時提供EXCLE模板下載。二、操作流程1、用戶在主菜單欄中選擇配置管理下的數(shù)據(jù)導入服務,即可進入數(shù)據(jù)導入服務界面，如下圖所示：2、在數(shù)據(jù)導入服務界面選擇下載EXCLE模板，將EXCLE模板下載至本地。3、用戶將EXCLE模板進行解壓操作，如下圖所示：4、用戶填寫完成EXCLE文件，點擊上傳按鈕，將填寫完成的EXCLE文件上傳至系統(tǒng)。用戶上傳完成EXCLE文件，系統(tǒng)將跨境電商相關(guān)企業(yè)上傳的EXCLE文件轉(zhuǎn)換成XML文件進行傳輸。如下圖所示：運維管理數(shù)據(jù)落地管理一、功能介紹在數(shù)據(jù)落地查詢模塊下，能對落地數(shù)據(jù)進行查詢操作。企業(yè)可以根據(jù)發(fā)送時間，接收時間，報文編號，報文名稱等條件，清晰查看到系統(tǒng)傳輸報文。并能對正?；虍惓?shù)據(jù)報文進行重發(fā)操作。二、操作流程1、用戶在主菜單欄中選擇運維管理下的數(shù)據(jù)落地管理，即可進入數(shù)據(jù)落地管理界面，如下圖所示：2、用戶可選擇正?；虍惓?shù)據(jù)報文點擊重發(fā)按鈕進行重發(fā)操作報文異常管理系統(tǒng)異常管理分為系統(tǒng)異常和阻塞異常，系統(tǒng)管理員可以根據(jù)異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當前系統(tǒng)出現(xiàn)的問題的原因。二、操作流程1、用戶在主菜單欄中選擇運維管理下的報文異常管理，即可進入報文異常管理界面，如下圖所示：報文阻塞管理一、功能介紹系統(tǒng)異常管理分為系統(tǒng)異常和阻塞異常，系統(tǒng)管理員可以根據(jù)異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當前系統(tǒng)出現(xiàn)的問題的原因。二、操作流程1、用戶在主菜單欄中選擇運維管理下的報文阻塞管理，即可進入報文阻塞管理界面，如下圖所示：運行與維護日常維護工作范圍：1、網(wǎng)絡維護檢查客戶端軟件的各個組成部分的網(wǎng)絡狀況，保證網(wǎng)絡的連接正常，網(wǎng)卡的使用正常。2、設備維護硬件維護：保證客戶端軟件使用的服務器的硬件環(huán)境運轉(zhuǎn)正常。軟件維護：保證操作系統(tǒng)，運行軟件（IBMMQ或ToprowMQ）及其他附屬軟件的運行正常。檢查個服務器軟件所需硬盤余量，監(jiān)控磁盤空間，數(shù)據(jù)庫空間，inode空間等。3、客戶端維護確保跨境電子商務進口統(tǒng)一版信息化系統(tǒng)客戶端軟件正常運轉(zhuǎn)。常見問題處理針對常見問題列出了如下處理方式：事件預防措施處理客戶端操作系統(tǒng)斷電安裝UPS接電后系統(tǒng)支持自動重新啟動功能，如果未啟動可以人工快速介入啟動相關(guān)系統(tǒng)，并且系統(tǒng)擁有重發(fā)機制，可以重發(fā)由于斷電等災難引起的未處理報文。系統(tǒng)日志中發(fā)現(xiàn)IC卡/USBKEY相關(guān)錯誤保證IC卡/USBK