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

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

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

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

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

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

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

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

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

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

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

11、等fax fileVARCHAR260傳真文件劃（絕對路徑，TIF格式）pageINTEGER4傳真頁數(shù)recviimeINTEGER4接收時刻（標準C time格式，從1970 年1月1日0時0分0秒開始運算的秒 數(shù)）recvflagINTEGER4接收標志：0：電話線傳輸方式1：即時傳真?zhèn)鬏敺绞絛eviceidVARCHAR16傳真機SN碼，要緊用在多路的情形下標 識傳真是從哪臺3G-EX接收exiinfoVARCHAR200擴展信息ext IINTEGER4擴展字段1,周楚為0exi2INTEGER4擴展字段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