AOFAX服務(wù)器數(shù)據(jù)庫開發(fā)接口說明

1、AOFAX服務(wù)器數(shù)據(jù)庫開發(fā)接口說明一、接口概述AOFAX數(shù)據(jù)庫接口是為滿足企業(yè)更多收發(fā)傳真方式的一種擴(kuò)展機(jī)制，實(shí)現(xiàn)了 AOFAX 傳真系統(tǒng)與企業(yè)應(yīng)用系統(tǒng)（如ERP、MIS、OA辦公等之間的交互和集成，從而達(dá)到擴(kuò)展 和自定義企業(yè)收發(fā)傳真模式的目的。AOFAX數(shù)據(jù)庫接口系統(tǒng)由企業(yè)應(yīng)用服務(wù)器、中間數(shù)據(jù)庫以及AOFAX傳真服務(wù)器組成, 結(jié)構(gòu)如下圖所示：3G-FAX3、4、企業(yè)應(yīng)用服務(wù)器AOFAX傳真服務(wù)器接口實(shí)現(xiàn)了傳確實(shí)收發(fā)功能，收發(fā)過程如下:發(fā)送傳真：企業(yè)應(yīng)用系統(tǒng)將待發(fā)送的傳真任務(wù)信息寫入中間數(shù)據(jù)庫系統(tǒng)，AOFAX傳克 服務(wù)器從中間數(shù)據(jù)庫讀取發(fā)送任務(wù)，轉(zhuǎn)換后提交發(fā)送，發(fā)送完成后將發(fā)送結(jié)果回寫到中間數(shù)

2、 據(jù)庫，企業(yè)應(yīng)用系統(tǒng)從數(shù)據(jù)庫中讀取發(fā)送結(jié)果并進(jìn)行后續(xù)處理。接收傳真：AOFAX傳克服務(wù)器收到新傳真后，自動(dòng)將傳貞信息寫入到中間數(shù)據(jù)庫系統(tǒng), 企業(yè)應(yīng)用系統(tǒng)從中間數(shù)據(jù)庫讀取接收傳真信息并進(jìn)行后續(xù)處理。二、系統(tǒng)部署1、預(yù)備軟硬件環(huán)境： 傳真服務(wù)器：AOFAX企業(yè)型、服務(wù)器型。數(shù)據(jù)庫系統(tǒng)：MySQL. SQLServer、Oracle等數(shù)據(jù)庫系統(tǒng)。企業(yè)應(yīng)用系統(tǒng)：確保系統(tǒng)運(yùn)作正常，并支持柑應(yīng)數(shù)據(jù)庫系統(tǒng)的存取操作。2、配置數(shù)據(jù)庫：在已正常運(yùn)作的數(shù)據(jù)庫系統(tǒng)中創(chuàng)建所需的接口數(shù)據(jù)庫和接口表：發(fā)送任務(wù)表 （aofax_send_task）x接收任務(wù)表（aofaxccvask）。表結(jié)構(gòu)和創(chuàng)建腳本參考后續(xù) 講明。創(chuàng)建

3、ODBC數(shù)據(jù)源：在AOFAX傳貞服務(wù)器上創(chuàng)建相應(yīng)接口數(shù)據(jù)庫的ODBC數(shù)據(jù)源DSN項(xiàng)，并確保連 接測(cè)試成功- 配置AO弘X傳真服務(wù)器：啟動(dòng)AOFAX傳貞系統(tǒng)，在AOFAX治理器“工具”- “選項(xiàng)”菜單的“系統(tǒng)選項(xiàng)對(duì)話框中的“擴(kuò)展任務(wù)”屬性頁中，選擇“啟用擴(kuò)展任務(wù)調(diào)度”和“啟用數(shù)據(jù)庫接 口收發(fā)傳真”，并輸入正確的DSN、UID和PWD信息，確保連接測(cè)試成功。三、開發(fā)講明1、發(fā)送傳貞：在AOFAX傳真服務(wù)器上創(chuàng)建臨時(shí)文件夾（如C:fSendFax）,用以儲(chǔ)存企業(yè)應(yīng) 用軟件提交的待發(fā)送傳確實(shí)文檔（文檔格式參考下面講明）。企業(yè)用戶在企業(yè)應(yīng)用軟件（如ERP、OA辦公治理等）中發(fā)送傳頁時(shí)，發(fā)送界 而中需要把

4、要發(fā)送傳確實(shí)相關(guān)信息表達(dá)出來，要緊包括收發(fā)件人名、區(qū)號(hào)、傳真號(hào) 碼、要發(fā)送的文檔等信息。在提交發(fā)送時(shí)把這些信息儲(chǔ)存到中間數(shù)搖庫的AOFAX 發(fā)送任務(wù)表（aofax_scnd_task）中，同時(shí)把要發(fā)送傳確實(shí)文檔提交到AOFAX傳真 服務(wù)器上的臨時(shí)文件夾中，即上述在AOFAX傳貞服務(wù)器上創(chuàng)建的臨時(shí)文件夾（注 意，在填寫發(fā)送文檔路徑字段時(shí)，要填寫絕對(duì)路徑，例如：AOFAX傳真服務(wù)器上 新建的臨時(shí)文件夾為“C:fScruJFax”，提交的待發(fā)送的文檔名稱為“abcQoc”，則 在填寫發(fā)送任務(wù)表的“scndfilc”字段時(shí)，應(yīng)填寫“C:fScndFaxabc.doc”）。文檔提交以后，AOFAX傳真服

5、務(wù)器左時(shí)掃描發(fā)送任務(wù)表，假如有待發(fā)送的文 檔，將自動(dòng)讀動(dòng)身送任務(wù)信息、轉(zhuǎn)換并完成發(fā)送，同時(shí)把發(fā)送結(jié)果回寫到發(fā)送任務(wù) 表中。假如企業(yè)用戶要安裝AOFAX傳真客戶端，請(qǐng)安裝AOFAX企業(yè)型或服務(wù)器型 中的客戶端軟件即可。2、接收傳真：AOFAX傳貞服務(wù)器在接收到新傳真后，自動(dòng)把傳真相關(guān)信息儲(chǔ)存到中間數(shù)據(jù) 庫的接收任務(wù)表（aofax_recv_task）中，用戶能夠通過讀取接收任務(wù)表中的內(nèi)容來 査看接收到的傳真文件和傳真信息。傳真文件默認(rèn)以TIF格式儲(chǔ)存在AOFAX傳真 服務(wù)器軟件安裝名目下的用戶數(shù)據(jù)名目中。3、文檔格式：所有通過數(shù)據(jù)庫接口提交的待發(fā)送傳貞文檔，差不多上在AOFAX傳克服務(wù)器 端轉(zhuǎn)換

6、成傳真格式文件（.sfx）的，因此，假如要發(fā)送某種格式的文檔時(shí)，這種格 式的掃脯器或編輯軟件必須安裝在AORX傳真服務(wù)器上，比如常用的OFFICE軟 件等等。能實(shí)現(xiàn)自動(dòng)轉(zhuǎn)換的常用格式有：.doc、.X1S、.ixt、.pdf、.wri等。列外有些軟件 不支持自動(dòng)轉(zhuǎn)換功能，如WPS等，即使安裝了這種格式的軟件，也不能實(shí)現(xiàn)自動(dòng) 發(fā)送。同時(shí)建議提交的文檔不要感染病毒，不要有密碼等。四、數(shù)據(jù)庫表結(jié)構(gòu)發(fā)送傳真任務(wù)表表名：aofax sencl iask字段名類型長度（字節(jié)）講明laskidINTEGER4任務(wù)ID,主鍵，自增長titleVARCHAR200傳真主題icINTEGER4國際區(qū)號(hào)（必填，如8

7、6,即時(shí)傳貞時(shí)填0)IdcINTEGER4長途區(qū)號(hào)（必填，如755,即時(shí)傳真或沒 有長途區(qū)號(hào)時(shí)填0）faxVARCHAR64傳貞號(hào)碼（發(fā)送有線傳貞時(shí)必填，如83235170）accountVARCHAR20傲發(fā)帳號(hào)（發(fā)送即時(shí)傳貞時(shí)必填，如AF90000099）sender 1VARCHAR100發(fā)件人1,標(biāo)識(shí)傳貞發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2,標(biāo)識(shí)傳貞發(fā)件人，如人名等receiverlVARCHAR100收件人1，標(biāo)識(shí)傳貞收件人，如公司名receiver?VARCHAR30收件人2,標(biāo)識(shí)傳貞收件人，如人名等scndfileVARCHAR500待發(fā)送文件名（必填，絕對(duì)路

8、徑），多個(gè) 文件之間用“ 1 ”相隔（例如：C:faxl.txtlD:fax2.lxt）sendflagINTEGER4發(fā)送標(biāo)忠（必填）：0： 一般發(fā)送1：優(yōu)先發(fā)送（排到當(dāng)前發(fā)送隊(duì)列的首部）lineINTEGER4選擇線路（必填）：0：自動(dòng)調(diào)度（先嘗試即時(shí)傳貞，失敗后 由電話線發(fā)送）1：僅電話線發(fā)送（恰滅不能為空）2：僅即時(shí)傳頁發(fā)送（accoiim不能為空）statusINTEGER4任務(wù)狀態(tài)：0：提交（等待轉(zhuǎn)換）1：發(fā)送（已轉(zhuǎn)換并排隊(duì)發(fā)送）2：成功（傳真發(fā)送成功）3：失?。▊髡姘l(fā)送失敗4：取消（傳真發(fā)送被取消）添加新任務(wù)時(shí)固填寫為0.發(fā)送完成后 狀態(tài)由系統(tǒng)回寫exiinfoVARCHAR20

9、0擴(kuò)展信息retcodeINTEGER4結(jié)果碼，發(fā)送完成后由系統(tǒng)回寫sendlinieINTEGER4發(fā)送時(shí)刻（標(biāo)準(zhǔn)C timej格式，從1970 年1月1日0時(shí)0分0秒開始運(yùn)算的秒 數(shù)），發(fā)送完成后由系統(tǒng)回寫fax fileVARCHAR260轉(zhuǎn)換后傳貞文件洛（TIF格式，絕對(duì)路 徑），發(fā)送完成后由系統(tǒng)回寫reserve1INTEGER4保留字段1,固楚填0rescrvc2INTEGER4保留字段2,固楚填0exilINTEGER4擴(kuò)展字段1,固楚填0exi2INTEGER4擴(kuò)展字段2,固楚填0memoVARCHAR200備注接收傳真任務(wù)表表名：aofax recv iask字段名類型長度（

10、字節(jié)）講明taskidINTEGER4任務(wù)ID,主鍵，自增長titleVARCHAR200傳真主題icINTEGER4國際區(qū)號(hào)（發(fā)送方）IdcINTEGER4長途區(qū)號(hào)（發(fā)送方）faxVARCHAR64傳真號(hào)碼（發(fā)送方傳真號(hào)碼，即時(shí)傳真 時(shí)為“傳真號(hào)碼/傲發(fā)號(hào)”，如 “83235170/AF90000099sender1VARCHAR100發(fā)件人1，標(biāo)識(shí)傳貞發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2,標(biāo)識(shí)傳貞發(fā)件人，如人需等receiverlVARCHAR100收件人1，標(biāo)識(shí)傳貞收件人，如公司名、 部門等receiver?VARCHAR30收件人2,標(biāo)識(shí)傳真收件人，如人名、分 機(jī)號(hào)

11、等fax fileVARCHAR260傳真文件劃（絕對(duì)路徑，TIF格式）pageINTEGER4傳真頁數(shù)recviimeINTEGER4接收時(shí)刻（標(biāo)準(zhǔn)C time格式，從1970 年1月1日0時(shí)0分0秒開始運(yùn)算的秒 數(shù)）recvflagINTEGER4接收標(biāo)志：0：電話線傳輸方式1：即時(shí)傳真?zhèn)鬏敺绞絛eviceidVARCHAR16傳真機(jī)SN碼，要緊用在多路的情形下標(biāo) 識(shí)傳真是從哪臺(tái)3G-EX接收exiinfoVARCHAR200擴(kuò)展信息ext IINTEGER4擴(kuò)展字段1,周楚為0exi2INTEGER4擴(kuò)展字段2,周楚為0memoVARCHAR200備注五、SQL腳本參考1、MySQL：D

12、ROP TABLE IF EXISTS aofax recv task:CREATE TABLE aofax_recvjask ( taskid int( 10) unsigned NOT NULL AUTOJNCREMENT, title varchar(20f) DEFAULT NULL, ic int(lO) unsigned DEFAULT NULL. Idc intflO) unsigned DEFAULT NULL, fax varchar(64) DEFAULT NULL, sender! varchardOO) DEFAULT NULL. sender? varchar(30)

13、 DEFAULT NULL, receiver 1 varchar(100) DEFAULT NULL. receiver2 varchar(30) DEFAULT NULL.faxfile varchar(260) DEFAULT NULL.page int(lO) unsigned DEFAULT NULL, reevtime int(lO) unsigned DEFAULT NULL, recvflag int(lO) unsigned DEFAULT NULL.deviceid varchar(16) DEFAULT NULLextinfo varchar(200) DEFAULT N

14、ULLextl inU 10) unsigned DEFAULT NULL.ext2 int(lO) unsigned DEFAULT NULL.memo varchar(200) DEFAULT NULL.PRIMARY KEY (laskid).UNIQUE KEY taskid (taskid)ENGINE=MyISAM AUTO_INCREMENT=200 DEFAULT CHARSET=latinl:DROP TABLE IF EXISTS aofax_sendjask;CREATE TABLE aofax_sendjask (taskid int(lO) unsigned NOT

15、NULL AUTO JNCREMENT, title varchar(200) DEFAULT NULL.ic inUlO) unsigned DEFAULT NULL. Idc inUlO) unsigned DEFAULT NULL, fax varchar(64) DEFAULT NULL, account varchar(20) DEFAULT NULL, senderl varchar(lOO) DEFAULT NULL, sender? varchar(30) DEFAULT NULL, receiver 1 varchar100) DEFAULT NULL. receiver2

16、varchar(30) DEFAULT NULL, sendfile varchar(500) DEFAULT NULL, sendflag int(lO) unsigned DEFAULT NULL, line int(lO) unsigned DEFAULT NULL, status int(lO) unsigned DEFAULT NULL, extinfo varchar(200) DEFAULT NULL, reicode int(lO) unsigned DEFAULT NULL, sendtime int(lO) unsigned DEFAULT NULL, faxfile va

17、rchar(260) DEFAULT NULL, reserve 1 int10) unsigned DEFAULT NULL. rcscrvc2 int(lO) unsigned DEFAULT NULL, extl int(lO) unsigned DEFAULT NULL. ext2 inUlO) unsigned DEFAULT NULL, memo varchar(200) DEFAULT NULL. PRIMARY KEY (taskid). UNIQUE KEY taskid (taskid)ENGINE=MyISAM AUT0NCREMENT=3 DEFAULT CHARSET

18、=latin 1;2. SQL Server：if exists (select * from dbo.sysobjccts where id OBJECTPROPERTY(id NIsUseiTable) = 1) drop table aofax_send_taskGOif exists (select * from dbo.sysobjecls where id OBJECTPROPERTY(id NIsUserTable*) = 1) drop table aofax_recv_taskl=objeclJd(N*aofax_send_taskl) and=objecUd(Naofax_

19、recv_task) andGOCREATE TABLE aofax_send_task( taskid title ic Ide faxaccount sender 1 sender? receiverlint IDENTITY (h 1) PRIMARY KEY varchar200) NOT NULL DEFAULT (0). int NOT NULL DEFAULT (0). int NOT NULL DEFAULT (0). varchar(64) NOT NULL DEFAULT (0),varcharJ(20) NOT NULL DEFAULT (O). varcharRlOO)

20、 NOT NULL DEFAULT (0). varcharl(30) NOT NULL DEFAULT (0). varcharK 100) NOT NULL DEFAULT (0).CLUSTERED NOT NULL.int NOT NULL DEFAULT (0). varcharl(200) NOT NULL DEFAULT (0).int NOT NULL DEFAULT (0),int NOT NULL DEFAULT (0), varchar(260) NOT NULL DEFAULT (0).int NOT NULL DEFAULT (0).int NOT NULL DEFA

21、ULT (0).receiver2 varchar(30) NOT NULL DEFAULT (0). sendfile varchar(500) NOT NULL DEFAULT (0). sendnag int NOT NULL DEFAULT (0).line (int NOT NULL DEFAULT (0), status extinfo retcode sendtime fax file reserve 1 reserve2 extl inti NOT NULL DEFAULT (0). ext2 inti NOT NULL DEFAULT (0). memo varchar(20

22、0) NOT NULL DEFAULT (0).)ON PRIMARY GOCREATE TABLE aofax_recv_task(taskid int IDENTITY (h 1) PRIMARY KEY CLUSTERED NOT NULL.title ic ide faxvarchar(200) NOT NULL DEFAULT (0). int NOT NULL DEFAULT (0), int NOT NULL DEFAULT (0). varchar(64) NOT NULL DEFAULT (0).sender 1 varchar(100) NOT NULL DEFAULT (

23、0). sender2 varchar(30) NOT NULL DEFAULT (0). receiverl varcharJ(lOO) NOT NULL DEFAULT (0). receiver2 varcharJ(30) NOT NULL DEFAULT (O). faxfile varcharK260) NOT NULL DEFAULT (0). page inti NOT NULL DEFAULT (0). reevtime reevflag deviceid extinfoint NOT NULL DEFAULT (0),int NOT NULL DEFAULT (0). var

24、char(16) NOT NULL DEFAULT (0). varchar(200) NOT NULL DEFAULT (0).extl (int NOT NULL DEFAULT (0), ext2 int NOT NULL DEFAULT (0), memo varchar(200) NOT NULL DEFAULT (0).)ON PRIMARY GO2、Oracle：drop trigger aofax_send_task_triggcr; drop sequence aofax_sendjask_seq; drop table aofax_sencl_iask;drop trigg

25、er aofax_recvjask_trigger; drop sequence aofax_recv_task_seq; drop table aofax_recv_task;CREATE TABLE aofax_sendjask (number! 10).varchar2(200),number(lO),number(lO),varchar2(64), varchar2(20). varchar2100).varchar2(30)varchar2100).taskid title ic Ide faxaccount sender 1 sender? receiverlreceiver? varchar230). sendfile varchar2500). sendflag number! 10).line nuniber(lO), status extinfo retcodenumbcr(10) varchar2(200) number! 10).sendtime number! 10). fax file varchar2(260) reserve 1 number! 10). reserve2 number! 10). extl number(lO), ext2 number(lO), memo varchar2(200), PRIMARY KEY (taskid)c