二次开发数据库接口说明2.0-易发联.DOC

易发联中间数据库二次开发接口说明 易发联传真服务器真正支持Windows“服务”的方式，可以在任意电脑上共享或多人同时远程管理。易发联传真服务器采用高端的传真板卡（易发联33.6Kbps高速传真卡、进口卡DIALOG或者国产卡三汇传真卡），配置灵活，可自备服务器，支持OEM定制开发等。 一、支持的数据库DBMS 目前支持的数据库包括MS SQLSERVER2000（sp4以上），MS SQL2005及以上版本；MYSQL 5.0版本；ORACLE 8.0以上。 易发联服务器软件访问数据库的方式为ODBC数据源（DSN）的方式。因此，对于上述几种数据库，在传真服务器上必须正确安装相关的ODBC驱动程序。 传真服务器的数据库名称，可以用户自定义，比如可以定义为elm_database。传真发送表的名称固定为：elm_sendtask；传真接收表的名称固定为：elm_receivetask。已经定义好的表结构字段名称不能随意改动，OA软件处理时，如果字段不够使用，可以自行任意扩展，但每个扩展字段必须有默认值。 二、DBA二次开发数据库表结构定义 发送传真任务表 表名：elm_sendtask 字段名 类型 长度（字节） 说明 taskid INTEGER 4 任务ID，主键，自增长 dbaver INTEGER 4 DBA二次开发数据库接口版本，default=0 Subject VARCHAR 200 传真主题 faxphone VARCHAR 70 传真号码（01081234567） username VARCHAR 100 提交任务的用户名（对应传真管理器中的用户姓名或者公共文件夹名称（必须支持发件箱）），如果填写的名称在传真服务器上存在的话，则发送记录同时保存到该用户或公共文件夹发件箱中，如果不存在，则发送记录保存到服务器上默认的系统公共文件夹（默认对所有设备有效）。 Sender VARCHAR 100 发件人，标识传真发件人，如公司名 Receiver VARCHAR 100 收件人，标识传真收件人，如公司名 submode INTEGER 4 提交文件方式。Default=0 0=绝对路径； 1=局域网络共享文件路径 2=URL方式指定路径 3=文件正文保存在数据库sendfile字段中 4=仅文件名，文件路径在在数据库接口配置页面中配置 Other=暂不支持 filename VARCHAR 500 待发送文件。Filename指定的文件方式依赖字段submode的值。 submode=0时 filename表示文件的绝对路径，多个文件之间用“|”相隔（例如： “D:\EasyfaxServer\InterFile\传真.doc”）。 2、submode=1时 filename表示局域网共享文件路径，多个文件之间用“|”相隔（例如：\\\doc\fax.doc） 3、submode=2时 此时filename标识的是以URL HTTP形式表示的文件地址（此时只能填写一个文件）。（例如：HTTP://WWW.TEST.COM/FAX/TESTFILE.DOC） 4、submode=3时 此时，filename标识文件名，如“传真.doc”（该字段只能填写一个文件名）；同时sendfile字段为当前文件的正文。 5、submode=4时 Filename标识文件名，多个文件之间用“|”相隔（例如： “传真.doc”）。 Sendfile MYSQL：LONGBLOB MSSQL2005以后： varbinary(max) MSSQL2000：IMAGE ORACLE：BLOB submode=3时，该字段是要发送的文档二进制正文对象 default=NULL TransFileName VARCHAR 260 转换后传真文件名（TIF或PDF格式，绝对路径），发送完成后由系统回写 Level INTEGER 4 发送标志（必填，default=0）：数值越大，优先级越高 0：低优先级；1：普通优先级；2：高优先级 Line INTEGER 4 选择线路（必填）：default=0 0：自动调度；1：选择第一条线路；2：选择第二条线路…… 其他为选择线路发送，暂不支持 Status INTEGER 4 任务状态：default=0 0：提交（等待转换） 1：等待发送（传真服务器已从数据库读取该记录） 2：完成（任务处理完成，结果根据retcode判断） 添加新任务时固定填写为0，发送结束后状态由系统回写 Retcode INTEGER 4 结果码，发送完成后由系统回写 0=成功 1=未知原因 2=忙 3=无拨号音 4=无应答 5=传真文件格式错 6=发送传真页