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

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

3、CHAR70傳真號碼（如87654321；01081234567）usernameVARCHAR100提交任務的用戶名（對應傳真管理器中的用戶姓名或者公共文件夾名稱（必須支持發件箱），如果填寫的名稱在傳真服務器上存在的話，則發送記錄同時保存到該用戶或公共文件夾發件箱中，如果不存在，則發送記錄保存到服務器上默認的系統公共文件夾（默認對所有設備有效）。SenderVARCHAR100發件人，標識傳真發件人，如公司名ReceiverVARCHAR100收件人，標識傳真收件人，如公司名submodeINTEGER4提交文件方式。Default=00=絕對路徑；1=局域網絡共享文件路徑2=URL方式指定

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

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

6、ULLTransFileNameVARCHAR260轉換后傳真文件名（TIF或PDF格式，絕對路徑），發送完成后由系統回寫LevelINTEGER4發送標志（必填，default=0）：數值越大，優先級越高0：低優先級；1：普通優先級；2：高優先級LineINTEGER4選擇線路（必填）：default=00：自動調度；1：選擇第一條線路；2：選擇第二條線路其他為選擇線路發送，暫不支持StatusINTEGER4任務狀態：default=00：提交（等待轉換）1：等待發送（傳真服務器已從數據庫讀取該記錄）2：完成（任務處理完成，結果根據retcode判斷）添加新任務時固定填寫為0，發送結束后狀

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

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

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

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

11、段。Exitstr2VARCHAR260擴展字符串字段2，字符串類型的發送時間，如：2014/6/16 17:20:20（年/月/日 時:分:秒）由系統自動填寫，功能上等同數字類型的txtime。紅色字體標識的為OA接口必填項目或注意地方，藍色為建議填寫項目。接收傳真任務表表名：elm_receivetask字段名類型長度（字節）說明TaskidINTEGER4任務ID，主鍵，自增長dbaverINTEGER4DBA二次開發數據庫接口版本，default=0subjectVARCHAR200傳真主題usernameVARCHAR100傳真接收的用戶，對應服務器上的用戶名稱faxphoneVAR

12、CHAR70傳真號碼（發送方傳真號碼或來電顯示，如83235170）SenderVARCHAR100發件人1，標識傳真發件人，如公司名receiverVARCHAR100收件人1，標識傳真收件人，如公司名、部門等extensionVARCHAR20分機號碼FilenameVARCHAR260傳真文件名（TIF或PDF格式）。具體格式參考submode字段receivefileMYSQL：LONGBLOBMSSQL2005以后：varbinary(max)MSSQL2000：IMAGEORACLE：BLOB服務器端設定了保存傳真文件到數據庫功能時，該字段保存傳真文件的正文BLOB類型Defaul

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

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

15、（ODBC）”，如圖所示，在系統DSN（因為傳真服務器采用標準windows服務訪問方式，因此添加數據源必須是系統DSN）中點擊“添加”按鈕，在桌面彈出窗口中選擇對應的數據庫驅動程序，根據系統提示，完成數據源的創建。2、易發聯傳真服務器DBA接口配置在傳真服務器登錄完成窗口中打開“程序選項”窗口，并選擇“數據庫接口選項”，如圖所示。在配置窗口中，正確填寫創建的數據源名稱，數據庫用戶賬戶名稱和密碼。勾選“啟用數據庫接口收發傳真功能”選項。默認情況下，傳真服務器每隔60秒從數據源中讀一次傳真記錄；用戶可以根據需要自行設定（不建議設置時間太短，否則會增加數據庫的訪問，降低系統效率）。傳真系統支持保留

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

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