3G-Fax数据库接口要求与使用说明.doc

3G-FAX接口说明 接口实现方式 通过一个中间数据库的形式实现双方的交互 该数据库包含两个表：发送传真表（3GFAX_SendFaxInfo）、接收传真表（3GFAX_ RecFaxInfo）。数据库名称可以动态设定或指定数据库名（如Database_3gfax或3GFAX） 数据库表结构说明 发送传真表：3GFAX_SendFaxInfo 顺序号 字段名 中文名称 类型 主键 备注 0 ListNo 流水号 Integer（unsigned） √ 自增量的流水号 1 TaskID 任务ID Integer（unsigned） 任务唯一识别码（可以是自动生成的随机码） 2 SubTime 提交时间 DateTime 传真提交的时间 3 SenderName 发件人名 Varchar(50) 标识传真发件人，可以是公司名称或人名 4 RcverName 收件人名 Varchar(50) 标识传真收件人，可以是公司名称或人名 5 FaxNum 接收人号码 Varchar(40) 传真号码 6 SchSendTime 计划发送时间 DateTime 用于延时发送的情况，如果为空则立即发送，非空则需到了这个时间再发送.默认为空（尚未实现） 7 UserID 发送用户ID Varchar(50) 用于记录发送人的用户ID， 8 FileName 文件名 Varchar(255) 不包含路径信息，多个文件名之间用“|”相隔. 注意：这里上传的文件是原始文件，如word、excel等。 9 FilePath 文件存放路径 Varchar(255) 文件存放的路径，多个文件的情况下其存放路径是一样的，该字段仅保存相对路径（相对于3G-FAX根目录的路径）。（如果根路径为“C:\3G-FAX数码传真机”，则字段值等于“Temp\”时表示路径C:\3G-FAX数码传真机\Temp\） 10 SendFaxNum 发送线路号码 Varchar(30) 用于记录该份传真实际发送所用的线路。这样在多路的情况下可以知道这封传真是哪条线出去的。（尚未实现） 11 Status 发送状态 Char(1) 提交 正在发送 发送失败 发送成功 默认为’0’ 12 TransStatus 虚拟转换状态 Char(1) 0－尚未转换 1－转换完毕（虚拟转换路径及文件名有效，删除提交的原始文件） 默认为’0’ 13 SendTime 发送时间 DateTime 传真实际成功发送的时间 14 SendDescribe 失败原因描述 VCHAR(255) 用于记录失败原因，便于查找问题及向用户提示。 15 TransFileName 虚拟转换后的文件名 Varchar(255) 多个文件时，以第一个文件名做为转换后的传真文件名 16 TransFilePath 虚拟转换后的文件存放路径 Varchar(255) 自动按月份记录，不同记录，路径可以不同。该字段仅保存相对路径（相对于3G-FAX根目录的路径）。（如果根路径为“C:\3G-FAX数码传真机”，则字段值等于“Temp\”时表示路径C:\3G-FAX数码传真机\Temp\） 17 Ex1 扩展字段1 Varchar(255) 用户可以自行扩展使用 18 Ex2 扩展字段2 Varchar(255) 用户可以自行扩展使用 19 Ex3 扩展字段3 Varchar(255) 用户可以自行扩展使用 20 Ex4 扩展字段4 Varchar(255) 用户可以自行扩展使用 21 Ex5 扩展字段5 Varchar(255) 用户可以自行扩展使用 上面红色部分是需要3G-FAX处理的字段，Ex1到Ex5是留给用户作为扩展使用。其余 接收传真表：3GFAX_RecFaxInfo 字段名 中文名称 类型 主键 备注 ListNo 流水号 Integer √ 自增量的流水号 FaxNum 发送人号码 Varchar(30) 发送人传真号码（或是来电显示） RecTime 收到时间 DateTime FileName 传真文件名 Varchar(255) Tif格式文件 FilePath 文件存放路径 Varchar(255) 相对3G-FAX根目录的路径 RecFaxNum 接收此传真的3G-FAX序号 VCHAR(30) 主要用在多路的情况下标识传真是从哪台3G-FAX接收 ReadFlag 读取标志 Char(1) 我方用到，用于标识哪些传真已读，哪些未读。’1’=已读，’0’=未读 RecUserName 接收此传真的用户名 Varchar(255) 标识该传真的接收人（如果传真发送人输入用