跨境電子商務(wù)進口統(tǒng)一版信息化系統(tǒng)客戶端軟件使用手冊

1、附件2跨境電子商務(wù)進口統(tǒng)一版信息化系統(tǒng)客戶端軟件使用手冊目錄1文檔概述41.1編寫目的41.2用戶對象41.3系統(tǒng)概述41.4術(shù)語定義42運行環(huán)境53軟件安裝說明53.1Windows下安裝53.1.1基礎(chǔ)安裝解壓客戶端壓縮包啟動客戶端63.1.2注冊服務(wù)73.2Linux下安裝83.2.1基礎(chǔ)安裝解壓客戶端壓縮包啟動客戶端83.2.2注冊服務(wù)104企業(yè)接入準(zhǔn)備105系統(tǒng)登錄指南106系統(tǒng)操作指南116.1系統(tǒng)監(jiān)控116.2配置管理126.2.1基本信息管理企業(yè)對接配置連接協(xié)議配置146.2.1

2、.3傳輸安全配置166.2.2對接配置管理186.2.3數(shù)據(jù)導(dǎo)入服務(wù)186.3運維管理206.3.1數(shù)據(jù)落地管理206.3.2報文異常管理216.3.3報文阻塞管理227運行與維護237.1日常維護237.2常見問題處理231 文檔概述1.1 編寫目的主要為跨境電商相關(guān)企業(yè)提供跨境電子商務(wù)進口統(tǒng)一版信息化系統(tǒng)客戶端軟件（以下簡稱客戶端軟件）正確的安裝說明以及系統(tǒng)操作說明。 1.2 用戶對象跨境電商相關(guān)企業(yè)用戶，如電商平臺、電商企業(yè)、物流企業(yè)、支付企業(yè)、倉儲企業(yè)、報關(guān)企業(yè)等。1.3 系統(tǒng)概述客戶端軟件輔助跨境電商相關(guān)企業(yè)按照跨境電子商務(wù)進口統(tǒng)一版信息化系統(tǒng)企業(yè)對接報文規(guī)范（試行）與跨境電子商務(wù)進

3、口統(tǒng)一版信息化系統(tǒng)進行數(shù)據(jù)傳輸，實現(xiàn)訂單、運單、支付單、清單等單證信息自動化處理或通過EXCEL格式文件半自動化處理?？蛻舳丝稍谄髽I(yè)授權(quán)的情況下進行報文的加簽自動化處理。并提供數(shù)據(jù)發(fā)送和接收查詢功能。1.4 術(shù)語定義序號縮略語名稱術(shù)語全稱定義說明1應(yīng)用傳輸協(xié)議應(yīng)用傳輸協(xié)議（Communications Protocol）是指計算機通信的共同語言。本文中泛指AS2（上行）+AS3（下行），IBMMQ，Toprow MQ(華盛信泰消息中間件)，RabbitMQ多種方式傳輸協(xié)議的統(tǒng)稱。2數(shù)據(jù)傳輸報文數(shù)據(jù)傳輸報文數(shù)據(jù)傳輸是指在數(shù)據(jù)源和數(shù)據(jù)宿之間傳輸數(shù)據(jù)的過程，也稱數(shù)據(jù)通信。數(shù)據(jù)是指能夠由計算機處理的數(shù)

4、字、字母和符號等，它是信息的一種載體，數(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)絡(luò)拓撲中，網(wǎng)絡(luò)任何支路的終端或網(wǎng)絡(luò)中兩個或更多支中的互連公共點。2 運行環(huán)境類別最低配置推薦配置應(yīng)用服務(wù)器CPU2.0GHZ*4核3.0GHZ *8核內(nèi)存4G以上8G以上硬盤500G500G以上RAID其他百兆帶寬百兆帶寬以上軟件操作系統(tǒng)Linux/Unix/Windows s

5、erver2003及以上版本3 軟件安裝說明3.1 Windows下安裝3.1.1 基礎(chǔ)安裝 解壓客戶端壓縮包將跨境電子商務(wù)進口統(tǒng)一版信息化系統(tǒng)客戶端軟件安裝壓縮包：“WINDOWS_IMPORTS_CLIENT_V1.0.0.zip”解壓至跨境電商相關(guān)企業(yè)服務(wù)器的某硬盤路徑下，具體路徑跨境電商相關(guān)企業(yè)可自行定義，例如：C:Data。如下圖所示： 啟動客戶端1. 進入Client目錄，執(zhí)行startup.bat文件，如下圖所示：2、系統(tǒng)自動在/Client/Config/ASEUser.xml文件中生成授權(quán)申請碼，授權(quán)碼位于ASEUser.xml文件<appl

6、yCode>節(jié)點中，如下圖所示：3、跨境電商相關(guān)企業(yè)將授權(quán)申請碼發(fā)送至 kj（郵箱地址），郵件主題為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)認證并完成程序啟動。如下圖所示：3.1.2 注冊服務(wù)以管理員方式運行installService.bat文件。如下圖所示：3.2 Linux下安裝3.2.1 基礎(chǔ)安裝 解壓客戶端壓縮包將客戶端軟件安裝壓縮包

7、“LINUX_IMPORTS_CLIENT_V1.0.0.zip”解壓至用戶自身home目錄路徑下，例如：#tar zxvf / LINUX_IMPORTS_CLIENT_V1.0.0.zip -C /Data     啟動客戶端1. 進入Client目錄下，執(zhí)行startup.sh文件，如下圖所示：2、系統(tǒng)自動在/Client/Config/ASEUser.xml文件中生成授權(quán)申請碼，授權(quán)碼位于ASEUser.xml文件<applyCode>節(jié)點中，如下圖所示：3、跨境電商相關(guān)企業(yè)將授權(quán)申請碼發(fā)送至 kj（郵箱地址），郵件主題為XXX企業(yè)客戶端授

8、權(quán)申請，郵件正文錄入格式如下圖所示：審核通過后，管理員將ASE_License.ase（授權(quán)文件）發(fā)送給跨境電商相關(guān)企業(yè)，跨境電商相關(guān)企業(yè)收到ASE_License.ase（授權(quán)文件） 文件后，將該文件放置在Client目錄下，系統(tǒng)自動進行授權(quán)認證并完成程序啟動。如下圖所示：3.2.2 注冊服務(wù)以管理員方式運行registInstall.sh文件，進行注冊服務(wù)。4 企業(yè)接入準(zhǔn)備企業(yè)傳輸編號（DXPID）向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請傳輸協(xié)議配置信息企業(yè)根據(jù)自身業(yè)務(wù)量情況向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請適合的接入配置（MQ或AS2/AS3相關(guān)配置信息）IC卡或Ukey申請向?qū)俚睾ｊP(guān)數(shù)據(jù)分中心申請5 系統(tǒng)登錄指

9、南一、 功能介紹用戶在使用系統(tǒng)前需要先登錄系統(tǒng)。二、 操作流程1、在瀏覽器(Chrome或Firefox)中輸入系統(tǒng)地址http:/localhost:9091/console，輸入正確密碼（默認密碼88888888），點擊登錄進入系統(tǒng)登錄頁面6 系統(tǒng)操作指南6.1 系統(tǒng)監(jiān)控一、 功能介紹跨境電商相關(guān)企業(yè)在系統(tǒng)監(jiān)控查看到當(dāng)前接收數(shù)據(jù)數(shù)量、發(fā)送數(shù)據(jù)數(shù)量、接收數(shù)據(jù)容量、發(fā)送數(shù)據(jù)容量、當(dāng)前數(shù)據(jù)監(jiān)控、流量監(jiān)控以及系統(tǒng)監(jiān)控。二、 操作流程1、用戶在主菜單欄中選擇系統(tǒng)監(jiān)控即可進入系統(tǒng)監(jiān)控界面，如下圖所示：6.2 配置管理6.2.1 基本信息管理一、 功能介紹基本信息管理包括企業(yè)對接配置、連接協(xié)議配置、傳輸

10、安全配置三個模塊。為跨境電商相關(guān)企業(yè)提供錄入對接配置基本信息、連接配置協(xié)議信息以及傳輸安全配置信息。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，如下圖所示： 企業(yè)對接配置一、 功能介紹跨境電商相關(guān)企業(yè)能夠進行對接配置基本信息錄入，可進行高級選項錄入包括傳輸接收編號、報文發(fā)送路徑、報文接收路徑、異?；貓?zhí)路徑等內(nèi)容。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面錄入跨境電商相關(guān)企業(yè)對接配置信息，如下圖所示：2、跨境電商相關(guān)企業(yè)錄入完成跨境電商相關(guān)企業(yè)對接配置信息后，點擊高級按

11、鈕進行信息錄入,如下圖所示： 連接協(xié)議配置一、 功能介紹連接協(xié)議配置包括Rabbit MQ協(xié)議配置、IBM MQ或Toprow MQ協(xié)議配置和AS2/AS3等協(xié)議配置模塊，企業(yè)用戶根據(jù)需要自行選擇要使用的協(xié)議進行配置。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的連接協(xié)議配置進行配置，如下圖所示：Ø Rabbit MQ協(xié)議配置（推薦量級：>5000票/天；>100票/分；<4096KB/票）Ø IBM MQ或Toprow MQ協(xié)議配置（推薦量級：>5000票/天；

12、>100票/分；<4096KB/票）Ø AS2/AS3協(xié)議配置（推薦量級：<5000票/天；<100票/分；<1024KB/票） 傳輸安全配置一、 功能介紹傳輸安全配置用于IC卡/USBKEY設(shè)備的配置，用戶需同意并授權(quán)客戶端使用安全設(shè)備服務(wù)后才可以進行加簽操作。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的安全配置進行配置，如下圖所示：Ø IC卡/USBKey安全配置1、用戶在錄入完UKEY密碼后，在選擇加簽選項時（加業(yè)務(wù)簽、加傳輸簽），系統(tǒng)會提示用戶是否

13、同意授權(quán)客戶端使用安全設(shè)備服務(wù)，用戶點擊同意按鈕，客戶端進行加簽處理，用戶點擊取消按鈕，客戶端取消當(dāng)前加簽操作。如下圖所示。2、跨境電商相關(guān)企業(yè)錄入完成全部基本信息后，點擊右下角保存按鈕，系統(tǒng)將保存已填寫好的基本信息。6.2.2 對接配置管理一、 功能介紹用于跨境電商相關(guān)企業(yè)當(dāng)前已配置資源查詢并可啟動或停止當(dāng)前監(jiān)聽資源。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的對接配置管理，即可進入對接配置管理界面，系統(tǒng)根據(jù)查詢條件顯示監(jiān)聽資源配置信息，如下圖所示：2、用戶能夠選擇具體資源配置信息，點擊啟動按鈕，啟動當(dāng)前配置資源，或點擊全部開始按鈕，全部啟動當(dāng)前配置資源。3、用戶能夠選擇具體資源配置信

14、息，點擊停止按鈕，停止當(dāng)前配置資源，或點擊全部停止按鈕，全部停止當(dāng)前配置資源6.2.3 數(shù)據(jù)導(dǎo)入服務(wù)一、 功能介紹將跨境電商相關(guān)企業(yè)需發(fā)送的EXCLE文件轉(zhuǎn)換成業(yè)務(wù)報文進行傳輸,同時提供EXCLE模板下載。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的數(shù)據(jù)導(dǎo)入服務(wù)，即可進入數(shù)據(jù)導(dǎo)入服務(wù)界面，如下圖所示：2、在數(shù)據(jù)導(dǎo)入服務(wù)界面選擇下載EXCLE模板，將EXCLE模板下載至本地。3、 用戶將EXCLE模板進行解壓操作，如下圖所示：4、用戶填寫完成EXCLE文件，點擊上傳按鈕，將填寫完成的EXCLE文件上傳至系統(tǒng)。用戶上傳完成EXCLE文件，系統(tǒng)將跨境電商相關(guān)企業(yè)上傳的EXCLE文件轉(zhuǎn)換成XML

15、文件進行傳輸。如下圖所示：6.3 運維管理6.3.1 數(shù)據(jù)落地管理一、 功能介紹在數(shù)據(jù)落地查詢模塊下，能對落地數(shù)據(jù)進行查詢操作。企業(yè)可以根據(jù)發(fā)送時間，接收時間，報文編號，報文名稱等條件，清晰查看到系統(tǒng)傳輸報文。并能對正?；虍惓?shù)據(jù)報文進行重發(fā)操作。二、 操作流程1、用戶在主菜單欄中選擇運維管理下的數(shù)據(jù)落地管理，即可進入數(shù)據(jù)落地管理界面，如下圖所示：2、用戶可選擇正?；虍惓?shù)據(jù)報文點擊重發(fā)按鈕進行重發(fā)操作6.3.2 報文異常管理一、 功能介紹系統(tǒng)異常管理分為系統(tǒng)異常和阻塞異常，系統(tǒng)管理員可以根據(jù)異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當(dāng)前系統(tǒng)出現(xiàn)的問題的原因。二、 操

16、作流程1、用戶在主菜單欄中選擇運維管理下的報文異常管理，即可進入報文異常管理界面，如下圖所示：6.3.3 報文阻塞管理一、 功能介紹系統(tǒng)異常管理分為系統(tǒng)異常和阻塞異常，系統(tǒng)管理員可以根據(jù)異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當(dāng)前系統(tǒng)出現(xiàn)的問題的原因。二、 操作流程1、用戶在主菜單欄中選擇運維管理下的報文阻塞管理，即可進入報文阻塞管理界面，如下圖所示：7 運行與維護7.1 日常維護工作范圍：1、網(wǎng)絡(luò)維護檢查客戶端軟件的各個組成部分的網(wǎng)絡(luò)狀況，保證網(wǎng)絡(luò)的連接正常，網(wǎng)卡的使用正常。2、設(shè)備維護硬件維護：保證客戶端軟件使用的服務(wù)器的硬件環(huán)境運轉(zhuǎn)正常。軟件維護：保證操作系統(tǒng)，運行軟件（IBM MQ或Toprow MQ）及其他附屬軟件的運行正常。檢查個服務(wù)器軟件所需硬盤余量，監(jiān)控磁盤空間，數(shù)據(jù)庫空間，inode空間等。3、客戶端維護確?？缇畴娮由虅?wù)進口統(tǒng)一版信息化系統(tǒng)客戶端軟件正常運轉(zhuǎn)。7.2 常見問題處理針對常見問題列出了如下處理方式：事件預(yù)防措施處理客戶端操作系統(tǒng)斷電安裝UPS接電后系統(tǒng)支持自動重新啟動功能，如果未啟動可以人工快速介入啟動相關(guān)系統(tǒng)，并且系統(tǒng)擁有重發(fā)機制，可以重發(fā)由于斷電等災(zāi)難引起的未處理報文。系統(tǒng)日志中發(fā)現(xiàn)IC卡/USB