易發(fā)聯(lián)中間數(shù)據(jù)庫二次開發(fā)接口說明

1、易發(fā)聯(lián)中間數(shù)據(jù)庫二次開發(fā)接口說明易發(fā)聯(lián)傳真服務(wù)器真正支持Windows“服務(wù)”的方式，可以在任意電腦上共享或多人同時(shí)遠(yuǎn)程管理。易發(fā)聯(lián)傳真服務(wù)器采用高端的傳真板卡（易發(fā)聯(lián)33.6Kbps高速傳真卡、進(jìn)口卡DIALOG或者國產(chǎn)卡三匯傳真卡），配置靈活，可自備服務(wù)器，支持OEM定制開發(fā)等。一、支持的數(shù)據(jù)庫DBMS目前支持的數(shù)據(jù)庫包括MS SQLSERVER2000（sp4以上），MS SQL2005及以上版本；MYSQL 5.0版本；ORACLE 8.0以上。易發(fā)聯(lián)服務(wù)器軟件訪問數(shù)據(jù)庫的方式為ODBC數(shù)據(jù)源（DSN）的方式。因此，對(duì)于上述幾種數(shù)據(jù)庫，在傳真服務(wù)器上必須正確安裝相關(guān)的ODBC驅(qū)動(dòng)程序。

2、傳真服務(wù)器的數(shù)據(jù)庫名稱，可以用戶自定義，比如可以定義為elm_database。傳真發(fā)送表的名稱固定為：elm_sendtask；傳真接收表的名稱固定為：elm_receivetask。已經(jīng)定義好的表結(jié)構(gòu)字段名稱不能隨意改動(dòng)，OA軟件處理時(shí)，如果字段不夠使用，可以自行任意擴(kuò)展，但每個(gè)擴(kuò)展字段必須有默認(rèn)值。二、DBA二次開發(fā)數(shù)據(jù)庫表結(jié)構(gòu)定義發(fā)送傳真任務(wù)表表名：elm_sendtask字段名類型長度（字節(jié)）說明taskidINTEGER4任務(wù)ID，主鍵，自增長dbaverINTEGER4DBA二次開發(fā)數(shù)據(jù)庫接口版本，default=0SubjectVARCHAR200傳真主題faxphoneVAR

3、CHAR70傳真號(hào)碼（如87654321；01081234567）usernameVARCHAR100提交任務(wù)的用戶名（對(duì)應(yīng)傳真管理器中的用戶姓名或者公共文件夾名稱（必須支持發(fā)件箱），如果填寫的名稱在傳真服務(wù)器上存在的話，則發(fā)送記錄同時(shí)保存到該用戶或公共文件夾發(fā)件箱中，如果不存在，則發(fā)送記錄保存到服務(wù)器上默認(rèn)的系統(tǒng)公共文件夾（默認(rèn)對(duì)所有設(shè)備有效）。SenderVARCHAR100發(fā)件人，標(biāo)識(shí)傳真發(fā)件人，如公司名ReceiverVARCHAR100收件人，標(biāo)識(shí)傳真收件人，如公司名submodeINTEGER4提交文件方式。Default=00=絕對(duì)路徑；1=局域網(wǎng)絡(luò)共享文件路徑2=URL方式指定

4、路徑3=文件正文保存在數(shù)據(jù)庫sendfile字段中4=僅文件名，文件路徑在在數(shù)據(jù)庫接口配置頁面中配置Other=暫不支持filenameVARCHAR500待發(fā)送文件。Filename指定的文件方式依賴字段submode的值。1、 submode=0時(shí)filename表示文件的絕對(duì)路徑，多個(gè)文件之間用“|”相隔（例如： “D:EasyfaxServerInterFile傳真.doc”）。2、submode=1時(shí)filename表示局域網(wǎng)共享文件路徑，多個(gè)文件之間用“|”相隔（例如：docfax.doc）3、submode=2時(shí)此時(shí)filename標(biāo)識(shí)的是以URL HTTP

5、形式表示的文件地址（此時(shí)只能填寫一個(gè)文件）。（例如：HTTP:/WWW.TEST.COM/FAX/TESTFILE.DOC）4、submode=3時(shí)此時(shí)，filename標(biāo)識(shí)文件名，如“傳真.doc”（該字段只能填寫一個(gè)文件名）；同時(shí)sendfile字段為當(dāng)前文件的正文。5、submode=4時(shí)Filename標(biāo)識(shí)文件名，多個(gè)文件之間用“|”相隔（例如： “傳真.doc”）。SendfileMYSQL：LONGBLOBMSSQL2005以后：varbinary(max)MSSQL2000：IMAGEORACLE：BLOBsubmode=3時(shí)，該字段是要發(fā)送的文檔二進(jìn)制正文對(duì)象default=N

6、ULLTransFileNameVARCHAR260轉(zhuǎn)換后傳真文件名（TIF或PDF格式，絕對(duì)路徑），發(fā)送完成后由系統(tǒng)回寫LevelINTEGER4發(fā)送標(biāo)志（必填，default=0）：數(shù)值越大，優(yōu)先級(jí)越高0：低優(yōu)先級(jí)；1：普通優(yōu)先級(jí)；2：高優(yōu)先級(jí)LineINTEGER4選擇線路（必填）：default=00：自動(dòng)調(diào)度；1：選擇第一條線路；2：選擇第二條線路其他為選擇線路發(fā)送，暫不支持StatusINTEGER4任務(wù)狀態(tài)：default=00：提交（等待轉(zhuǎn)換）1：等待發(fā)送（傳真服務(wù)器已從數(shù)據(jù)庫讀取該記錄）2：完成（任務(wù)處理完成，結(jié)果根據(jù)retcode判斷）添加新任務(wù)時(shí)固定填寫為0，發(fā)送結(jié)束后狀

7、態(tài)由系統(tǒng)回寫RetcodeINTEGER4結(jié)果碼，發(fā)送完成后由系統(tǒng)回寫0=成功1=未知原因2=忙3=無撥號(hào)音4=無應(yīng)答5=傳真文件格式錯(cuò)6=發(fā)送傳真頁前協(xié)商階段B斷開連接7=線路訓(xùn)練失敗8=傳真發(fā)送階段失敗9=傳真發(fā)送頁后協(xié)商階段D斷開連接10=用戶取消11=超時(shí)12=線路錯(cuò)誤異常13=撥號(hào)號(hào)碼格式錯(cuò)誤14=傳真收發(fā)階段錯(cuò)誤(U口)15=傳真意外中斷(U口)16=創(chuàng)建文件失敗17=設(shè)備無回應(yīng)(U口)18=本地電話線路占用19=本地未連接電話線路20=待發(fā)送文件錯(cuò)誤21=系統(tǒng)讀寫錯(cuò)誤22=權(quán)限錯(cuò)誤（無發(fā)送權(quán)限等）23=打印轉(zhuǎn)換時(shí)出錯(cuò)24=沒有附件或附件不存在25=收件人信息格式錯(cuò)誤或不完整26=

8、文檔不支持自動(dòng)轉(zhuǎn)換27=接收方不是傳真設(shè)備28=接收方拒絕接收（URL HTTP方式）100=連接服務(wù)器失敗101=文件下載失敗subtimeINTEGER4任務(wù)提交時(shí)間（用戶自己填寫）（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒開始計(jì)算的秒數(shù)）該字段已經(jīng)不再使用，默認(rèn)填0即可。scheduletimeINTEGER4計(jì)劃發(fā)送時(shí)間（用戶自己填寫）（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒開始計(jì)算的秒數(shù)）, 默認(rèn)填0即可。（功能上等同于字符串類型的自動(dòng)extstr1）txtimeINTEGER4發(fā)送時(shí)間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒

9、開始計(jì)算的秒數(shù)），發(fā)送完成后由系統(tǒng)回寫功能上等同數(shù)字類型的字段extstr2tasksubtypeINTEGER4提交類型 default=00：DBA接口提交1：其他方式提交（客戶端或email）該字段僅供OA軟件判斷傳真提交的方式readflagINTEGER4已讀標(biāo)識(shí)0：未讀；1：已讀serveridINTEGER4服務(wù)器ID Default=0在多臺(tái)服務(wù)器同時(shí)處理接口中的任務(wù)時(shí)，標(biāo)識(shí)傳真發(fā)送時(shí)實(shí)際從那一臺(tái)服務(wù)器出去的。服務(wù)器ID在傳真服務(wù)器上配置（傳真服務(wù)器安裝時(shí)，默認(rèn)的服務(wù)器ID為1，多臺(tái)服務(wù)器處理時(shí)，建議把不同傳真服務(wù)器的ID值配置為不同值）。在添加新發(fā)送記錄時(shí)，serverid必

10、須=0；非0值由傳真系統(tǒng)回寫linenameVARCHAR100實(shí)際發(fā)送傳真的線路名稱或標(biāo)識(shí)（在傳真服務(wù)器上配置線路設(shè)備名稱），由傳真系統(tǒng)回寫Extint1INTEGER4擴(kuò)展字段1，默認(rèn)為0Extint2INTEGER4擴(kuò)展字段2，默認(rèn)為0Extstr1VARCHAR260Default=null擴(kuò)展字符串字段1，字符串類型的計(jì)劃發(fā)送時(shí)間，如：2014/6/16 17:20:20（年/月/日 時(shí):分:秒）功能上等同于數(shù)字類型的字段scheduletime。如果使用Extstr1作為計(jì)劃發(fā)送的時(shí)間，則scheduletime填寫為0；如果scheduletime為非0則自動(dòng)忽略extstr1字

11、段。Exitstr2VARCHAR260擴(kuò)展字符串字段2，字符串類型的發(fā)送時(shí)間，如：2014/6/16 17:20:20（年/月/日 時(shí):分:秒）由系統(tǒng)自動(dòng)填寫，功能上等同數(shù)字類型的txtime。紅色字體標(biāo)識(shí)的為OA接口必填項(xiàng)目或注意地方，藍(lán)色為建議填寫項(xiàng)目。接收傳真任務(wù)表表名：elm_receivetask字段名類型長度（字節(jié)）說明TaskidINTEGER4任務(wù)ID，主鍵，自增長dbaverINTEGER4DBA二次開發(fā)數(shù)據(jù)庫接口版本，default=0subjectVARCHAR200傳真主題usernameVARCHAR100傳真接收的用戶，對(duì)應(yīng)服務(wù)器上的用戶名稱faxphoneVAR

12、CHAR70傳真號(hào)碼（發(fā)送方傳真號(hào)碼或來電顯示，如83235170）SenderVARCHAR100發(fā)件人1，標(biāo)識(shí)傳真發(fā)件人，如公司名receiverVARCHAR100收件人1，標(biāo)識(shí)傳真收件人，如公司名、部門等extensionVARCHAR20分機(jī)號(hào)碼FilenameVARCHAR260傳真文件名（TIF或PDF格式）。具體格式參考submode字段receivefileMYSQL：LONGBLOBMSSQL2005以后：varbinary(max)MSSQL2000：IMAGEORACLE：BLOB服務(wù)器端設(shè)定了保存?zhèn)髡嫖募綌?shù)據(jù)庫功能時(shí)，該字段保存?zhèn)髡嫖募恼腂LOB類型Defaul

13、t:NULLsubmodeINTEGER4傳真文件寫入數(shù)據(jù)庫的方式：default=00=僅文件名（Filename為文件的絕對(duì)路徑）1=文件名+文件正文（Filename為文件的絕對(duì)路徑；receivefile為接收文件的正文，二進(jìn)制BLOB存儲(chǔ)）2=僅文件名，路徑在數(shù)據(jù)庫接口配置選項(xiàng)中配置PageINTEGER4傳真頁數(shù)rxtimeINTEGER4接收時(shí)間（標(biāo)準(zhǔn)C time_t格式，從1970年1月1日0時(shí)0分0秒開始計(jì)算的秒數(shù)）功能上等同字符串類型的字段extstr1。linenameVARCHAR100主要用在多路的情況下標(biāo)識(shí)傳真是從哪條線路過來readflagINTEGER4已讀標(biāo)識(shí)

14、0：未讀；1：已讀serveridINTEGER4服務(wù)器ID，在多臺(tái)服務(wù)器接收傳真回寫數(shù)據(jù)庫，標(biāo)識(shí)當(dāng)前傳真是哪臺(tái)服務(wù)器接收的。服務(wù)器ID可以在服務(wù)器上指定Extint1INTEGER4擴(kuò)展字段1，默認(rèn)為0Extint2INTEGER4擴(kuò)展字段2，默認(rèn)為0Extstr1VARCHAR260擴(kuò)展字符串字段1，字符串類型的接收時(shí)間，如：2014/6/16 17:20:20（年/月/日 時(shí):分:秒）由系統(tǒng)自動(dòng)填寫，功能上等同數(shù)字類型的rxtime。Exitstr2VARCHAR260擴(kuò)展字符串字段2，默認(rèn)為空三、數(shù)據(jù)庫接口配置說明1、配置數(shù)據(jù)源在WINDOWS控制面板à管理工具中打開“數(shù)據(jù)源

15、（ODBC）”，如圖所示，在系統(tǒng)DSN（因?yàn)閭髡娣?wù)器采用標(biāo)準(zhǔn)windows服務(wù)訪問方式，因此添加數(shù)據(jù)源必須是系統(tǒng)DSN）中點(diǎn)擊“添加”按鈕，在桌面彈出窗口中選擇對(duì)應(yīng)的數(shù)據(jù)庫驅(qū)動(dòng)程序，根據(jù)系統(tǒng)提示，完成數(shù)據(jù)源的創(chuàng)建。2、易發(fā)聯(lián)傳真服務(wù)器DBA接口配置在傳真服務(wù)器登錄完成窗口中打開“程序選項(xiàng)”窗口，并選擇“數(shù)據(jù)庫接口選項(xiàng)”，如圖所示。在配置窗口中，正確填寫創(chuàng)建的數(shù)據(jù)源名稱，數(shù)據(jù)庫用戶賬戶名稱和密碼。勾選“啟用數(shù)據(jù)庫接口收發(fā)傳真功能”選項(xiàng)。默認(rèn)情況下，傳真服務(wù)器每隔60秒從數(shù)據(jù)源中讀一次傳真記錄；用戶可以根據(jù)需要自行設(shè)定（不建議設(shè)置時(shí)間太短，否則會(huì)增加數(shù)據(jù)庫的訪問，降低系統(tǒng)效率）。傳真系統(tǒng)支持保留

16、或自動(dòng)刪除通過接口提交的文檔附件原稿，用戶根據(jù)需要配置即可。如果需要把從傳真客戶端提交發(fā)送的傳真記錄回寫到數(shù)據(jù)庫時(shí)，勾選“非數(shù)據(jù)庫接口提交的傳真發(fā)送結(jié)束后，記錄回寫到數(shù)據(jù)庫”選項(xiàng)即可。默認(rèn)條件下，接收的傳真記錄，在寫數(shù)據(jù)庫時(shí)，僅寫入文件名，如果需要的話，可以勾選“保存接收傳真正文內(nèi)容到數(shù)據(jù)庫”選項(xiàng)（建議用戶從數(shù)據(jù)庫讀取后，從數(shù)據(jù)庫刪除正文內(nèi)容，否則會(huì)明顯降低數(shù)據(jù)庫訪問效率）。3、支持的附件格式數(shù)據(jù)庫接口中提交的文檔格式可以是以下格式，如doc，xls，txt，wri，tif，jpg，pdf 等。同時(shí)要求在傳真服務(wù)器端正確安裝了以上格式的軟件，并支持自動(dòng)轉(zhuǎn)換功能，提交的文檔中確定沒有密

17、碼等安全設(shè)定。4、傳真服務(wù)器端要求與配置傳真服務(wù)器安裝時(shí)自動(dòng)向系統(tǒng)中注冊(cè)了EasyLanfax服務(wù)模塊，必須將EasyLanfax服務(wù)和本機(jī)Windows賬戶關(guān)聯(lián)起來，即讓EasyLanfax做為本機(jī)賬戶的服務(wù)運(yùn)行。安裝完傳真服務(wù)器后，做如下修改：打開Windows控制面板，找到“管理工具”，在“管理工具”中找到“服務(wù)”圖標(biāo)雙擊運(yùn)行，如下圖所示，在“服務(wù)”管理窗口中搜索“EasyLanfax”服務(wù)，找到后雙擊打開，先停止運(yùn)行服務(wù)，然后選擇“登錄”屬性頁，如圖所示。按圖中選擇登錄身份，輸入本機(jī)Windows賬戶名稱、密碼（建議最好輸入具有管理員權(quán)限的賬戶）。點(diǎn)擊確定，然后重新運(yùn)行服務(wù)即可。Windows服務(wù)管理窗口EasyLanfax服務(wù)屬性窗口四、數(shù)據(jù)庫接口使用說明或注意事項(xiàng)1、關(guān)于MYS