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

1、AOFAXK務器數(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傳真服務器組成,結構如下圖所示：3G-FAX企業(yè)應用服務器AOFAX傳真服務器接口實現(xiàn)了傳真的收發(fā)功能，收發(fā)過程如下：發(fā)送傳真：企業(yè)應用系統(tǒng)將待發(fā)送的傳真任務信息寫入中間數(shù)據(jù)庫系統(tǒng)，AOFAX傳真服務器從中間數(shù)據(jù)庫讀取發(fā)送任務，轉換后提交發(fā)送，發(fā)送完成后將發(fā)送結果回寫到中間數(shù)據(jù)庫，企業(yè)應用系

2、統(tǒng)從數(shù)據(jù)庫中讀取發(fā)送結果并進行后續(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)、接收任務表(aofax_recv_task)。表結構和創(chuàng)建腳本參考后續(xù)說明。3、創(chuàng)建ODBC數(shù)據(jù)源：在

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

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

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

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

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

8、，多個文件之間用“|”相隔（例如："C:fax1.txt|D:fax2.txt"）sendflagINTEGER4發(fā)送標志（必填）：0:普通發(fā)送1:優(yōu)先發(fā)送（排到當前發(fā)送隊列的首部）lineINTEGER4選擇線路（必填）：0:自動調度（先嘗試即時傳真，失敗后由電話線發(fā)送）1：僅電話線發(fā)送（fax不能為空）2：僅即時傳真發(fā)送（account不能為空）statusINTEGER4任務狀態(tài)：0：提交（等待轉換）1：發(fā)送（已轉換并排隊發(fā)送）2:成功（傳真發(fā)送成功）3:失?。▊髡姘l(fā)送失?。?：取消（傳真發(fā)送被取消）添加新任務時固定填寫為0,發(fā)送完成后狀態(tài)由系統(tǒng)回寫extinfoVA

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

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

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

12、SN碼，主要用在多路的情況下標識傳真是從哪臺3G-FAX接收extinfoVARCHAR200擴展信息ext1INTEGER4擴展字段1,固定為0ext2INTEGER4擴展字段2,固定為0memoVARCHAR200備注readflagINTEGER4已讀標識：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;六、注意事項1、默認掃描數(shù)據(jù)庫打印時間間隔為30000毫秒(30S)。a. 修改時間：最少為15000毫秒(15S)修改方法：打開傳真安裝目錄()-打開EXTTaskManager.ini，將配置節(jié)下的Interval值修改為15000,修改完成，數(shù)據(jù)庫打印時間修改為15S。2、以上第四部分的發(fā)送傳真任務表aofax_send_task中，紅色標記部分為發(fā)送