SSCC-FDEP文件傳輸系統(tǒng)客戶端用戶手冊

1、sscc-fdep文件傳輸系統(tǒng)客戶端用戶手冊sscc-fdep文件傳輸系統(tǒng)客戶端用戶手冊文檔版本：1.3文檔密級：外部公開文檔信息文檔名稱fdep文件傳輸系統(tǒng)客戶端及終端用戶手冊說明修訂歷史日期版本修改單位修改說明201308201.0利驛飛創(chuàng)建并完成初稿。2014-6-201.1林國彪修訂配置說明內(nèi)容2014-7-211.2陳仲恒、 利驛飛、林國彪修訂和細(xì)化部分描述2015-4-131.3陳仲恒修改部分界面配圖sscc-fdep文件傳輸系統(tǒng)客戶端用戶手冊聲 明歡迎用戶使用深圳證券通信有限公司（以下簡稱“我公司”）軟件及本手冊。在安裝使用軟件前，請用戶務(wù)必仔細(xì)閱讀以下聲明。為保證用戶軟件使用的

2、穩(wěn)定性，用戶可通過我公司網(wǎng)站獲取最新發(fā)布的正式版本。在使用本軟件前，用戶應(yīng)理解使用軟件帶來的風(fēng)險。因此，需要用戶嚴(yán)格按照本手冊指定的運(yùn)行環(huán)境和操作步驟運(yùn)行和操作使用軟件。因未按照用戶手冊說明使用而導(dǎo)致的任何損失，用戶須自行承擔(dān)。我公司擁有本軟件的著作權(quán)。用戶不得對本軟件進(jìn)行反向工程、反向匯編、反向編譯等修改。非經(jīng)我公司授權(quán)開發(fā)或未經(jīng)我公司正式發(fā)布的其它任何由本軟件衍生的軟件均屬非法，下載、安裝、使用此類軟件，將可能導(dǎo)致不可預(yù)知的風(fēng)險，由此產(chǎn)生的一切法律責(zé)任與糾紛自行承擔(dān)，并且我公司不會對非我方直接提供的軟件提供客服及技術(shù)支持。本軟件經(jīng)過嚴(yán)格的測試，但不能保證與所有的軟硬件系統(tǒng)完全兼容。本軟件也

3、可能存在尚未發(fā)現(xiàn)的缺陷。如果用戶發(fā)現(xiàn)不兼容及軟件缺陷的情況，可撥打我公司技術(shù)支持電話以獲得進(jìn)一步技術(shù)支持。使用本軟件可能會受到不可抗力、通信線路、計算機(jī)病毒、黑客攻擊、操作系統(tǒng)不穩(wěn)定、用戶不當(dāng)操作及非我公司因素導(dǎo)致的服務(wù)中斷風(fēng)險，用戶須理解并自行承擔(dān)以上風(fēng)險。本手冊的最終解釋權(quán)歸深圳證券通信有限公司所有。目 錄1 引言61.1 編寫目的61.2 系統(tǒng)概述61.3 定義61.4 參考資料62 安裝指南72.1 安裝準(zhǔn)備72.1.1 運(yùn)行平臺及要求72.1.2 安裝前準(zhǔn)備信息82.2 安裝步驟82.2.1 步驟182.2.2 步驟292.2.3 其它說明92.3 配置文件說明102.4 生成ok標(biāo)

4、記工具說明153 使用說明153.1 系統(tǒng)功能模塊153.1.1 功能模塊組成圖153.2 用戶操作流程163.3 具體操作163.3.1 登錄163.3.2 系統(tǒng)主界面介紹183.3.3 首頁介紹203.3.4 文件任務(wù)管理213.3.5 菜單導(dǎo)航223.3.6 任務(wù)操作223.3.7 連接與查詢253.3.8 配置菜單294 常見問題集404.1 配置問題404.1.1 傳輸規(guī)則配置中增加或修改傳輸規(guī)則時，報”modify rule in ini file failed:send/recv path, or scan rule is not valid”錯誤？404.1.2 為什么發(fā)給a用

5、戶的文件會錯發(fā)給b用戶？404.1.3 如何發(fā)送兩個同名但內(nèi)容不一樣文件給同一用戶？404.1.4 為什么間隔掃描發(fā)送的時間會比較長？404.1.5 為什么對方拒絕接收文件？414.1.6 是否可以將多個用戶的收發(fā)路徑設(shè)成同一目錄？414.2 運(yùn)維問題414.2.1 運(yùn)維注意事項414.2.2 當(dāng)按日期規(guī)則生成收發(fā)目錄時，如何解決跨機(jī)器零點(diǎn)問題?414.2.3 一臺計算機(jī)上是否可以裝多套文件傳輸系統(tǒng)客戶端？424.2.4 發(fā)送目錄下已經(jīng)生成相應(yīng)文件的ok標(biāo)志文件，卻不能自動發(fā)送？424.2.5 為什么接收目錄下，有“*.szt!、.temp、.szt!mp”此類臨時文件存在？424.2.6 怎

6、樣設(shè)置自動發(fā)送文件？424.2.7 讀不了ekey怎么辦？434.2.8 如何修改ekey密碼？434.2.9 如何修改文件傳輸系統(tǒng)的用戶系統(tǒng)密碼？434.2.10 日志管理功能管理哪些日志文件？434.3 實現(xiàn)原理問題434.3.1 接收文件放置到哪一個目錄，以哪方日期為準(zhǔn)？434.3.2 通過查詢中樞歷史收發(fā)記錄下載歷史文件時，接收成功后文件存放在哪？444.3.3 程序如何實現(xiàn)發(fā)送上一機(jī)器日期文件的？444.3.4 文件傳輸系統(tǒng)對所傳的文件名有規(guī)定？444.3.5 壓縮過的文件設(shè)置了壓縮方式發(fā)送不再壓縮？454.4 其他問題454.4.1 為什么中樞端不提供自動壓縮、解壓功能？454.4

7、.2 為什么文件傳輸系統(tǒng)不提供自動升級功能？454.4.3 客戶端后臺系統(tǒng)運(yùn)行日志中搜索與任務(wù)相關(guān)的關(guān)鍵詞？455 附錄455.1 附錄 監(jiān)控輸出文件說明455.2 附錄 文件加解密接口48圖 索 引圖1客戶端功能模塊組成圖15圖2fxterm登錄界面16圖3網(wǎng)絡(luò)設(shè)置17圖4系統(tǒng)主界面18圖5左：管理員登陸菜單導(dǎo)航 右：監(jiān)視員登陸菜單導(dǎo)航19圖6文件任務(wù)管理20圖7通知消息欄20圖8確認(rèn)通知消息對話框21圖9用戶文件任務(wù)管理頁22圖10任務(wù)操作類22圖11手工發(fā)送23圖12下載文件24圖13手工壓縮25圖14手工壓縮25圖15連接與管理類26圖16連接與斷開26圖17系統(tǒng)狀態(tài)27圖18歷史記錄

8、27圖19可用資源28圖20后臺日志29圖21配置菜單類29圖22傳輸規(guī)則30圖23增加傳輸規(guī)則30圖24調(diào)用接口32圖25對端用戶33圖26填寫用戶本地簡稱對話框34圖27報警參數(shù)34圖28地址映射35圖29鏈路帶寬36圖30增加鏈路帶寬參數(shù)36圖31數(shù)據(jù)管理37圖32音頻參數(shù)38圖33操作員管理39圖34增加客戶端操作員39表 索 引表 1 fxclient程序包7表 2 各功能模塊說明15表 3 監(jiān)控接口任務(wù)信息說明47圖 表 索 引未找到圖形項目表。1 引言金融數(shù)據(jù)交換平臺文件傳輸系統(tǒng)客戶端及終端是包括客戶端后臺fxclient和終端fxterm兩個程序。客戶端后臺fxclient的基

9、本功能是：建立與中樞的鏈路，發(fā)送和接收來自不同連接方的各種文件和數(shù)據(jù)等；終端fxterm的基本功能是：建立與客戶端后臺的連接，管理和維護(hù)后臺的運(yùn)行，手工發(fā)送和接收文件及數(shù)據(jù)等。1.1 編寫目的手冊編寫的目的是方便平臺使用用戶安裝和使用本平臺。目標(biāo)讀者為銀行，券商及深證通公司的技術(shù)人員，維護(hù)運(yùn)營人員。1.2 系統(tǒng)概述目前交易、結(jié)算、行情等通信系統(tǒng)都有文件傳輸功能，這些系統(tǒng)需求比較類似，為了減少文件傳輸業(yè)務(wù)需求變化對通信系統(tǒng)帶來的影響以及可能帶來的風(fēng)險，同時提高研發(fā)效率，減少重復(fù)開發(fā)，公司決定將交易、結(jié)算、行情等系統(tǒng)的文件傳輸功能分離出來，建立一套獨(dú)立的文件傳輸系統(tǒng)。同時現(xiàn)有文件傳輸系統(tǒng)隨著用戶數(shù)

10、、業(yè)務(wù)量不斷增加，對傳輸?shù)陌踩浴⒎€(wěn)定性、高性能、監(jiān)控管理有更高的要求，現(xiàn)有系統(tǒng)需要再次擴(kuò)容及增加更多附加功能，才能滿足后續(xù)業(yè)務(wù)發(fā)展的需要。fdep文件傳輸系統(tǒng)可完成用戶與用戶之間的文件交換，系統(tǒng)只負(fù)責(zé)數(shù)據(jù)傳輸，不關(guān)注數(shù)據(jù)內(nèi)容。1.3 定義fdep：金融數(shù)據(jù)交換平臺；fx：文件傳輸系統(tǒng)；1.4 參考資料1. sscc-fdep文件傳輸fxapi用戶手冊.doc2. sscc-fdep文件傳輸系統(tǒng)客戶端文件加解密接口說明手冊.doc2 安裝指南2.1 安裝準(zhǔn)備2.1.1 運(yùn)行平臺及要求1. 客戶端和終端程序獲?。嚎梢詮纳钲谧C券通信公司網(wǎng)站()-下載專區(qū)-金融數(shù)據(jù)交

11、換平臺-軟件下載-sscc-fdep文件傳輸系統(tǒng)相關(guān)的下載頁中，下載最新版本的客戶端完整安裝包，其中fxclient.exe是客戶端后臺（控制臺應(yīng)用程序），fxterm.exe是客戶端終端。表1是fxclient程序包的文件列表。表 1 fxclient程序包序號文件名稱說明1fxclient目錄該目錄下放置的是金融數(shù)據(jù)交換平臺文件傳輸系統(tǒng)客戶端后臺程序2fxclient.exe金融數(shù)據(jù)交換平臺文件傳輸系統(tǒng)客戶端的運(yùn)行程序3fxapi.dllfxapi動態(tài)鏈接庫文件3certca.cercertuser.pemca的證書，不能修改用戶證書文件，文件名可更改（選擇文件證書用戶才有）4inifxa

12、pi.ini與fxapi.dll相關(guān)的配置文件，需要修改5inifxclient.ini與fxclient.exe相關(guān)的配置文件，需要修改6inifxrule.ini與傳輸規(guī)則相關(guān)的配置文件，通過界面終端修改7log目錄客戶端后臺運(yùn)行日志存放目錄8ok標(biāo)記生成工具creatfilelist_win32.dll鼠標(biāo)右鍵菜單添加ok標(biāo)記工具的win32位動態(tài)鏈接庫文件9ok標(biāo)記生成工具creatfilelist_x64.dll鼠標(biāo)右鍵菜單添加ok標(biāo)記工具的win64位動態(tài)鏈接庫文件10ok標(biāo)記生成工具install_win32.bat對應(yīng)于creatfilelist_win32.dll的批處理腳本

13、，雙擊即可添加ok標(biāo)記工具到鼠標(biāo)右鍵菜單。11ok標(biāo)記生成工具install_x64.bat對應(yīng)于creatfilelist_x64.dll的批處理腳本，雙擊即可添加ok標(biāo)記工具到鼠標(biāo)右鍵菜單。2. 支持的操作系統(tǒng)：32位windows 2003，64位windows2008；64位linux的rhel server 6.2的操作系統(tǒng)，推薦32位windows 2003。終端term只支持帶界面的linux系統(tǒng)。3. 硬件要求：pc server cpu 頻率2.0ghz以上； 內(nèi)存 2g以上。4. 網(wǎng)絡(luò)：從客戶端v4.0開始，客戶端連接中樞，分指令連接7015、數(shù)據(jù)連接7016兩個端口，即用

14、戶端網(wǎng)絡(luò)需要放開這兩個端口，其中7015端口是長連接，7016端口是短連接。 客戶端v3.0及更舊版本，只需開放7015端口； 連接由客戶端單向發(fā)起，中樞服務(wù)器不會主動連接客戶端；5. 運(yùn)行環(huán)境：從官網(wǎng)上下載jre安裝包，或從深證通公司主頁上下載，需支持jre1.6及后續(xù)版本；6. 其他：用戶使用軟證書文件或ekey中存儲的數(shù)字證書進(jìn)行身份驗證，因此安裝客戶端程序的計算機(jī)必須具有usb接口。2.1.2 安裝前準(zhǔn)備信息生產(chǎn)用戶需向深證通申請用戶號和ekey；測試用戶只需用戶號。2.2 安裝步驟安裝客戶端完整安裝包，在目標(biāo)文件夾中，執(zhí)行fxclient.exe即可啟動客戶端后臺程序；執(zhí)行fxter

15、m.exe即可啟動客戶端終端程序。其中客戶端后臺程序的啟動需要3個前提條件：（1） 用戶必須有深圳證券通信公司頒發(fā)的ekey電子證書或者軟加密進(jìn)行登錄；（2） 安裝運(yùn)行環(huán)境jre；（3） 用戶必須正確配置安裝后的目錄下 inifxapi.ini和inifxclient.ini兩個文件。因此需要按以下兩個步驟進(jìn)行操作。2.2.1 步驟1對于使用ekey進(jìn)行身份認(rèn)證的用戶，首先安裝ekey驅(qū)動程序，客戶端后臺啟動前插入ekey，然后啟動客戶端后臺程序。用戶在ekey證書因損壞等原因不能正常使用的情況下，可以向主站申請軟件加密的通信方式，這時用戶選擇軟件加密建立連接，詳見4.2.7。2.2.2 步驟

16、2從深證通主頁或java官網(wǎng)上下載的jre文件，根據(jù)提示安裝；2.2.3 步驟3配置文件：fxapi.ini和fxclient.ini。對于fxapi.ini配置文件，用戶只需配置ip地址映射關(guān)系 即可： ipportmap/ip地址映射信息，轉(zhuǎn)換前的地址=轉(zhuǎn)換后的地址,如果無nat轉(zhuǎn)換或多線路接入，只需配置左邊=右邊/指令連接58:7015=58:701559:7015=59:7015/數(shù)據(jù)連接58:7016=58:701659:7016=1

17、59:7016對于fxclient.ini配置文件，用戶只需配置以下六項即可：configuserid=t0001 /用戶小站號userpwd=t0001 /用戶登錄中樞的密碼ekey= /ekey名稱ekeypwd= /登錄ekey的密碼listenip= /對終端term的iplistenport=3001 /對終端term的端口配置完畢保存后，點(diǎn)擊fxclient.exe即可啟動客戶端后臺程序；點(diǎn)擊fxterm.exe即可啟動客戶端終端程序，對后臺進(jìn)行管理和監(jiān)控。2.2.4 其它說明終端支持與后臺運(yùn)行于同一臺機(jī)器或各自不同機(jī)器。在64位linux的

18、rhel server 6.2操作系統(tǒng)上運(yùn)行終端時，為確保終端有可執(zhí)行權(quán)限、配置/日志有讀寫權(quán)限，建議把讀、寫、可執(zhí)行權(quán)限賦給終端目錄及其子目錄下的所有文件。2.3 配置文件說明fxapi.ini配置文件簡單說明如下，詳見sscc-fdep文件傳輸系統(tǒng)fxapi用戶手冊.doc。apiconfigrecvfilepath=./temp/ /臨時接收目錄fetchfilepath=./fetch/ /從中樞獲取文件存放目錄usefetchpath=1 /使用以上定義的目錄存放從中樞獲取的文件processthreadnum=3 /預(yù)處理線程數(shù)(并發(fā)數(shù))transferthreadnum=2 /單

19、個傳輸組件傳輸線程數(shù)(并發(fā)傳輸任務(wù)數(shù))datalinktype=2 / 數(shù)據(jù)鏈接類型：1-長鏈接(默認(rèn))，2-空閑后超時斷開datalinklogouttimeout=30 /數(shù)據(jù)連接超時斷開秒數(shù)issharenas=0 /是否共享nassharenasnode=shenzhen /共享nas節(jié)點(diǎn)名稱autolink=1 /是否自動重連(ucom)isssllink=1 /是否使用ssl連接issoftcert=0 /是否使用軟證書softcertfilename=user.pem /軟證書文件名iscoverrecvfile=0 /接收同名的文件是否覆蓋savehistlibday=30 /

20、保留歷史任務(wù)庫天數(shù)oncesendcmdcount=100 /重發(fā)任務(wù)相關(guān)指令時，一次發(fā)送個數(shù)maxsendqueuelength=100000 /發(fā)送任務(wù)當(dāng)前隊列最大長度（未完成的發(fā)送任務(wù)數(shù)）savetaskday=7 /任務(wù)在隊列中的保留天數(shù)notcompressexts=.bz.bz2.rar.zip.7z /含有該后綴的文件不壓縮filecompressflag=1 /文件壓縮標(biāo)志：除去上面定義的后綴文件，其他文件是否壓縮。pkgcompressflag=1 /包壓縮標(biāo)志：發(fā)送傳輸文件數(shù)據(jù)包時是否壓縮，若文件已壓縮（任務(wù)設(shè)置了壓縮，或文件含有壓縮后綴），該選項不起作用。citynode

21、shenzhen=09:00|15:30|64|2000 /線路情況，到深圳的線路，09:30-15:30使用64k帶寬,其他時間段使用2m帶寬ipportmap/ip地址映射信息，轉(zhuǎn)換前的地址=轉(zhuǎn)換后的地址,如果無nat轉(zhuǎn)換或多線路接入，只需配置左邊=右邊/指令連接58:7015=58:701559:7015=59:7015/數(shù)據(jù)連接58:7016=58:701659:7016=59:7016loglocktype=1

22、 /鎖類型,進(jìn)程鎖or線程鎖level=1 /打日志級別display=3 /日志顯示：1-屏幕，2-文件，3屏幕和文件logdir=./log /存放日志目錄logname=fxapi.log /日志名稱maxfilecount=20 /當(dāng)天最多日志數(shù)maxfilesize=200000000 /單個日志文件最大大小fxclient.ini配置文件說明：configuserid=k0001 /用戶號userpwd=k0001 /用戶密碼ekey= /ekey名稱ekeypwd= /ekey密碼listenip= /開放term監(jiān)聽ip和端口listenport=3001sc

23、anflag=.ok /掃描發(fā)送標(biāo)記allowflagbeforedatasec=0 /允許標(biāo)記文件早于數(shù)據(jù)文件存在仍發(fā)送的秒數(shù)sendsuccessflag= /發(fā)送完成生成標(biāo)記(.rcv)recvsuccessflag= /結(jié)束完成生成標(biāo)記(.snt)ismngdata=0 /是否啟用數(shù)據(jù)管理mngdatatype=0 /數(shù)據(jù)管理類型，0-copy,1-移動，2-刪除backuppath=c:backup /數(shù)據(jù)管理備份路徑savedataday=365 /保留數(shù)據(jù)天數(shù)startmonitor=0 /是否啟用監(jiān)控文件輸出monupdatesec=60 /監(jiān)控文件輸出時間間隔monversi

24、on=20130701 /監(jiān)控接口版本montaskscount=1000 /監(jiān)控輸出未完成任務(wù)個數(shù)monfilepath=./mon /監(jiān)控文件輸出路徑cpualarmenable=0 /是的啟用cpu報警cpualarmparam=80 /cpu報警閾值參數(shù)memalarmenable=0 /是的啟用內(nèi)存報警memalarmparam=90 /內(nèi)存報警閾值參數(shù)diskalarmenable=0 /是的啟用硬盤報警diskalarmparam=80 /硬盤報警閾值參數(shù)isautodeletelog=1 /是否自動刪除日志，通知文件savelognoticeday=30 /保留日志，通知文件的

25、天數(shù)iscallinterface=0 /任務(wù)結(jié)束是否調(diào)用接口callinterfacepath= /調(diào)用接口路徑ispasswdencrypt=0 /是否對密碼進(jìn)行加密isloaddefaultrule=0 /是否加載默認(rèn)規(guī)則ischeckrecvdir=1 /是否檢查接收路徑與別的發(fā)送路徑一樣，或是別的發(fā)送路徑的子目錄startdencry=0 /是否啟用加解密模塊allowmaxfilecount=1000 /允許term手工一次最大發(fā)送文件數(shù)noticemsgfilepath=./notice /通知文件存放路徑sysuseradmin=admin|1|管理員 /term用戶名=密碼|

26、角色|term描述。角色：0-普通，1-管理員linkuser/對端連接人信息,用戶號=用戶描述k0007=招商ruletemplate/規(guī)則模板sendpath=c:sendrecvpath=c:recvsubdir=1 /是否包含子目錄scanmode=0 /掃描模式：0-每隔幾分鐘掃描發(fā)送標(biāo)記，1-時間點(diǎn)觸發(fā)掃描目錄全發(fā)送timeinterval=1,0,00:00,23:59 /每隔1分鐘，是否啟用時間段發(fā)送，時間段00:00-23:59timeactive= /各時間點(diǎn)，用;分隔priority=1 /優(yōu)先級特別說明：scanflag=.ok是掃描標(biāo)志選項，實質(zhì)是一種交互接口，通過該

27、接口可告知客戶端軟件數(shù)據(jù)已經(jīng)準(zhǔn)備就緒，該配置項只有配合掃描模式scanmode=0時使用才有效。當(dāng)程序掃描傳輸規(guī)則發(fā)送路徑時，如果發(fā)送路徑下存在數(shù)據(jù)文件及其數(shù)據(jù)文件對應(yīng)的ok標(biāo)記文件，在觸發(fā)客戶端程序建立發(fā)送任務(wù)，并刪除ok標(biāo)記文件(ok標(biāo)志被刪除表示添加任務(wù)成功，不代表發(fā)送成功)。ok標(biāo)記文件是一個空文件，用戶可在生成數(shù)據(jù)文件同時，生成數(shù)據(jù)文件的ok標(biāo)志文件。例如：某傳輸規(guī)則的scanmode=0，發(fā)送路徑為d:abc，若該目錄下存在data.txt和data.txt.ok兩個文件，則會觸發(fā)發(fā)送data.txt文件。fxrule.ini配置文件說明：#hub# /規(guī)則名稱：連接人名稱、業(yè)務(wù)類

28、型名稱、廣播名稱ruledescr=中樞 /規(guī)則描述ruletype=1 /規(guī)則類型：1-按連接人、2-按業(yè)務(wù)類型、3-廣播linkuserscount=1 /關(guān)聯(lián)對端用戶數(shù)linkusers0=#hub#|中樞 /規(guī)則關(guān)聯(lián)的對端用戶，用,分隔sendpath=./hub /發(fā)送路徑recvpath=./hub /接收路徑subdir=1 /是否包含子目錄發(fā)送（0或1）scanmode=0 /掃描類型：0-每隔幾分鐘掃描標(biāo)記發(fā)送，1-時間點(diǎn)觸發(fā)掃描目錄全發(fā)送timeinterval=1,1,00:00,23:59 /每隔1分鐘，是否啟用時間段發(fā)送，時間段00:00-23:59timeactiv

29、e= /各時間點(diǎn)，用;分隔sendscanyesterdaydir=0,00:00 /是否掃描昨天的發(fā)送目錄，在00:00之前掃描recvtoyesterdaydir=0,00:00 /是否接收到昨天的接收目錄，在00:00之前存放到昨天的接收目錄priority=1 /優(yōu)先級13iscompress=0 /是否壓縮（0或1）2.4 生成ok標(biāo)記工具說明生成ok標(biāo)記工具是windows平臺方便用戶鼠標(biāo)右鍵文件生成對應(yīng)標(biāo)記文件的工具。雙擊對應(yīng)32位或64位windows平臺的”install_win32.bat”或” install_x64.bat”，即可注冊ok標(biāo)記工具到鼠標(biāo)右鍵菜單。特別說明

30、：ok標(biāo)記文件的最后修改時間必須在數(shù)據(jù)文件的最后修改時間之后，才能觸發(fā)數(shù)據(jù)文件發(fā)送。建議ok標(biāo)記文件與數(shù)據(jù)文件在同一臺服務(wù)器上生成，避免由于服務(wù)器時間不一致，導(dǎo)致ok標(biāo)記時間在數(shù)據(jù)文件時間之前。3 使用說明3.1 系統(tǒng)功能模塊3.1.1 功能模塊組成圖圖1 客戶端功能模塊組成圖客戶端后臺fxclient的各功能模塊說明見表2。表 2 各功能模塊說明序號模塊名稱功能簡述1fxapi負(fù)責(zé)與中樞建立連接，文件傳輸指令處理、文件數(shù)據(jù)傳輸?shù)?fxclient調(diào)用fxapi接口與中樞建立連接，管理客戶端配置、掃描配置文件、與fxterm通信，處理fxterm的請求；3fxterm客戶端監(jiān)控管理界面、顯示客

31、戶端連接中樞的狀態(tài)、用戶管理配置操作等。4fxtranscomp文件傳輸組件，負(fù)責(zé)讀出或?qū)懭霐?shù)據(jù)，將數(shù)據(jù)文件分塊等3.2 用戶操作流程用戶點(diǎn)擊fxterm終端上的菜單項即發(fā)送到后臺，讓后臺執(zhí)行相應(yīng)的操作。各項操作由3.3節(jié)詳細(xì)說明。3.3 具體操作3.3.1 登錄雙擊fxterm.exe啟動客戶端終端程序，初次啟動登錄界面如圖2所示。輸入系統(tǒng)默認(rèn)用戶名”admin”和密碼”admin”，點(diǎn)擊”設(shè)置”按鈕將彈出網(wǎng)絡(luò)設(shè)置對話框如圖3所示，輸入fxclient.ini文件中l(wèi)istenip項和listenport項已配置正確的ip地址和端口，并確定返回登錄界面，進(jìn)行登錄。圖2 fxterm登錄界面圖

32、3 網(wǎng)絡(luò)設(shè)置當(dāng)用戶名和密碼輸入正確，并且網(wǎng)絡(luò)設(shè)置已配置正確，則登錄后將出現(xiàn)系統(tǒng)主界面。3.3.2 系統(tǒng)主界面介紹圖4 系統(tǒng)主界面1) 主界面的菜單欄：文件菜單包含重啟客戶終端和退出兩個操作選項；視圖菜單包含日志和菜單導(dǎo)航兩個顯示選項；幫助菜單顯示終端軟件的版本等信息。2) 主界面的右上方顯示該term的登錄用戶及登錄時間點(diǎn)，“首頁 | 退出系統(tǒng)”是快捷選項方便用戶快速進(jìn)行切換和退出。3) 主界面的右方是業(yè)務(wù)區(qū)，業(yè)務(wù)操作都是在該區(qū)域進(jìn)行。登陸成功時該區(qū)域會顯示“首頁”。4) 業(yè)務(wù)區(qū)下方是日志區(qū)，系統(tǒng)日志都顯示在這個區(qū)域里面。5) 主界面左下方的狀態(tài)信息中，顯示有“已連接客戶端后臺xxx.xxx.

33、xxx.xxx 用戶號yyy”的提示信息。下方的綠色狀態(tài)信息中，顯示“客戶端后臺與中樞連接正?！眲t表明文件傳輸客戶端后臺已經(jīng)成功連接中樞服務(wù)器。當(dāng)客戶端后臺與中樞連接斷開時，下方的狀態(tài)顏色將會變成紅色，以警示監(jiān)控人員注意。下方最后一個狀態(tài)信息顯示有多少條未確認(rèn)的通知。6) 主界面的左側(cè)是導(dǎo)航欄，包含“菜單導(dǎo)航”和“文件任務(wù)管理”兩個選項卡。當(dāng)管理員登陸終端時，“菜單導(dǎo)航”的“配置菜單”會顯示所有項，當(dāng)監(jiān)視員登陸終端時，“配置菜單”只會顯示“客戶端操作員管理”項。 圖5 左：管理員登陸菜單導(dǎo)航 右：監(jiān)視員登陸菜單導(dǎo)航圖6 文件任務(wù)管理3.3.3 首頁介紹在“首頁”的“通知消息”欄里顯示通知消息，

34、用紅色顯示未確認(rèn)的通知，如圖7所示。圖7 通知消息欄用戶雙擊該紅色標(biāo)記的未確認(rèn)通知，即可彈出如圖8所示的界面顯示通知的內(nèi)容，點(diǎn)擊“確定”即可確認(rèn)該條通知，已確認(rèn)的通知表明監(jiān)控人員已閱該條通知內(nèi)容。用戶雙擊已確認(rèn)的通知，即可查看該通知的內(nèi)容以及確認(rèn)人等信息。圖8 確認(rèn)通知消息對話框“首頁”的右側(cè)是“深證通公告”欄，顯示最近的公告信息。3.3.4 文件任務(wù)管理該功能用于管理發(fā)送和接收不同用戶的文件任務(wù)。單擊特定的用戶將在主界面右側(cè)顯示該用戶發(fā)送或接收的文件任務(wù)詳細(xì)信息，如圖9所示，發(fā)件箱和收件箱可以查看任務(wù)數(shù)量以及狀態(tài)進(jìn)度。當(dāng)文件任務(wù)數(shù)量超過20條時，可通過翻頁或指定頁碼跳轉(zhuǎn)至相應(yīng)的任務(wù)頁面。此外

35、，在該頁面可對文件任務(wù)進(jìn)行“重新開始”、“暫?！?、“繼續(xù)”、“取消”、“刪除”等操作。 圖9 用戶文件任務(wù)管理頁重新開始：只有任務(wù)處于終止（成功、失敗、取消）的狀態(tài)時，才可進(jìn)行重新開始操作。暫停：只要任務(wù)未處于終止的狀態(tài)，都可進(jìn)行暫停操作。繼續(xù)：只有任務(wù)處于暫停狀態(tài)時，才可進(jìn)行繼續(xù)操作。取消：只要任務(wù)未處于終止的狀態(tài)，都可進(jìn)行取消操作。刪除：只有任務(wù)處于終止?fàn)顟B(tài)時，才可進(jìn)行刪除操作。注意：在做操作前，須先勾選需要相應(yīng)操作的任務(wù)；點(diǎn)擊“全選”可快速選擇該頁面的所有任務(wù)。3.3.5 菜單導(dǎo)航菜單導(dǎo)航包括三個大類：任務(wù)操作、連接與查詢、配置菜單（只有管理員登陸終端時，“客戶端操作員管理”以外的配置菜

36、單選項才會顯示），如圖5所示。3.3.6 任務(wù)操作任務(wù)操作類包含以下4種操作，如下圖10所示：圖10 任務(wù)操作類 手工發(fā)送 圖11 手工發(fā)送1) 用戶點(diǎn)擊“手工發(fā)送”，則在主界面右側(cè)顯示手工發(fā)送頁面，如圖11所示。在該頁面，管理員或監(jiān)視員可選擇要發(fā)送文件的路徑，通過按鈕添加待發(fā)送文件到右側(cè)，使用按鈕移除右側(cè)不需要發(fā)送的文件。2) 可選擇傳輸規(guī)則名稱、優(yōu)先級及是否壓縮來發(fā)送文件。若傳輸規(guī)則選擇了“自定義”，則優(yōu)先級和是否壓縮復(fù)選框可用，但必須選擇目的接收用戶后，才能發(fā)送文件；若選擇了其他的傳輸規(guī)則，則優(yōu)先級和是否壓縮復(fù)選框?qū)⒉豢捎?，且不需要在“對端連接人”列表中選擇目的接收用戶；3

37、.3.6.2 下載文件 圖12 下載文件1) 用戶點(diǎn)擊“下載文件”，則在主界面右側(cè)顯示下載歷史文件頁面，如圖12所示。輸入源端用戶號、目的端用戶號、文件任務(wù)收發(fā)日期和時間點(diǎn)，以及收發(fā)文件的文件名關(guān)鍵字，點(diǎn)擊查詢，即可查詢出中樞關(guān)于符合條件的文件任務(wù)并顯示在下方的文件任務(wù)列表內(nèi)。注意，文件任務(wù)列表內(nèi)不會顯示狀態(tài)為“在源端”、“傳輸中”的任務(wù)。2) 在任務(wù)列表中查詢出符合條件的文件任務(wù)后，通過勾選指定的任務(wù)，點(diǎn)擊“下載歷史文件”按鈕可重新下載歷史收發(fā)過的文件，文件會存放在ini/fxapi.ini配置文件中配置項fetchfilepath所指定的目錄。點(diǎn)擊“全選”可快速選擇所有文件任務(wù)。3.3.6

38、.3 手工壓縮 圖13 手工壓縮用戶點(diǎn)擊“手工壓縮”，則在主界面右側(cè)顯示手工壓縮頁面，如圖13所示。點(diǎn)擊“添加文件”按鈕選擇待壓縮的文件，且需要勾選文件，點(diǎn)擊“開始”進(jìn)行壓縮，點(diǎn)擊“取消”可取消壓縮。 手工解壓 圖14 手工壓縮用戶點(diǎn)擊“手工解縮”，則在主界面右側(cè)顯示手工解縮頁面，如圖14所示。點(diǎn)擊“添加文件”按鈕選擇待解縮的文件，且需要勾選文件，點(diǎn)擊“開始”進(jìn)行解縮，點(diǎn)擊“取消”可取消解縮。3.3.7 連接與查詢連接與查詢類有以下6種操作，如下圖15所示：圖15 連接與管理類 連接與斷開1) 當(dāng)客戶端后臺與中樞連接正常時，用戶雙擊“連接與斷開”，則在主界面將彈出圖

39、16所示的頁面，詢問用戶是否確定斷開客戶端后臺與中樞的連接。2) 當(dāng)客戶端后臺與中樞連接斷開時，用戶雙擊“連接與斷開”，則在主界面將彈出類似下圖的頁面，詢問用戶是否要建立客戶端后臺與中樞的連接。圖16 連接與斷開 系統(tǒng)狀態(tài)用戶雙擊“系統(tǒng)狀態(tài)”，則在主界面將顯示如圖17所示的界面。該頁面顯示客戶端后臺的運(yùn)行狀態(tài)信息和任務(wù)統(tǒng)計信息。圖17 系統(tǒng)狀態(tài) 歷史記錄用戶雙擊“歷史記錄”，則在主界面將顯示如圖18所示的界面。圖18 歷史記錄圖18頁面用戶輸入查詢條件，點(diǎn)擊查詢可查詢本地的任務(wù)歷史收發(fā)記錄，該頁面只顯示1萬條以內(nèi)的查詢記錄，通過“導(dǎo)出”按鈕可導(dǎo)出所有記錄到一個文件（

40、*.csv）。注意：對于發(fā)送任務(wù)，“對端用戶號”指目的端用戶號；對于接收任務(wù)，“對端用戶號”指源端用戶號?！拔募P(guān)鍵字”支持模糊查找。 刪除任務(wù)庫用戶雙擊“刪除任務(wù)庫”，將會彈出對話框詢問用戶是否要刪除任務(wù)庫文件。 可用資源用戶雙擊“可用資源”，則在主界面右側(cè)將顯示如圖19所示的界面。頁面顯示用戶的一些權(quán)限資源，及具有通信關(guān)系的對端用戶信息。 圖19 可用資源 后臺日志用戶雙擊“后臺日志”，則在主界面右側(cè)將顯示如圖20所示的界面，用戶輸入時間及時間點(diǎn)，點(diǎn)擊確定并指定存放目錄，即可獲取客戶端后臺的運(yùn)行日志。注意：后臺的日志文件是按日期存放，并且單個日志

41、文件大小超過指定大小（fxapi.ini中l(wèi)og的maxfilesize指定字節(jié)數(shù)）限制時會以當(dāng)前的時間點(diǎn)來命名該日志文件，并且生成一個新的日志文件來繼續(xù)寫系統(tǒng)運(yùn)行日志。圖20 后臺日志3.3.8 配置菜單只有管理員登陸終端時，“客戶端操作員管理”以外的配置菜單選項才會顯示。該類有以下9種操作，如下圖21所示：圖21 配置菜單類 傳輸規(guī)則用戶雙擊“傳輸規(guī)則”，則在主界面右側(cè)將顯示如圖22所示的界面，用戶點(diǎn)擊“設(shè)置默認(rèn)規(guī)則”可配置一個規(guī)則的模板。圖22 傳輸規(guī)則該頁面可增加、修改、刪除傳輸規(guī)則。增加傳輸規(guī)則：如圖23所示是增加傳輸規(guī)則的對話框。 圖23 增加傳輸規(guī)則1) 傳輸規(guī)則類

42、型：包括3種類型：連接人規(guī)則（單個目的用戶）、業(yè)務(wù)類型規(guī)則（單個或多個目的用戶）、廣播規(guī)則（全網(wǎng)所有用戶）。2) 傳輸規(guī)則名稱：若選擇連接人規(guī)則，則該編輯框不可編輯，選擇對端連接人時自動填充；若選擇業(yè)務(wù)類型規(guī)則或廣播規(guī)則，可編輯該名稱。3) 傳輸規(guī)則描述：若選擇連接人規(guī)則，則該編輯框不可編輯，選擇對端連接人時自動填充；若選擇業(yè)務(wù)類型規(guī)則或廣播規(guī)則，可編輯該描述。4) 對端連接人：當(dāng)選擇連接人規(guī)則時，可選擇單個對端用戶到右邊的列表；當(dāng)選擇業(yè)務(wù)類型規(guī)則時，可選擇單個或多個對端用戶到右邊的列表；當(dāng)選擇廣播規(guī)則時，無須選擇用戶。在添加對端連接人之前，需先通過對端連接人信息配置一節(jié)添加對端

43、連接人。5) 發(fā)送文件路徑：通過點(diǎn)擊按鈕可指定發(fā)送文件路徑，當(dāng)客戶端后臺掃描檢測到該路徑下存在文件時就會按照配置的規(guī)則進(jìn)行發(fā)送。支持通配符：。注意：收發(fā)路徑不能使用相對路徑，必須配置絕對路徑（全路徑）, 路徑不應(yīng)出現(xiàn)”./”、”./”、”.”、”.”、”等字符串。6) 接收文件路徑：通過點(diǎn)擊按鈕可指定接收文件路徑，當(dāng)客戶端后臺收到源端發(fā)送過來的一個文件時，將按配置的規(guī)則存放到該路徑下。支持通配符：。7) 包含子目錄發(fā)送：勾上該選項時，若文件存放在一個子目錄下，將會將該子目錄的信息帶到目的用戶，目的用戶接收該文件時會建立相應(yīng)的子目錄并將文件存放在該子目錄下。8) 掃描方式可配置兩種方式進(jìn)行掃描發(fā)

44、送路徑：l 設(shè)置為每隔多少分鐘自動檢測并發(fā)送文件；如果需要可以設(shè)置掃描的時間段。用戶在掃描的時間范圍內(nèi)對發(fā)送目錄中的文件設(shè)置ok標(biāo)志（即用戶對數(shù)據(jù)文件生成一個ok標(biāo)志文件），程序檢測到ok標(biāo)志后，將自動發(fā)送文件，并刪除對應(yīng)的ok標(biāo)記文件。ok標(biāo)志文件的格式為：待發(fā)送文件全名.ok。如文件“c:sendkfjyqr.dbf”的ok標(biāo)志文件為“c:sendkfjyqr.dbf.ok”。ok小寫。l 設(shè)置定時發(fā)送的時間點(diǎn)，多個時間點(diǎn)可以用分號進(jìn)行分割。每日到達(dá)定時發(fā)送時間點(diǎn)時，系統(tǒng)自動掃描和發(fā)送路徑中的全部文件，不需要用戶設(shè)置ok標(biāo)志。9) 允許掃描前一天發(fā)送目錄：若勾上該選項并指定時間點(diǎn)后，則在此

45、時間點(diǎn)之前客戶端后臺除了掃描檢測當(dāng)天的發(fā)送目錄外，還會掃描檢測前一天的發(fā)送目錄，并將該目錄下的文件發(fā)送出去。10) 允許接收文件存放到前一天的接收目錄：若勾上該選項并指定時間點(diǎn)后，則在此時間點(diǎn)之前客戶端后臺會將接收到的文件存放到前一天的接收目錄。向下拖動右側(cè)的滾動條即可顯示該項。11) 發(fā)送方式：可配置優(yōu)先級和是否壓縮發(fā)送。向下拖動右側(cè)的滾動條即可顯示該項。12) 點(diǎn)擊“使用默認(rèn)規(guī)則”可根據(jù)用戶配置的規(guī)則模板快速配置。13) 修改傳輸規(guī)則與增加傳輸規(guī)則的頁面是一樣的，在此不再贅述。選擇一條傳輸規(guī)則，點(diǎn)擊“刪除”按鈕即可刪除該條傳輸規(guī)則。 調(diào)用接口用戶雙擊“調(diào)用接口”，則在主界面右

46、側(cè)將顯示如圖24所示的界面。 圖24 調(diào)用接口用戶勾選“啟用調(diào)用接口”并配置接口程序路徑后，客戶端后臺在文件任務(wù)終止時將會調(diào)用用戶配置的接口程序，并傳入與任務(wù)相關(guān)的參數(shù)，參數(shù)格式如下。1) 發(fā)送任務(wù)格式：“任務(wù)類型|源用戶號|目的用戶號|任務(wù)開始時間|源文件大小|源發(fā)送文件路徑|是否成功”。2) 接收任務(wù)格式：“任務(wù)類型|源用戶號|目的用戶號|任務(wù)開始時間|源文件大小|源發(fā)送文件路徑|接收文件路徑|是否成功”。任務(wù)類型：1-發(fā)送，2-接收；任務(wù)開始時間格式：年月日時分秒（yyyymmddhhmmss）；源文件大?。簡挝籦yte；是否成功：0-失敗，1-成功。 對端用戶用戶雙擊“對

47、端用戶”，則在主界面右側(cè)將顯示如圖25所示的界面。 圖25 對端用戶頁面左側(cè)是可選用戶號，右側(cè)是已選用戶號，已選用戶號將會在“文件任務(wù)管理”導(dǎo)航欄里（發(fā)件箱、已發(fā)件箱、收件箱、已收件箱）顯示相應(yīng)的用戶號。用戶勾選左側(cè)的用戶號，點(diǎn)擊按鈕將彈出圖26的對話框。在該對話框，用戶可修改用戶號對應(yīng)的簡稱（程序默認(rèn)使用中樞設(shè)置的用戶簡稱）。點(diǎn)擊確定后，選擇的用戶號將在頁面右側(cè)的列表中顯示，表示已選的用戶號。最終點(diǎn)擊頁面的確定按鈕才會保存已選信息。圖26 填寫用戶本地簡稱對話框 報警參數(shù)用戶雙擊“報警參數(shù)”，則在主界面右側(cè)將顯示如圖27所示的界面。 若用戶勾選相應(yīng)的選項并設(shè)置了報警閥值后，當(dāng)客

48、戶端后臺服務(wù)器相應(yīng)使用率超過設(shè)定的閥值后，客戶端終端term將會報警，并打印相應(yīng)的日志信息。圖27 報警參數(shù) 地址映射用戶雙擊“地址映射”，則在主界面右側(cè)將顯示如圖28所示的界面。用戶可對通信地址的配置和地址映射配置進(jìn)行增、刪、改操作，該配置信息是客戶端后臺連接中樞服務(wù)器地址的信息。注意：當(dāng)該部分信息改動后，客戶端后臺會斷開中樞的連接，并以改動后的地址信息重連中樞。圖28 地址映射 鏈路帶寬用戶雙擊“鏈路帶寬”，則在主界面右側(cè)將顯示如圖29所示的界面。圖29 鏈路帶寬圖30 增加鏈路帶寬參數(shù)用戶可對鏈路帶寬參數(shù)配置進(jìn)行增、刪、改操作，當(dāng)中樞進(jìn)行分布式部署時，該配置信

49、息表示用戶與哪個節(jié)點(diǎn)存在著線路，并可配置在不同時間段采用不同的帶寬速度來傳輸文件。如圖30是增加鏈路帶寬參數(shù)的對話框，節(jié)點(diǎn)名稱只能從列表中選擇。注意：增刪鏈路帶寬參數(shù)都需要手工重啟客戶端后臺才能生效。 數(shù)據(jù)管理用戶雙擊“數(shù)據(jù)管理”，則在主界面右側(cè)將顯示如圖31所示的界面。圖31 數(shù)據(jù)管理1) 監(jiān)控文件輸出：顯示客戶端后臺是否已啟用監(jiān)控文件輸出，并且顯示監(jiān)控文件輸出的路徑（默認(rèn)是與程序運(yùn)行的同級目錄下的mon文件夾）。監(jiān)控文件包含兩種文件：moninfo.txt和mondetail_yyyymmdd.txt。詳見4.5.1。2) 日志保留：若勾選啟用日志保留并配置保留天數(shù)，客戶端后

50、臺自動刪除過期日志。3) 歷史數(shù)據(jù)管理：若勾選啟用歷史數(shù)據(jù)管理，當(dāng)選擇管理方式為“拷貝”并配置備份路徑時，客戶端后臺在發(fā)送文件任務(wù)成功后會自動將發(fā)送文件拷貝一份至備份路徑；當(dāng)選擇管理方式為“移動”并配置備份路徑時，客戶端后臺在發(fā)送文件任務(wù)成功后會自動將發(fā)送文件移動一份至備份路徑；當(dāng)選擇管理方式為“刪除”并配置數(shù)據(jù)保留天數(shù)時，客戶端后臺在發(fā)送文件任務(wù)成功后會自動將過期的發(fā)送文件刪除（慎用，刪除不可恢復(fù)），并清除過期的庫文件(sendyyyymmdd.szt、recvyyyymmdd.szt)。 音頻參數(shù)用戶雙擊“音頻參數(shù)”，則在主界面右側(cè)將顯示如圖32所示的界面。若勾選啟用播放音頻，并配置對應(yīng)的任務(wù)成功、任務(wù)失敗、系統(tǒng)異常的音頻文件路徑，客戶端終端會播放相應(yīng)的聲音。圖32 音頻參數(shù) 操作員管理用戶雙擊“操作員管理”，則在主界面右側(cè)將顯示如圖33所示的界面。用戶可對操作員進(jìn)行增、刪、改；當(dāng)刪除或改動某個操作員信息后，客戶端后臺會斷開對應(yīng)的操作員終端的連接。圖33 操作員管理圖34 增加客戶端操作員4 常見問題集4.1 配置問題4.1.1 傳輸規(guī)則配置中增加或修改