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

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

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

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

4、字、字母和符號(hào)等，它是信息的一種載體，數(shù)據(jù)是信息傳輸?shù)囊环N形式，主要指與計(jì)算機(jī)有關(guān)的信息傳輸。數(shù)據(jù)傳輸報(bào)文在本文是指用于存放數(shù)據(jù)傳輸數(shù)據(jù)的載體文件的泛稱。3數(shù)據(jù)格式數(shù)據(jù)格式本文指數(shù)據(jù)傳輸報(bào)文的文件類型，主要指XML、EXCEL等數(shù)據(jù)格式。4數(shù)據(jù)格式轉(zhuǎn)換數(shù)據(jù)格式轉(zhuǎn)換從一種數(shù)據(jù)格式轉(zhuǎn)換成另外一種數(shù)據(jù)格式的過程。5節(jié)點(diǎn)節(jié)點(diǎn)在網(wǎng)絡(luò)拓?fù)渲校W(wǎng)絡(luò)任何支路的終端或網(wǎng)絡(luò)中兩個(gè)或更多支中的互連公共點(diǎn)。2 運(yùn)行環(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 軟件安裝說(shuō)明3.1 Windows下安裝3.1.1 基礎(chǔ)安裝 解壓客戶端壓縮包將跨境電子商務(wù)進(jìn)口統(tǒng)一版信息化系統(tǒng)客戶端軟件安裝壓縮包：“WINDOWS_IMPORTS_CLIENT_V1.0.0.zip”解壓至跨境電商相關(guān)企業(yè)服務(wù)器的某硬盤路徑下，具體路徑跨境電商相關(guān)企業(yè)可自行定義，例如：C:Data。如下圖所示： 啟動(dòng)客戶端1. 進(jìn)入Client目錄，執(zhí)行startup.bat文件，如下圖所示：2、系統(tǒng)自動(dòng)在/Client/Config/ASEUser.xml文件中生成授權(quán)申請(qǐng)碼，授權(quán)碼位于ASEUser.xml文件<appl

6、yCode>節(jié)點(diǎn)中，如下圖所示：3、跨境電商相關(guān)企業(yè)將授權(quán)申請(qǐng)碼發(fā)送至 kj（郵箱地址），郵件主題為XXX企業(yè)客戶端授權(quán)申請(qǐng)，郵件正文錄入格式如下圖所示：郵件內(nèi)容審核通過后管理員將ASE_License.ase（授權(quán)文件）發(fā)送給跨境電商相關(guān)企業(yè)，跨境電商相關(guān)企業(yè)收到ASE_License.ase （授權(quán)文件）文件后，將該文件放置在Client所在根目錄下，系統(tǒng)自動(dòng)進(jìn)行授權(quán)認(rèn)證并完成程序啟動(dòng)。如下圖所示：3.1.2 注冊(cè)服務(wù)以管理員方式運(yùn)行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     啟動(dòng)客戶端1. 進(jìn)入Client目錄下，執(zhí)行startup.sh文件，如下圖所示：2、系統(tǒng)自動(dòng)在/Client/Config/ASEUser.xml文件中生成授權(quán)申請(qǐng)碼，授權(quán)碼位于ASEUser.xml文件<applyCode>節(jié)點(diǎn)中，如下圖所示：3、跨境電商相關(guān)企業(yè)將授權(quán)申請(qǐng)碼發(fā)送至 kj（郵箱地址），郵件主題為XXX企業(yè)客戶端授

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

9、南一、 功能介紹用戶在使用系統(tǒng)前需要先登錄系統(tǒng)。二、 操作流程1、在瀏覽器(Chrome或Firefox)中輸入系統(tǒng)地址http:/localhost:9091/console，輸入正確密碼（默認(rèn)密碼88888888），點(diǎn)擊登錄進(jìn)入系統(tǒng)登錄頁(yè)面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)控即可進(jìn)入系統(tǒng)監(jiān)控界面，如下圖所示：6.2 配置管理6.2.1 基本信息管理一、 功能介紹基本信息管理包括企業(yè)對(duì)接配置、連接協(xié)議配置、傳輸

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

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

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

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

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

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

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