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)如下圖所示：接口實(shí)現(xiàn)了傳真的收發(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ù)據(jù)庫，企業(yè)應(yīng)用系統(tǒng)從數(shù)據(jù)庫中讀取發(fā)送結(jié)果并進(jìn)行后續(xù)處理。接收傳

2、真：AOFAX傳真服務(wù)器收到新傳真后，自動將傳真信息寫入到中間數(shù)據(jù)庫系統(tǒng)，企業(yè)應(yīng)用系統(tǒng)從中間數(shù)據(jù)庫讀取接收傳真信息并進(jìn)行后續(xù)處理。二、系統(tǒng)部署1、準(zhǔn)備軟硬件環(huán)境：傳真服務(wù)器：AOFAX企業(yè)型、服務(wù)器型。數(shù)據(jù)庫系統(tǒng)：MySQL、SQL Server、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）、接收任務(wù)表（aofax_recv_task）。表結(jié)構(gòu)和創(chuàng)建腳本參考后續(xù)說明。3、創(chuàng)建ODBC數(shù)據(jù)源：在AOFAX傳真服務(wù)器上創(chuàng)建相應(yīng)接口數(shù)據(jù)庫的

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

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

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

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

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

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

9、應(yīng)答4：文件格式錯5：發(fā)送頁前信號中斷6：線路訓(xùn)練失敗7：發(fā)送頁后信號中斷8：用戶取消9：超時無應(yīng)答20：待發(fā)送文件錯誤21：系統(tǒng)讀寫錯誤22：打印轉(zhuǎn)換錯誤sendtimeINTEGER4發(fā)送時間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時0分0秒開始計算的秒數(shù)），發(fā)送完成后由系統(tǒng)回寫faxfileVARCHAR260轉(zhuǎn)換后傳真文件名（TIF格式，絕對路徑），發(fā)送完成后由系統(tǒng)回寫reserve1INTEGER4保留字段1，固定填0 reserve2INTEGER4保留字段2，固定填0ext1INTEGER4擴(kuò)展字段1，固定填0ext2INTEGER4擴(kuò)展字段2，固定填0memoVARC

10、HAR200備注subtypeINTEGER4提交類型：0：接口提交1：客戶端提交接收傳真任務(wù)表表名：aofax_recv_task字段名類型長度（字節(jié)）說明taskidINTEGER4任務(wù)ID，主鍵，自增長titleVARCHAR200傳真主題icINTEGER4國際區(qū)號（發(fā)送方）ldcINTEGER4長途區(qū)號（發(fā)送方）faxVARCHAR64傳真號碼（發(fā)送方傳真號碼，即時傳真時為“傳真號碼/傲發(fā)號”，如“83235170/AF90000099”）sender1VARCHAR100發(fā)件人1，標(biāo)識傳真發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2，標(biāo)識傳真發(fā)件人，如人名等receiv

11、er1VARCHAR100收件人1，標(biāo)識傳真收件人，如公司名、部門等receiver2VARCHAR30收件人2，標(biāo)識傳真收件人，如人名、分機(jī)號等faxfileVARCHAR260傳真文件名（絕對路徑，TIF格式）pageINTEGER4傳真頁數(shù)recvtimeINTEGER4接收時間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時0分0秒開始計算的秒數(shù)）recvflagINTEGER4接收標(biāo)志：0：電話線傳輸方式1：即時傳真?zhèn)鬏敺绞絛eviceidVARCHAR16傳真機(jī)SN碼，主要用在多路的情況下標(biāo)識傳真是從哪臺3G-FAX接收extinfoVARCHAR200擴(kuò)展信息ext1INTE

12、GER4擴(kuò)展字段1，固定為0ext2INTEGER4擴(kuò)展字段2，固定為0memoVARCHAR200備注readflagINTEGER4已讀標(biāo)識：0：未讀1：已讀五、SQL腳本參考1、MySQL：DROP TABLE IF EXISTS aofax_recv_task;CREATE TABLE aofax_recv_task ( taskid int(10) unsigned NOT NULL AUTO_INCREMENT, title varchar(200) DEFAULT NULL, ic int(10) unsigned DEFAULT NULL, ldc int(10) unsign

13、ed DEFAULT NULL, fax varchar(64) DEFAULT NULL, sender1 varchar(100) DEFAULT NULL, sender2 varchar(30) DEFAULT NULL, receiver1 varchar(100) DEFAULT NULL, receiver2 varchar(30) DEFAULT NULL, faxfile varchar(260) DEFAULT NULL, page int(10) unsigned DEFAULT NULL, recvtime int(10) unsigned DEFAULT NULL,

14、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) unsigned DEFAULT NULL, memo varchar(200) DEFAULT NULL, PRIMARY KEY (taskid), UNIQUE KEY taskid (taskid) ENGINE=MyISAM AUTO_INCREMENT=200 DEFA

15、ULT 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) DEFAULT NULL, ic int(10) unsigned DEFAULT NULL, ldc int(10) unsigned DEFAULT NULL, fax varchar(64) DEFAULT NULL, account varchar(20) DEFAULT NULL

16、, sender1 varchar(100) DEFAULT NULL, sender2 varchar(30) DEFAULT NULL, receiver1 varchar(100) DEFAULT NULL, receiver2 varchar(30) DEFAULT NULL, sendfile varchar(500) DEFAULT NULL, sendflag int(10) unsigned DEFAULT NULL, line int(10) unsigned DEFAULT NULL, status int(10) unsigned DEFAULT NULL, extinf

17、o varchar(200) DEFAULT NULL, retcode int(10) unsigned DEFAULT NULL, sendtime int(10) unsigned DEFAULT NULL, faxfile varchar(260) DEFAULT NULL, reserve1 int(10) unsigned DEFAULT NULL, reserve2 int(10) unsigned DEFAULT NULL, ext1 int(10) unsigned DEFAULT NULL, ext2 int(10) unsigned DEFAULT NULL, memo

18、varchar(200) DEFAULT NULL, PRIMARY KEY (taskid), UNIQUE KEY taskid (taskid) ENGINE=MyISAM AUTO_INCREMENT=3 DEFAULT CHARSET=latin1;2、SQL Server：if exists (select * from dbo.sysobjects where id = object_id(Naofax_send_task) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table aofax_send_taskGOif exists

19、 (select * from dbo.sysobjects where id = object_id(Naofax_recv_task) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table aofax_recv_taskGOCREATE TABLE aofax_send_task(taskidint IDENTITY (1, 1) PRIMARY KEY CLUSTERED NOT NULL,titlevarchar(200) NOT NULL DEFAULT (0),icint NOT NULL DEFAULT (0),ldcint NO

20、T NULL DEFAULT (0),faxvarchar(64) NOT NULL DEFAULT (0),accountvarchar(20) NOT NULL DEFAULT (0),sender1varchar(100) NOT NULL DEFAULT (0),sender2varchar(30) NOT NULL DEFAULT (0),receiver1varchar(100) NOT NULL DEFAULT (0),receiver2varchar(30) NOT NULL DEFAULT (0),sendfilevarchar(500) NOT NULL DEFAULT (

21、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 DEFAULT (0),sendtimeint NOT NULL DEFAULT (0),faxfilevarchar(260) NOT NULL DEFAULT (0),reserve1int NOT NULL DEFAULT (0),reserve2int NOT NULL DEF

22、AULT (0),ext1int NOT NULL DEFAULT (0),ext2int NOT NULL DEFAULT (0),memovarchar(200) NOT NULL DEFAULT (0),) ON PRIMARYGOCREATE TABLE aofax_recv_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),

23、faxvarchar(64) NOT NULL DEFAULT (0),sender1varchar(100) NOT NULL DEFAULT (0),sender2varchar(30) NOT NULL DEFAULT (0),receiver1varchar(100) NOT NULL DEFAULT (0),receiver2varchar(30) NOT NULL DEFAULT (0),faxfilevarchar(260) NOT NULL DEFAULT (0),pageint NOT NULL DEFAULT (0),recvtimeint NOT NULL DEFAULT

24、 (0),recvflagint NOT NULL DEFAULT (0),deviceidvarchar(16) NOT NULL DEFAULT (0),extinfovarchar(200) NOT NULL DEFAULT (0),ext1int NOT NULL DEFAULT (0),ext2int NOT NULL DEFAULT (0),memovarchar(200) NOT NULL DEFAULT (0),) ON PRIMARYGO3、Oracle：drop trigger aofax_send_task_trigger;drop sequence aofax_send

25、_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_task (taskidnumber(10),titlevarchar2(200),icnumber(10),ldcnumber(10),faxvarchar2(64),accountvarchar2(20),sender1varchar2(100),sender2varchar2

26、(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),subtypenumbe

27、r(10),PRIMARY KEY (taskid);create sequence aofax_send_task_seq start with 1 increment by 1 cache 5;create trigger aofax_send_task_trigger before insert on aofax_send_task for each row begin select aofax_send_task_seq.nextval into :new.taskid from dual;end;CREATE TABLE aofax_recv_task (taskidnumber(1

28、0),titlevarchar2(200),icnumber(10),ldcnumber(10),faxvarchar2(64),sender1varchar2(100),sender2varchar2(30),receiver1varchar2(100),receiver2varchar2(30),faxfilevarchar2(260),pagenumber(10),recvtimenumber(10),recvflagnumber(10),deviceidvarchar2(16),extinfovarchar2(200),ext1number(10),ext2number(10),mem

29、ovarchar2(200),readflagnumber(10),PRIMARY KEY (taskid);create sequence aofax_recv_task_seq start with 1 increment by 1 cache 5;create trigger aofax_recv_task_trigger before insert on aofax_recv_task for each row begin select aofax_recv_task_seq.nextval into :new.taskid from dual;end;commit;六、注意事項(xiàng)1、 默認(rèn)掃描數(shù)據(jù)庫打印時間間隔為30000毫秒（30S）。a. 修改時間：最少為15000毫秒（15S）b. 修改方法：打開傳真安裝目錄（D:Program FilesAOFAXAOFAX Advance Server）-打開EXTT