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林國彪修訂配置說明內容2014-7-211.2陳仲恒、 利驛飛、林國彪修訂和細化部分描述2015-4-131.3陳仲恒修改部分界面配圖sscc-fdep文件傳輸系統(tǒng)客戶端用戶手冊聲 明歡迎用戶使用深圳證券通信有限公司（以下簡稱“我公司”）軟件及本手冊。在安裝使用軟件前，請用戶務必仔細閱讀以下聲明。為保證用戶軟件使用的

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

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

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 文件任務管理213.3.5 菜單導航223.3.6 任務操作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ā)送兩個同名但內容不一樣文件給同一用戶？404.1.4 為什么間隔掃描發(fā)送的時間會比較長？404.1.5 為什么對方拒絕接收文件？414.1.6 是否可以將多個用戶的收發(fā)路徑設成同一目錄？414.2 運維問題414.2.1 運維注意事項414.2.2 當按日期規(guī)則生成收發(fā)目錄時，如何解決跨機器零點問題?414.2.3 一臺計算機上是否可以裝多套文件傳輸系統(tǒng)客戶端？424.2.4 發(fā)送目錄下已經生成相應文件的ok標志文件，卻不能自動發(fā)送？424.2.5 為什么接收目錄下，有“*.szt!、.temp、.szt!mp”此類臨時文件存在？424.2.6 怎

6、樣設置自動發(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 接收文件放置到哪一個目錄，以哪方日期為準？434.3.2 通過查詢中樞歷史收發(fā)記錄下載歷史文件時，接收成功后文件存放在哪？444.3.3 程序如何實現(xiàn)發(fā)送上一機器日期文件的？444.3.4 文件傳輸系統(tǒng)對所傳的文件名有規(guī)定？444.3.5 壓縮過的文件設置了壓縮方式發(fā)送不再壓縮？454.4 其他問題454.4.1 為什么中樞端不提供自動壓縮、解壓功能？454.4

7、.2 為什么文件傳輸系統(tǒng)不提供自動升級功能？454.4.3 客戶端后臺系統(tǒng)運行日志中搜索與任務相關的關鍵詞？455 附錄455.1 附錄 監(jiān)控輸出文件說明455.2 附錄 文件加解密接口48圖 索 引圖1客戶端功能模塊組成圖15圖2fxterm登錄界面16圖3網絡設置17圖4系統(tǒng)主界面18圖5左：管理員登陸菜單導航 右：監(jiān)視員登陸菜單導航19圖6文件任務管理20圖7通知消息欄20圖8確認通知消息對話框21圖9用戶文件任務管理頁22圖10任務操作類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調用接口32圖25對端用戶33圖26填寫用戶本地簡稱對話框34圖27報警參數(shù)34圖28地址映射35圖29鏈路帶寬36圖30增加鏈路帶寬參數(shù)36圖31數(shù)據管理37圖32音頻參數(shù)38圖33操作員管理39圖34增加客戶端操作員39表 索 引表 1 fxclient程序包7表 2 各功能模塊說明15表 3 監(jiān)控接口任務信息說明47圖 表 索 引未找到圖形項目表。1 引言金融數(shù)據交換平臺文件傳輸系統(tǒng)客戶端及終端是包括客戶端后臺fxclient和終端fxterm兩個程序?？蛻舳撕笈_fxclient的基

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

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

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

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

13、，雙擊即可添加ok標記工具到鼠標右鍵菜單。11ok標記生成工具install_x64.bat對應于creatfilelist_x64.dll的批處理腳本，雙擊即可添加ok標記工具到鼠標右鍵菜單。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以上； 內存 2g以上。4. 網絡：從客戶端v4.0開始，客戶端連接中樞，分指令連接7015、數(shù)據連接7016兩個端口，即用

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

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

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

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

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

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

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

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

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

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

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

25、天數(shù)iscallinterface=0 /任務結束是否調用接口callinterfacepath= /調用接口路徑ispasswdencrypt=0 /是否對密碼進行加密isloaddefaultrule=0 /是否加載默認規(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ā)送標記，1-時間點觸發(fā)掃描目錄全發(fā)送timeinterval=1,0,00:00,23:59 /每隔1分鐘，是否啟用時間段發(fā)送，時間段00:00-23:59timeactive= /各時間點，用;分隔priority=1 /優(yōu)先級特別說明：scanflag=.ok是掃描標志選項，實質是一種交互接口，通過該

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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