ULTRASMS 优势通短彩信平台
数据库接口表说明
V6.0
Tb_sndtmp 发送信息临时表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
SMID
INTEGER
整型
必填
短信标示，自动增加
PERSONID
INTEGER
整型
必填
1
生成短信用户 id ，接口表中固定为 1
SERVICEID
INTEGER
整型
必填
-1
短信服务类型 id ，接口表中固定为 -1
MSG
VARCHAR2
1000
必填
短信内容或者彩信标题，如果信息类型是外拨电话，详见 SMSTYPE 字段说明， SMSTYPE 取值为 C ，此字段保存的是语音文件的路径，如果为 CT ，此字段保存的是需要转成语音的文本内容
TPA
VARCHAR2
255
必填
接收信息电话号码
INDATETIME
DATE
sysdate
信息生成时间
PRI
INTEGER
整型
0
信息发送级别，数字越大越靠前发送
STYPE
VARCHAR2
10
短信类型，人工生成或者邮件转短信等等
STATE
VARCHAR2
12
必填
UNSEND
信息状态，待发送信息状态为 UNSEND
STATEDATE
DATE
信息状态时间
RETRYTIMES
INTEGER
整型
3
发送失败后尝试发送次数， 0 表示不再发送， 1 表示失败后再发送一次，以此类推
STARTTIME
DATE
必填
2000-01-01
定时发送开始时间，如果想立即发送短信就设一个很早的时间，比如 2000-01-01
STOPTIME
DATE
必填
3000-01-01
定时发送结束时间，如果没有时间限制就设一个很晚的时间，比如 3000-01-01
DEVNO
VARCHAR2
10
发送该信息的端口号
MAILADDRESS
VARCHAR2
80
如果是邮件转短信则记录发邮件的邮箱地址，如果是 socket 则是发消息机器的 ip 地址，如果 SMSTYPE 为 C 或者 CT ，此字段保存呼叫最大时长设置，如果无限制该字段赋值为－ 1
SMSTYPE
VARCHAR2
10
必填
短信类型，普通短信、免提短信、 wappush 短信或者彩信
S 普通短信 (PDU UCS2 编码 ),
S7 普通短信（ PDU 7bit 编码） ,
S8 普通短信（ PDU 8bit 编码） ,
ST 普通短信（文本模式） ,
F 免提短信 ,
W wappush 短信 ,
M 彩信 ,
BM 图片彩信，图片内容保存在 BMMSFILE 字段中
BA 声音文件彩信，声音文件内容保存在 BMMSFILE 字段中， MI 图片文件彩信，
MA 声音文件彩信，
MT 文本文件彩信，
MH 发送 hymms 文件格式的彩信，
MP 程序文件彩信，
MV 视频文件彩信，
MF 多个图片或声音文件彩信；
C 外拨电话，指定语音文件
CT 外拨电话，文本转语音
WAPPUSHLINK
VARCHAR2
100
wappush 短信中 wap 网址或者彩信文件名称
MMSCONTENT
VARCHAR2
1000
彩信内容文字说明，一般用于图片或声音文件文字描述，或者在 SMSTYPE 为 MF 的时候为所有图片或者声音文件路径，文字描述等内容，详细说明见后面。
BMMSFILE
BLOB
保存图片或声音文件，此字段可根据需要创建
图片或声音文件以 16 进制的方式保存到数据库中
RECORDID
INTEGER
整型
指定设备发送短信， <=0 任意设备发送
>0 指定设备发送，数值为设备顺序号，比如取值为 4 就是指定设备 4 发送改短信
USERDEF1
VARCHAR2
30
用户自定义字段，用户可以保存自己系统需要的数据，长度可根据需要修改
USERDEF2
VARCHAR2
30
用户自定义字段，用户可以保存自己系统需要的数据，长度可根据需要修改
USERDEF3
VARCHAR2
30
用户自定义字段，用户可以保存自己系统需要的数据，长度可根据需要修改
红颜色必填字段是发送短信或彩信根据需要用户需要自己填写的，其他颜色必填字段可设置默认值，非必填字段可以为空
插入短信数据例子 ：
Insert into tb_sndtmp(tpa,msg,smstype) values(‘10086’ ,’ 短信内容 ’,’S’)
插入彩信数据例子 ：
Insert into tb_sndtmp(tpa,msg,smstype,wappushlink,mmscontent)
Values(‘10086’ ,’ 彩信标题 ’,’M’,’ 彩信文件路径 ’,’ 彩信图片或声音文件文字说明 ’)
关于 SMSTYPE 取值为 MF 的特别说明 ：
当发送的彩信包含多个图片或者声音或者文字时，一般的可以用彩信软件生成 hymms 格式的文件，然后在数据库中设置相应的类型并指定 hymms 文件就可以了，但是这种方式适合人工生成 hymms 文件的情形，如果彩信中的图片等其他文件是程序生成的，依靠数据库自动发送出去，这种情形就不适合了。这个时候可以用另外一种方式实现。设置 SMSTYPE 值为 MF ，然后在 MMSCONTENT 字段中保存包含彩信文件信息的字符串。
这个包含彩信文件的字符串格式如下：
//彩信文件第一帧
图片文件完整路径
文字说明
声音文件完整路径
//彩信文件第二帧
图片文件完整路径
文字说明
声音文件完整路径
…
MMSCONTENT 字段默认是 2000 个字节长度，可以根据实际情况修改。注意同时修改 tb_sndtmp 和 tb_sndlog 两个表中的相应字段。
示例：
insert into tb_sndtmp(personid,ServiceID,msg,TPA,InDateTime,PRI,SType,State,RecordID,RetryTimes,starttime,stoptime,devno,mailaddress,smstype,mmscontent) values(1,-1,' 彩信测试 ','10086',now(),0,'','UNSEND',0,4,now(),'3000-01-01 ','','','MF',' 彩信第一帧 彩信第二帧
Tb_sndlog 发送信息日志表 ( 以下说明以 ORACLE 数据库为例 ) ，记录信息发送结果
字段名称
类型
长度
可否为空
默认值
说明
SMID
INTEGER
整型
同 tb_sndtmp 表
PERSONID
INTEGER
整型
同 tb_sndtmp 表
SERVICEID
INTEGER
整型
同 tb_sndtmp 表
MSG
VARCHAR2
1000
同 tb_sndtmp 表
TPA
VARCHAR2
255
同 tb_sndtmp 表
INDATETIME
DATE
同 tb_sndtmp 表
PRI
INTEGER
同 tb_sndtmp 表
STYPE
VARCHAR2
10
同 tb_sndtmp 表
STATE
VARCHAR2
12
同 tb_sndtmp 表
STATEDATE
DATE
同 tb_sndtmp 表
RETRYTIMES
INTEGER
整型
同 tb_sndtmp 表
STARTTIME
DATE
同 tb_sndtmp 表
STOPTIME
DATE
同 tb_sndtmp 表
DEVNO
VARCHAR2
10
发送该信息的端口号
MAILADDRESS
VARCHAR2
80
同 tb_sndtmp 表，如果 SMSTYPE 为呼出， C 或者 CT ，此字段保存呼叫失败原因， BUSY ， NO ANSWER 等等
SMSTYPE
VARCHAR2
10
同 tb_sndtmp 表
WAPPUSHLINK
VARCHAR2
100
同 tb_sndtmp 表，如果 SMSTYPE 为呼出， C 或者 CT ，此字段保存呼叫接通时间
MMSCONTENT
VARCHAR2
1000
同 tb_sndtmp 表，如果 SMSTYPE 为呼出， C 或者 CT ，此字段保存呼叫结束时间
MMSRECVTIME
DATE
目标用户接收彩信时间
暂时无用，保留
MMSREADTIME
DATE
目标用户阅读彩信时间
暂时无用，保留
RECORDID
INTEGER
整型
同 tb_sndtmp 表
USERDEF1
VARCHAR2
30
同 tb_sndtmp 表
USERDEF2
VARCHAR2
30
同 tb_sndtmp 表
USERDEF3
VARCHAR2
30
同 tb_sndtmp 表
Tb_rcvtmp 接收信息临时表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
SMID
INTEGER
整型
必填
信息标示，自动增加
MSG
VARCHAR2
1000
接收短信内容
TPA
VARCHAR2
255
发送短信的电话号码
RECVDATETIME
DATE
接收短信的时间
DEVNO
VARCHAR2
10
接收短信的端口号
SMSTYPE
VARCHAR2
1
信息类型， S 短信 M 彩信
MMSFILESID
VARCHAR2
50
如果是彩信，此字段是个标示，与 Tb_rcvmmsfiles 表对应， Tb_rcvmmsfiles 表中保存的是该彩信文件中所包含的文件的保存的路径及名称
Tb_rcvmmsfiles 接收彩信文件表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
MMSFILESID
VARCHAR2
50
必填
信息标示，与 Tb_rcvtmp 表中的字段对应
FILETYPE
VARCHAR2
10
文件类型
FILENAME
VARCHAR2
100
文件目录及名称
FILECODE
VARCHAR2
10
文件的二进制编码，暂不使用，可根据需要使用
Tb_rcvmmsfiles 接收彩信文件表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
MMSFILESID
VARCHAR2
50
必填
信息标示，与 Tb_rcvtmp 表中的字段对应
FILETYPE
VARCHAR2
10
文件类型
FILENAME
VARCHAR2
100
文件目录及名称
FILECODE
VARCHAR2
10
文件的二进制编码，暂不使用，可根据需要使用
Tb_syscfg 系统信息配置表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
CONFIGID
INTEGER
配置项 ID
VALUE1
VARCHAR2
200
配置项参数 1
VALUE2
VARCHAR2
200
配置项参数 2
VALUE3
VARCHAR2
200
配置项参数 3
DES
VARCHAR2
40
配置项描述
Tb_mmsurl 接收彩信地址表 ( 以下说明以 ORACLE 数据库为例 )
字段名称
类型
长度
可否为空
默认值
说明
MMSURL
VARCHAR2
50
接收彩信地址
DEVNO
INTEGER
接收彩信设备串口号
STATEDATE
DATE
彩信状态
RETRYTIMES
INTEGER
尝试接收彩信的次数，
INDATETIME
DATE
接收彩信的时间
.png)
.png)
