标准号: GA 663-2006
中文名称:互联网公共上网服务场所信息安全管理系统远程通讯端接口技术要求
标准类别:公共安全行业标准(GA)
标准状态:现行
出版语种:简体中文
下载格式:.zip .pdf
下载大小:28828964
相关标签: 互联网 公共 上网 服务 场所 信息安全 管理系统 远程 通讯 接口技术
b)格式说明。在以上格式中,下列要求应得到有效遵循:1)中文都是需要替换成为实际值,英文部分固定不变:XML的根元素名称应为“Body。Body中的Code及Description属性在参数格式中不应2)
包含,在返回结果中应包含。结果代码见7.4;Body下可包含多个或0个“Table”元素,即一个XML文件可包含不同类别的记录集;3)
Table元素应且只能包含一个“Name\属性,用于说明记录集名称。Description属性可以省略;
Table下可包含多个Item”记录项元素;5)
Item可包含多个不同的属性说明,但同一个Table下的Item属性个数及名称应相同;6)
时间与日期采用:“YYYYMMDDhhmmss”格式表示,其中时间采用24小时制按GA/Z02—2005(4.2)中日期和时间的组合法表示。8)数值采用十进制表示。
6.3数据约束
数据约束是对提交数据及返回结果的XML作出必要的限制,包括如下内容:Table的Name应为本标准指定的记录集名称;一所有函数调用参数及返回结果的记录项个数不应超过1000条;记录项属性名称及内容应遵守XML协议规定。7函数说明
7.1数汇总表
函数汇总表见表1。
GA663—2006
GetDateTime
SetDateTime
函数名称
SetUpStatusProperty
CommitStatus
QueryStatus
CommitMessage
SelectMessage
UpdateDailyStat
SelectDailyStat
SelectStat
SendSMS
UpdateData
SelectData
DeleteData
7.2详细函数说明
查询远程通讯端当前时间
表1函数汇总
查询远程通讯端当前时间
设置远程通讯端当前时间
更改上报信息属性
上报远程通讯端当前状态
查询远程通讯端当前状态
消息通知
查询消意
上传日统计记录
查询日统计记录
查询统计报表
代发手机短信通知
通用数据表处理
更新或增加数据记录
查询数据记录
删除数据记录
本函数用于查间选程通讯端当前系统时间。详细函数定
Public stringGeDateTime(string格式说明:
返回值格
;
NerifylD)
代码\Description一\结果附加说明\说
tDateTimeDescription=“查询远程通讯端当前系统厨间\>YMMDDhhmmss
返回值格式中“YYYYMMDDhhmmes\应为实际的时间值数据交换格式定义见表2。
表2返回的数据数据结构
数据项
数据项属性名
上网服务场所时间
数据项类型 数据项长度
日期时间
返回的结果参数的xml样式文件为:14
采用标准
GA/Z02-2005
格式为YYYYMMDDhhmmss,
其中时间以24小时制表示
7.2.2设置远程通讯端当前时间
本函数用于设置远程通讯端当前系统时间。主要用于与其他系统保持时间同步。详细函数定义:
Public string SetDateTime(stringVerifyID,string Xml)说明:
。调用参数Xml的格式
GA663-2006
YMMDDhhmmss\/>
·以上格式中Y?MMDDhhmmss\应为实际的时间值·返回值格式
具体数据交联宵
数据项
果代码\Descripti
见表3。
结果附加说明“>
设置远程通讯端当前时间调用参数数据结构据项属性名
上网服务场所时间
传人参数的
encoding
数据项类型 数据项长度
日期时间
UTE-8\2
—2005
YYYYMMDDhhmmss,时间以
24小时制表示
“设置远程通讯端当前系统时间演me\Desoription-
Dhhmmes\/
7.2.3更改上报信息属性
本函数用于其他系统设置远程通讯端定时上报信息的属性详细函数定义
Public string SetUpStatusProperty(stringVerifyID,stringXml)a)调用参数Xml的格式:
GA663—2006
格式说明:
在“回调URL地址”中,填写回调函数的WebService地址;在“回调授权码”中,填写远程通讯端访问其他系统时所应提交的授权码,用于7.2.4等回调函数:
“时间间隔\取值“SSSS\应为实际的时间间隔值,单位为秒,十进制表示,值为0时表示不需要上报状态;
运行状态、过滤结果、终端上下线日志、上网日志、真实身份、处罚结果、日统计属性取值范围相同,属性值为“Y\表示需上传,“N\表示不需上传。上述属性中有一个值为“Y\时,其他系统应提供回调函数UpdateData(7.2.12);“代发手机短信通知”取值“Y”,表示其他系统可以为远程通讯端代发,“N”表示其他系统不支持短信代发;
如缺少某属性,表示此次不设置该属性,远程通讯端应保持前次属性设置的结果;?
返回值格式
明确的数据交换格式见表4。
表4更改上报信息属性数据结构
数据项名称
CallbackUrl
VerifyID
IntervalFig
CommitStatus
AlarmLog
TUDLog
OnlineLog
Realldentity
PunishResult
DayStat
SendSms
数据项属性名
回调URL地址
回调授权码
时间间隔
上网服务场所运行
过滤结果
终端上下线日志
上网日志
真实身份
处罚结果
日统计
代发手机短信通知
传人的参数的xml样式为:
数据项类型
数据项长度
采用标准
单位为秒
GA658.8—2006
GA659.1—2006
GA659.2—2006
GA659.8-2006
GA658.3—2006
不允许为空
不允许为空
默认为0
取值,Y/N,
默认值:N
7.2.4上报远程通讯端当前状态
GA663—2006
本函数属于回调函数,用于远程通讯端按照其他系统的要求定时上报状态信息,表示远程通讯端的通信正常并且在线,提交内容包括当前在线上网服务场所的信息。当其他系统需要远程通讯端上报当前状态时,应提供本函数。
详细函数定义:
Public string CommitStatus(string VerifyID,stringXml)说明:
VerifyID是回调函数授权码,其他系统应在SetUpStatusProperty函数(7.2.3)中通知远程通讯端。
调用参数Xml的格式
以上格式中OnlineISBS应填写实际在线上网服务场所数;每个在线上网服务场所生成一条.
Content元素;
以上格式中Content元素中上网服务场所代码填写在线的上网服务场所代码,运行状态代码见GA658.8—2006,活动主机数填写此上网服务场所当前在线终端总数;·返回值格式
具体明确的数据交换格式见表5。表5上报远程通讯端当前状态调用参数数据结构序号
数据项名称
OnlineISBS
Service_code
Status
Activity_number
数据项属性名
上网服务场所数
上网服务场所编码
运行状态代码
活动主机数
传人参数的xml样式文件为:
数据项类型数据项长度
采用标准
GA658.1—2006
GA658.8—2006
GA663—2006
7.2.5查询远程通讯端当前状态
本函数用于查询远程通讯端当前状态信息。详细函数定义:
Public stringQueryStatus(stringVerifyID,stringXml)说明:
。调用参数Xml的格式
·以上格式不带Item
返回值格式
;
·以上格式
Description“结果附加说明“
eryStatus\Descri
praon=“查询远程通讯端当前状态\>Qu
\xxx\>
两服务场所代码
xxxxxxxxxxxxx\运行状态代码=\活动主机数=OnineISBS应填写实际在线上网服务场所数每个在线上网服务场所生成一条Content元素
·以上格式中
具体的数据交换格
ent元素中上网服务场所代码填写在线的上网服务场所代码,运行状态代码见活动主机数填写此上网服务场所当前在线终端总数。纯表6。
传入参数的数据格式
数据项名称
OnlineISBS
Service_code
Status
Activity_number
面说明,不再措述
表6返回结果的数据结构
数据项隔性名
上网服务场所数
上网服务场所编码
运行状优码
活动主机数
具体返回结果的xml样式文件为:
数据项长度
采用标准
GA658.1—2006
GA658.8-—2006
7.2.6消息通知
GA663—2006
本函数用于向远程通讯端发布文字内容信息,可以是仅发给此远程通讯端,也可以实现向上网服务场所发送消息。
详细函数定义:
PublicstringCommitMessage(stringVerifyID,stringXml)说明:www.bzxz.net
·调用参数Xml的格式
<接收者
<接收者
<接收者
<消息编
xxxxxxx\/>
\XXXxXXXXXXXXX
消息编号
<发送消息时间>/发送消息时间
消息标题
消息标题
<消息园客
<发遥标思
·以上格式可旗
以上格式中
0条记录,如果
消息内容>
发送标志>
食多条消息,每条消息使用一个item元素元素中指明接收者每个接收者一条记录,填写接收者编码可以包括多条或者录,表示消息仪发给此远程通讯端:编码可以为4、6、4位,分别表示对全市上网服务场所
区)上网服务场所、指定上网服务场所下发通知:以上格式中Item的期他示素名称为数据项名,填写相应的具体数据项病容;返回值格式
具体的数据交换格式见表7。
表7消息通知调用参数数据结构
数据项名称
Service_code
Send_time
Message_code
Objeet
Message
数据项属性名
上网服务场所编码
发送消息时间
消息编号
消息标题
消息内容
发送标志
数据项类型数据项长度
日期时间
采用标准
GA658.1—2006
GA/Z02—2005中4.2
GA659.6-—2006
GA659.6—2006
GA659.6—2006
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。