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

1、AOFAXK務(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-FAX企業(yè)應(yīng)用服務(wù)器AOFAX傳真服務(wù)器接口實(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)用系

2、統(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、準(zhǔn)備軟硬件環(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)、接收任務(wù)表(aofax_recv_task)。表結(jié)構(gòu)和創(chuàng)建腳本參考后續(xù)說明。3、創(chuàng)建ODBC數(shù)據(jù)源：在

3、AOFAX傳真服務(wù)器上創(chuàng)建相應(yīng)接口數(shù)據(jù)庫的ODBC數(shù)據(jù)源DSN項(xiàng)，并確保連接測(cè)試成功。4、配置AOFAX傳真服務(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）,用以保存企業(yè)應(yīng)用軟件提交的待發(fā)送傳真的文檔（文檔格式參考下面說明）。企業(yè)用戶在企業(yè)應(yīng)用軟件（如ERP、OA辦公管理等）中發(fā)送傳真時(shí)，發(fā)送界面中需要把要發(fā)送傳真的相

4、關(guān)信息體現(xiàn)出來，主要包括收發(fā)件人名、區(qū)號(hào)、傳真號(hào)碼、要發(fā)送的文檔名等信息。在提交發(fā)送時(shí)把這些信息保存到中間數(shù)據(jù)庫的AOFAX發(fā)送任務(wù)表（aofax_send_task）中，同時(shí)把要發(fā)送傳真的文檔提交到AOFAX傳真服務(wù)器上的臨時(shí)文件夾中，即上述在AOFAX傳真服務(wù)器上創(chuàng)建的臨時(shí)文件夾（注意，在填寫發(fā)送文檔路徑字段時(shí)，要填寫絕對(duì)路徑，例如：AOFAX傳真服務(wù)器上新建的臨時(shí)文件夾為"C:fSendFax”，提交的待發(fā)送的文檔名稱為"abc.doc”，則在填寫發(fā)送任務(wù)表的"sendfile”字段時(shí)，應(yīng)填寫"C:fSendFaxabc.doc"）。文檔

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

6、器端轉(zhuǎn)換成傳真格式文件（.sfx）的，因此，如果要發(fā)送某種格式的文檔時(shí)，這種格式的瀏覽器或編輯軟件必須安裝在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ù)庫表結(jié)構(gòu)發(fā)送傳真任務(wù)表表名:aofax_send_task字段名類型長度（字節(jié)）說明taskidINTEGER4任務(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）senderlVARCHAR100發(fā)件人1,標(biāo)識(shí)傳真發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2,標(biāo)識(shí)傳真發(fā)件人，如人名等receiverlVARCHAR100收件人1,標(biāo)識(shí)傳真收件人，如公司名receiver2VARCHAR30收件人2,標(biāo)識(shí)傳真收件人，如人名等sendfileVARCHAR500待發(fā)送文件名（必填，絕對(duì)路徑）

8、，多個(gè)文件之間用“|”相隔（例如："C:fax1.txt|D:fax2.txt"）sendflagINTEGER4發(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í)固定填寫為0,發(fā)送完成后狀態(tài)由系統(tǒng)回寫extinfoVA

9、RCHAR200擴(kuò)展信息retcodeINTEGER4結(jié)果碼，發(fā)送完成后由系統(tǒng)回寫：0:未知原因1:忙2:無撥號(hào)音3:無應(yīng)答4：文件格式錯(cuò)5:發(fā)送頁前信號(hào)中斷6:線路訓(xùn)練失敗7:發(fā)送頁后信號(hào)中斷8:用戶取消9:超時(shí)無應(yīng)答20:待發(fā)送文件錯(cuò)誤21:系統(tǒng)讀寫錯(cuò)誤22:打印轉(zhuǎn)換錯(cuò)誤sendtimeINTEGER4發(fā)送時(shí)間（標(biāo)準(zhǔn)Ctime_t格式，從1970年1月1日0時(shí)0分0秒開女含計(jì)算的秒數(shù)），發(fā)送完成后由系統(tǒng)回寫faxfileVARCHAR260轉(zhuǎn)換后傳真文件名（TIF格式，絕對(duì)路徑），發(fā)送完成后由系統(tǒng)回寫reservelINTEGER4保留字段1,固定填0reserve2INTEGER4保留字

10、段2,固定填0extlINTEGER4擴(kuò)展字段1,固定填0ext2INTEGER4擴(kuò)展字段2,固定填0memoVARCHAR200備注subtypeINTEGER4提交類型：0:接口提交1:客戶端提交接收傳真任務(wù)表表名:aofax_recv_task字段名類型長度（字節(jié)）說明taskidINTEGER4任務(wù)ID,主鍵，自增長titleVARCHAR200傳真主題icINTEGER4國際區(qū)號(hào)（發(fā)送萬）ldcINTEGER4長途區(qū)號(hào)（發(fā)送萬）faxVARCHAR64傳真號(hào)碼（發(fā)送力傳真號(hào)碼，即時(shí)傳真時(shí)為“傳真號(hào)碼/傲發(fā)號(hào)”，如“83235170/AF90000099）”sender1VARCHAR

11、100發(fā)件人1,標(biāo)識(shí)傳真發(fā)件人，如公司名sender2VARCHAR30發(fā)件人2,標(biāo)識(shí)傳真發(fā)件人，如人名等receiver1VARCHAR100收件人1,標(biāo)識(shí)傳真收件人，如公司名、部門等receiver2VARCHAR30收件人2,標(biāo)識(shí)傳真收件人，如人名、分機(jī)號(hào)等faxfileVARCHAR260傳真文件名（絕對(duì)路徑，TIF格式）pageINTEGER4傳真頁數(shù)recvtimeINTEGER4接收時(shí)間（標(biāo)準(zhǔn)Ctime_t格式，從1970年1月1日0時(shí)0分0秒開女含計(jì)算的秒數(shù)）recvflagINTEGER4接收標(biāo)志：0:電話線傳輸方式1:即時(shí)傳真?zhèn)鬏敺绞絛eviceidVARCHAR16傳真機(jī)

12、SN碼，主要用在多路的情況下標(biāo)識(shí)傳真是從哪臺(tái)3G-FAX接收extinfoVARCHAR200擴(kuò)展信息ext1INTEGER4擴(kuò)展字段1,固定為0ext2INTEGER4擴(kuò)展字段2,固定為0memoVARCHAR200備注readflagINTEGER4已讀標(biāo)識(shí)：0:未讀1:已讀五、SQL腳本參考1、MySQL:DROPTABLEIFEXISTSaofax_recv_task;CREATETABLEaofax_recv_task(taskidint(10)unsignedNOTNULLAUTO_INCREMENT,titlevarchar(200)DEFAULTNULL,icint(10)un

13、signedDEFAULTNULL,ldcint(10)unsignedDEFAULTNULL,faxvarchar(64)DEFAULTNULL,sender1varchar(100)DEFAULTNULL,sender2varchar(30)DEFAULTNULL,receiver1varchar(100)DEFAULTNULL,receiver2varchar(30)DEFAULTNULL,faxfilevarchar(260)DEFAULTNULL,pageint(10)unsignedDEFAULTNULL,recvtimeint(10)unsignedDEFAULTNULL,rec

14、vflagint(10)unsignedDEFAULTNULL,deviceidvarchar(16)DEFAULTNULL,extinfovarchar(200)DEFAULTNULL,ext1int(10)unsignedDEFAULTNULL,ext2int(10)unsignedDEFAULTNULL,memovarchar(200)DEFAULTNULL,PRIMARYKEY(taskid),UNIQUEKEYtaskid(taskid)ENGINE=MyISAMAUTO_INCREMENT=200DEFAULTCHARSET=latin1;DROPTABLEIFEXISTSaofa

15、x_send_task;CREATETABLEaofax_send_task(taskidint(10)unsignedNOTNULLAUTO_INCREMENT,titlevarchar(200)DEFAULTNULL,icint(10)unsignedDEFAULTNULL,ldcint(10)unsignedDEFAULTNULL,faxvarchar(64)DEFAULTNULL,accountvarchar(20)DEFAULTNULL,senderlvarchar(100)DEFAULTNULL,sender2varchar(30)DEFAULTNULL,receiver1varc

16、har(100)DEFAULTNULL,receiver2varchar(30)DEFAULTNULL,sendfilevarchar(500)DEFAULTNULL,sendflagint(10)unsignedDEFAULTNULL,lineint(10)unsignedDEFAULTNULL,statusint(10)unsignedDEFAULTNULL,extinfovarchar(200)DEFAULTNULL,retcodeint(10)unsignedDEFAULTNULL,sendtimeint(10)unsignedDEFAULTNULL,faxfilevarchar(26

17、0)DEFAULTNULL,reserve1int(10)unsignedDEFAULTNULL,reserve2int(10)unsignedDEFAULTNULL,ext1int(10)unsignedDEFAULTNULL,ext2int(10)unsignedDEFAULTNULL,memovarchar(200)DEFAULTNULL,PRIMARYKEY(taskid),UNIQUEKEYtaskid(taskid)ENGINE=MyISAMAUTO_INCREMENT=3DEFAULTCHARSET=latin1;2、SQLServer:ifexists(select*fromd

18、bo.sysobjectswhereid=object_id(N'aofax_send_task')andOBJECTPROPERTY(id,N'IsUserTable')=1)droptableaofax_send_taskGOifexists(select*fromdbo.sysobjectswhereid=object_id(N'aofax_recv_task')andOBJECTPROPERTY(id,N'IsUserTable')=1)droptableaofax_recv_taskGOCREATETABLEaofax_

19、send_task(taskidintIDENTITY(1,1)PRIMARYKEYCLUSTEREDNOTNULL,titlevarchar(200)NOTNULLDEFAULT(0),icintNOTNULLDEFAULT(0),ldcintNOTNULLDEFAULT(0),faxvarchar(64)NOTNULLDEFAULT(0),accountvarchar(20)NOTNULLDEFAULT(0),sender1varchar(100)NOTNULLDEFAULT(0),sender2varchar(30)NOTNULLDEFAULT(0),receiver1varchar(1

20、00)NOTNULLDEFAULT(0),receiver2varchar(30)NOTNULLDEFAULT(0),sendfilevarchar(500)NOTNULLDEFAULT(0),sendflagintNOTNULLDEFAULT(0),lineintNOTNULLDEFAULT(0),statusintNOTNULLDEFAULT(0),extinfovarchar(200)NOTNULLDEFAULT(0),retcodeintNOTNULLDEFAULT(0),sendtimeintNOTNULLDEFAULT(0),faxfilevarchar(260)NOTNULLDE

21、FAULT(0),reserve1intNOTNULLDEFAULT(0),reserve2intNOTNULLDEFAULT(0),ext1intNOTNULLDEFAULT(0),ext2intNOTNULLDEFAULT(0),memovarchar(200)NOTNULLDEFAULT(0),)ONPRIMARYGOCREATETABLEaofax_recv_task(taskidintIDENTITY(1,1)PRIMARYKEYCLUSTEREDNOTNULL,titlevarchar(200)NOTNULLDEFAULT(0),icintNOTNULLDEFAULT(0),ldc

22、intNOTNULLDEFAULT(0),faxvarchar(64)NOTNULLDEFAULT(0),sender1varchar(100)NOTNULLDEFAULT(0),sender2varchar(30)NOTNULLDEFAULT(0),receiver1varchar(100)NOTNULLDEFAULT(0),receiver2varchar(30)NOTNULLDEFAULT(0),faxfilevarchar(260)NOTNULLDEFAULT(0),pageintNOTNULLDEFAULT(0),recvtimeintNOTNULLDEFAULT(0),recvfl

23、agintNOTNULLDEFAULT(0),deviceidvarchar(16)NOTNULLDEFAULT(0),extinfovarchar(200)NOTNULLDEFAULT(0),ext1intNOTNULLDEFAULT(0),ext2intNOTNULLDEFAULT(0),memovarchar(200)NOTNULLDEFAULT(0),)ONPRIMARYGO3、Oracle:droptriggeraofax_send_task_trigger;dropsequenceaofax_send_task_seq;droptableaofax_send_task;droptr

24、iggeraofax_recv_task_trigger;dropsequenceaofax_recv_task_seq;droptableaofax_recv_task;CREATETABLEaofax_send_task(taskidnumber(10),titlevarchar2(200),icnumber(10),ldcnumber(10),faxvarchar2(64),accountvarchar2(20),sender1varchar2(100),sender2varchar2(30),receiver1varchar2(100),receiver2varchar2(30),se

25、ndfilevarchar2(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),subtypenumber(10),PRIMARYKEY(taskid);createsequenceaofax_send_ta

26、sk_seqstartwith1incrementby1cache5;createtriggeraofax_send_task_triggerbeforeinsertonaofax_send_taskforeachrowbeginselectaofax_send_task_seq.nextvalinto:new.taskidfromdual;end;CREATETABLEaofax_recv_task(taskidnumber(10),titlevarchar2(200),icnumber(10),ldcnumber(10),faxvarchar2(64),sender1varchar2(10

27、0),sender2varchar2(30),receiver1varchar2(100),receiver2varchar2(30),faxfilevarchar2(260),pagenumber(10),recvtimenumber(10),recvflagnumber(10),deviceidvarchar2(16),extinfovarchar2(200),ext1number(10),ext2number(10),memovarchar2(200),readflagnumber(10),PRIMARYKEY(taskid);createsequenceaofax_recv_task_

28、seqstartwith1incrementby1cache5;createtriggeraofax_recv_task_triggerbeforeinsertonaofax_recv_taskforeachrowbeginselectaofax_recv_task_seq.nextvalinto:new.taskidfromdual;end;commit;六、注意事項(xiàng)1、默認(rèn)掃描數(shù)據(jù)庫打印時(shí)間間隔為30000毫秒(30S)。a. 修改時(shí)間：最少為15000毫秒(15S)修改方法：打開傳真安裝目錄()-打開EXTTaskManager.ini，將配置節(jié)下的Interval值修改為15000,修改完成，數(shù)據(jù)庫打印時(shí)間修改為15S。2、以上第四部分的發(fā)送傳真任務(wù)表aofax_send_task中，紅色標(biāo)記部分為發(fā)送