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

1、AOFAX服務(wù)器數(shù)據(jù)庫(kù)開(kāi)發(fā)接口說(shuō)明一、接口概述AOFAX數(shù)據(jù)庫(kù)接口是為滿(mǎn)足企業(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ù)庫(kù)接口系統(tǒng)由企業(yè)應(yīng)用服務(wù)器、中間數(shù)據(jù)庫(kù)以及AOFAX傳真服務(wù)器組成，結(jié)構(gòu)如下圖所示：接口實(shí)現(xiàn)了傳真的收發(fā)功能，收發(fā)過(guò)程如下：發(fā)送傳真：企業(yè)應(yīng)用系統(tǒng)將待發(fā)送的傳真任務(wù)信息寫(xiě)入中間數(shù)據(jù)庫(kù)系統(tǒng)，AOFAX傳真服務(wù)器從中間數(shù)據(jù)庫(kù)讀取發(fā)送任務(wù)，轉(zhuǎn)換后提交發(fā)送，發(fā)送完成后將發(fā)送結(jié)果回寫(xiě)到中間數(shù)據(jù)庫(kù)，企業(yè)應(yīng)用系統(tǒng)從數(shù)據(jù)庫(kù)中讀取發(fā)送結(jié)果并進(jìn)行后續(xù)處理。接收傳

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

3、ODBC數(shù)據(jù)源DSN項(xiàng)，并確保連接測(cè)試成功。4、配置AOFAX傳真服務(wù)器：?jiǎn)?dòng)AOFAX傳真系統(tǒng)，在AOFAX管理器“工具”-“選項(xiàng)”菜單的“系統(tǒng)選項(xiàng)”對(duì)話框中的“擴(kuò)展任務(wù)”屬性頁(yè)中，選擇“啟用擴(kuò)展任務(wù)調(diào)度”和“啟用數(shù)據(jù)庫(kù)接口收發(fā)傳真”，并輸入正確的DSN、UID和PWD信息，確保連接測(cè)試成功。三、開(kāi)發(fā)說(shuō)明1、發(fā)送傳真：在AOFAX傳真服務(wù)器上創(chuàng)建臨時(shí)文件夾（如C:fSendFax），用以保存企業(yè)應(yīng)用軟件提交的待發(fā)送傳真的文檔（文檔格式參考下面說(shuō)明）。企業(yè)用戶(hù)在企業(yè)應(yīng)用軟件（如ERP、OA辦公管理等）中發(fā)送傳真時(shí)，發(fā)送界面中需要把要發(fā)送傳真的相關(guān)信息體現(xiàn)出來(lái)，主要包括收發(fā)件人名、區(qū)號(hào)、傳真號(hào)碼

4、、要發(fā)送的文檔名等信息。在提交發(fā)送時(shí)把這些信息保存到中間數(shù)據(jù)庫(kù)的AOFAX發(fā)送任務(wù)表（aofax_send_task）中，同時(shí)把要發(fā)送傳真的文檔提交到AOFAX傳真服務(wù)器上的臨時(shí)文件夾中，即上述在AOFAX傳真服務(wù)器上創(chuàng)建的臨時(shí)文件夾（注意，在填寫(xiě)發(fā)送文檔路徑字段時(shí)，要填寫(xiě)絕對(duì)路徑，例如：AOFAX傳真服務(wù)器上新建的臨時(shí)文件夾為“C:fSendFax”，提交的待發(fā)送的文檔名稱(chēng)為“abc.doc”，則在填寫(xiě)發(fā)送任務(wù)表的“sendfile”字段時(shí)，應(yīng)填寫(xiě)“C:fSendFaxabc.doc”）。文檔提交以后，AOFAX傳真服務(wù)器定時(shí)掃描發(fā)送任務(wù)表，如果有待發(fā)送的文檔，將自動(dòng)讀出發(fā)送任務(wù)信息、轉(zhuǎn)換并

5、完成發(fā)送，同時(shí)把發(fā)送結(jié)果回寫(xiě)到發(fā)送任務(wù)表中。如果企業(yè)用戶(hù)要安裝AOFAX傳真客戶(hù)端，請(qǐng)安裝AOFAX企業(yè)型或服務(wù)器型中的客戶(hù)端軟件即可。2、接收傳真：AOFAX傳真服務(wù)器在接收到新傳真后，自動(dòng)把傳真相關(guān)信息保存到中間數(shù)據(jù)庫(kù)的接收任務(wù)表（aofax_recv_task）中，用戶(hù)可以通過(guò)讀取接收任務(wù)表中的內(nèi)容來(lái)查看接收到的傳真文件和傳真信息。傳真文件默認(rèn)以TIF格式保存在AOFAX傳真服務(wù)器軟件安裝目錄下的用戶(hù)數(shù)據(jù)目錄中。3、文檔格式：所有通過(guò)數(shù)據(jù)庫(kù)接口提交的待發(fā)送傳真文檔，都是在AOFAX傳真服務(wù)器端轉(zhuǎn)換成傳真格式文件（.sfx）的，因此，如果要發(fā)送某種格式的文檔時(shí)，這種格式的瀏覽器或編輯軟件必

6、須安裝在AOFAX傳真服務(wù)器上，比如常用的OFFICE軟件等等。能實(shí)現(xiàn)自動(dòng)轉(zhuǎn)換的常用格式有：.doc、.xls、.txt、.pdf、.wri等。另外有些軟件不支持自動(dòng)轉(zhuǎn)換功能，如WPS等，即使安裝了這種格式的軟件，也不能實(shí)現(xiàn)自動(dòng)發(fā)送。同時(shí)建議提交的文檔不要感染病毒，不要有密碼等。四、數(shù)據(jù)庫(kù)表結(jié)構(gòu)發(fā)送傳真任務(wù)表表名：aofax_send_task字段名類(lèi)型長(zhǎng)度（字節(jié)）說(shuō)明taskidINTEGER4任務(wù)ID，主鍵，自增長(zhǎng)titleVARCHAR200傳真主題icINTEGER4國(guó)際區(qū)號(hào)（必填，如86，即時(shí)傳真時(shí)填0）ldcINTEGER4長(zhǎng)途區(qū)號(hào)（必填，如755，即時(shí)傳真或沒(méi)有長(zhǎng)途區(qū)號(hào)時(shí)填0）f

7、axVARCHAR64傳真號(hào)碼（發(fā)送有線傳真時(shí)必填，如83235170）accountVARCHAR20傲發(fā)帳號(hào)（發(fā)送即時(shí)傳真時(shí)必填，如AF90000099）sender1VARCHAR100發(fā)件人1，標(biāo)識(shí)傳真發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2，標(biāo)識(shí)傳真發(fā)件人，如人名等receiver1VARCHAR100收件人1，標(biāo)識(shí)傳真收件人，如公司名receiver2VARCHAR30收件人2，標(biāo)識(shí)傳真收件人，如人名等sendfileVARCHAR500待發(fā)送文件名（必填，絕對(duì)路徑），多個(gè)文件之間用“|”相隔（例如：“C:fax1.txt|D:fax2.txt”）sendflagI

8、NTEGER4發(fā)送標(biāo)志（必填）：0：普通發(fā)送1：優(yōu)先發(fā)送（排到當(dāng)前發(fā)送隊(duì)列的首部）lineINTEGER4選擇線路（必填）：0：自動(dòng)調(diào)度（先嘗試即時(shí)傳真，失敗后由電話線發(fā)送）1：僅電話線發(fā)送（fax不能為空）2：僅即時(shí)傳真發(fā)送（account不能為空）statusINTEGER4任務(wù)狀態(tài)：0：提交（等待轉(zhuǎn)換）1：發(fā)送（已轉(zhuǎn)換并排隊(duì)發(fā)送）2：成功（傳真發(fā)送成功）3：失?。▊髡姘l(fā)送失?。?：取消（傳真發(fā)送被取消）添加新任務(wù)時(shí)固定填寫(xiě)為0，發(fā)送完成后狀態(tài)由系統(tǒng)回寫(xiě)extinfoVARCHAR200擴(kuò)展信息retcodeINTEGER4結(jié)果碼，發(fā)送完成后由系統(tǒng)回寫(xiě)sendtimeINTEGER4發(fā)送時(shí)

9、間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒開(kāi)始計(jì)算的秒數(shù)），發(fā)送完成后由系統(tǒng)回寫(xiě)faxfileVARCHAR260轉(zhuǎn)換后傳真文件名（TIF格式，絕對(duì)路徑），發(fā)送完成后由系統(tǒng)回寫(xiě)reserve1INTEGER4保留字段1，固定填0 reserve2INTEGER4保留字段2，固定填0ext1INTEGER4擴(kuò)展字段1，固定填0ext2INTEGER4擴(kuò)展字段2，固定填0memoVARCHAR200備注接收傳真任務(wù)表表名：aofax_recv_task字段名類(lèi)型長(zhǎng)度（字節(jié)）說(shuō)明taskidINTEGER4任務(wù)ID，主鍵，自增長(zhǎng)titleVARCHAR200傳真主題icINTEG

10、ER4國(guó)際區(qū)號(hào)（發(fā)送方）ldcINTEGER4長(zhǎng)途區(qū)號(hào)（發(fā)送方）faxVARCHAR64傳真號(hào)碼（發(fā)送方傳真號(hào)碼，即時(shí)傳真時(shí)為“傳真號(hào)碼/傲發(fā)號(hào)”，如“83235170/AF90000099”）sender1VARCHAR100發(fā)件人1，標(biāo)識(shí)傳真發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2，標(biāo)識(shí)傳真發(fā)件人，如人名等receiver1VARCHAR100收件人1，標(biāo)識(shí)傳真收件人，如公司名、部門(mén)等receiver2VARCHAR30收件人2，標(biāo)識(shí)傳真收件人，如人名、分機(jī)號(hào)等f(wàn)axfileVARCHAR260傳真文件名（絕對(duì)路徑，TIF格式）pageINTEGER4傳真頁(yè)數(shù)recvtim

11、eINTEGER4接收時(shí)間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒開(kāi)始計(jì)算的秒數(shù)）recvflagINTEGER4接收標(biāo)志：0：電話線傳輸方式1：即時(shí)傳真?zhèn)鬏敺绞絛eviceidVARCHAR16傳真機(jī)SN碼，主要用在多路的情況下標(biāo)識(shí)傳真是從哪臺(tái)3G-FAX接收extinfoVARCHAR200擴(kuò)展信息ext1INTEGER4擴(kuò)展字段1，固定為0ext2INTEGER4擴(kuò)展字段2，固定為0memoVARCHAR200備注五、SQL腳本參考1、MySQL：DROP TABLE IF EXISTS aofax_recv_task;CREATE TABLE aofax_recv_

12、task ( taskid int(10) unsigned NOT NULL AUTO_INCREMENT, title varchar(200) DEFAULT NULL, ic int(10) unsigned DEFAULT NULL, ldc int(10) unsigned DEFAULT NULL, fax varchar(64) DEFAULT NULL, sender1 varchar(100) DEFAULT NULL, sender2 varchar(30) DEFAULT NULL, receiver1 varchar(100) DEFAULT NULL, receiv

13、er2 varchar(30) DEFAULT NULL, faxfile varchar(260) DEFAULT NULL, page int(10) unsigned DEFAULT NULL, recvtime int(10) unsigned DEFAULT NULL, recvflag int(10) unsigned DEFAULT NULL, deviceid varchar(16) DEFAULT NULL, extinfo varchar(200) DEFAULT NULL, ext1 int(10) unsigned DEFAULT NULL, ext2 int(10)

14、unsigned DEFAULT NULL, memo varchar(200) DEFAULT NULL, PRIMARY KEY (taskid), UNIQUE KEY taskid (taskid) ENGINE=MyISAM AUTO_INCREMENT=200 DEFAULT CHARSET=latin1;DROP TABLE IF EXISTS aofax_send_task;CREATE TABLE aofax_send_task ( taskid int(10) unsigned NOT NULL AUTO_INCREMENT, title varchar(200) DEFA

15、ULT NULL, ic int(10) unsigned DEFAULT NULL, ldc int(10) unsigned DEFAULT NULL, fax varchar(64) DEFAULT NULL, account varchar(20) DEFAULT NULL, sender1 varchar(100) DEFAULT NULL, sender2 varchar(30) DEFAULT NULL, receiver1 varchar(100) DEFAULT NULL, receiver2 varchar(30) DEFAULT NULL, sendfile varcha

16、r(500) DEFAULT NULL, sendflag int(10) unsigned DEFAULT NULL, line int(10) unsigned DEFAULT NULL, status int(10) unsigned DEFAULT NULL, extinfo varchar(200) DEFAULT NULL, retcode int(10) unsigned DEFAULT NULL, sendtime int(10) unsigned DEFAULT NULL, faxfile varchar(260) DEFAULT NULL, reserve1 int(10)

17、 unsigned DEFAULT NULL, reserve2 int(10) unsigned DEFAULT NULL, ext1 int(10) unsigned DEFAULT NULL, ext2 int(10) unsigned DEFAULT NULL, memo varchar(200) DEFAULT NULL, PRIMARY KEY (taskid), UNIQUE KEY taskid (taskid) ENGINE=MyISAM AUTO_INCREMENT=3 DEFAULT CHARSET=latin1;2、SQL Server：if exists (selec

18、t * from dbo.sysobjects where id = object_id(Naofax_send_task) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table aofax_send_taskGOif exists (select * from dbo.sysobjects where id = object_id(Naofax_recv_task) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table aofax_recv_taskGOCREATE TABLE aofax_s

19、end_task(taskidint IDENTITY (1, 1) PRIMARY KEY CLUSTERED NOT NULL,titlevarchar(200) NOT NULL DEFAULT (0),icint NOT NULL DEFAULT (0),ldcint NOT NULL DEFAULT (0),faxvarchar(64) NOT NULL DEFAULT (0),accountvarchar(20) NOT NULL DEFAULT (0),sender1varchar(100) NOT NULL DEFAULT (0),sender2varchar(30) NOT

20、NULL DEFAULT (0),receiver1varchar(100) NOT NULL DEFAULT (0),receiver2varchar(30) NOT NULL DEFAULT (0),sendfilevarchar(500) NOT NULL DEFAULT (0),sendflagint NOT NULL DEFAULT (0),lineint NOT NULL DEFAULT (0),statusint NOT NULL DEFAULT (0),extinfovarchar(200) NOT NULL DEFAULT (0),retcodeint NOT NULL DE

21、FAULT (0),sendtimeint NOT NULL DEFAULT (0),faxfilevarchar(260) NOT NULL DEFAULT (0),reserve1int NOT NULL DEFAULT (0),reserve2int NOT NULL DEFAULT (0),ext1int NOT NULL DEFAULT (0),ext2int NOT NULL DEFAULT (0),memovarchar(200) NOT NULL DEFAULT (0),) ON PRIMARYGOCREATE TABLE aofax_recv_task (taskidint

22、IDENTITY (1, 1) PRIMARY KEY CLUSTERED NOT NULL,titlevarchar(200) NOT NULL DEFAULT (0),icint NOT NULL DEFAULT (0),ldcint NOT NULL DEFAULT (0),faxvarchar(64) NOT NULL DEFAULT (0),sender1varchar(100) NOT NULL DEFAULT (0),sender2varchar(30) NOT NULL DEFAULT (0),receiver1varchar(100) NOT NULL DEFAULT (0)

23、,receiver2varchar(30) NOT NULL DEFAULT (0),faxfilevarchar(260) NOT NULL DEFAULT (0),pageint NOT NULL DEFAULT (0),recvtimeint NOT NULL DEFAULT (0),recvflagint NOT NULL DEFAULT (0),deviceidvarchar(16) NOT NULL DEFAULT (0),extinfovarchar(200) NOT NULL DEFAULT (0),ext1int NOT NULL DEFAULT (0),ext2int NO

24、T NULL DEFAULT (0),memovarchar(200) NOT NULL DEFAULT (0),) ON PRIMARYGO2、Oracle：drop trigger aofax_send_task_trigger;drop sequence aofax_send_task_seq;drop table aofax_send_task;drop trigger aofax_recv_task_trigger;drop sequence aofax_recv_task_seq;drop table aofax_recv_task;CREATE TABLE aofax_send_

25、task (taskidnumber(10),titlevarchar2(200),icnumber(10),ldcnumber(10),faxvarchar2(64),accountvarchar2(20),sender1varchar2(100),sender2varchar2(30),receiver1varchar2(100),receiver2varchar2(30),sendfilevarchar2(500),sendflagnumber(10),linenumber(10),statusnumber(10),extinfovarchar2(200),retcodenumber(10),sendtimenumber(10),faxfilevarchar2(260),reserve1number(10),reserve2number(10),ext1number(10),ext2number(10),memovarchar2(200),PRIMARY KEY (task