中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx
《中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx》由会员分享，可在线阅读，更多相关《中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx（13页珍藏版）》请在冰点文库上搜索。
中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013
中国电信商务领航定制终端
管理系统技术规范
（BNSP接口）
2008年10月
1.定义和缩写3
2.系统目标4
3.接口概述5
4.接口说明7
4.1.源数据发布接口7
4.1.1.接口场景描述7
4.1.2.接口时序7
4.2.获取数据集成反馈结果接口11
4.2.1.接口场景描述11
4.2.2.接口时序11
1.数据反馈通知方式12
2.数据反馈通知文件命名及格式规范13
5.异常处理14
1.定义和缩写
接收数据系统：
商务领航定制终端技术服务支撑平台系统：
简称（BNSP）
传送数据系统：
各省的网关管理系统：
简称（BBMS）
2.系统目标
●能查询按网关类型划分的统计内容
●能查询按套餐类型划分的统计内容
●能查询按接入方式划分的统计内容
●能查询按厂商划分的统计内容
●能查询按业务状态划分的统计内容
3.接口概述
各省BBMS作为源系统，将源数据以文本文件方式通过FTP方式（程序自动实现）保存到BNSP系统的指定路径，BNSP系统去指定路径获得源数据。
具体流程如下：
●BNSP系统首先在本地FTP的指定路径下建立省份文件夹，其次在省份文件中每天创建时间文件夹
●各省BBMS系统按照规定的格式，将源数据生成的文本文件保存在BNSP系统的服务器下，.数据生成以天为单位，形成多个数据源文件。
BNSP系统去本地指定的文件夹进行数据采集。
●BNSP系统读取BBMS系统数据进行入库处理。
●数据入库处理结束后，同时生成结果报告反馈给各省BBMS系统。
●如果其中某个省的传输源文件没有收到、格式错误和其它错误，BNSP系统会生成ErrorReport文件，并把反馈文件存放在本地的服务器下，BBMS系统进行自动获取该文件，并判断传输数据是否正确。
各系统接口的实现功能
BNSP（商务领航定制终端技术服务支撑平台系统）实现的功能：
Ø定期创建时间文件夹，存放BBMS系统的源数据
Ø定期获取BBMS系统传送的源数据文件
Ø数据处理完成后，反馈数据集成结果给各省BBMS系统
各省BBMS系统实现的功能：
Ø定期生成源数据文件并发送到BNSP系统指定的文件路径。
Ø获取BNSP（商务领航定制终端技术服务支撑平台系统）的数据集成结果的反馈
4.接口说明
4.1.源数据发布接口
4.1.1.接口场景描述
该接口用于各业务系统（各省BBMS系统）向BNSP系统定期传送源数据。
4.1.2.接口时序
业务流程：
发起方：
各省BBMS系统
接收方：
BNSP系统
接口协议：
ftp
◆数据传送方式
IP地址为：
xxx.xxx.xxx.xxx
FTP帐号为：
用户名/******，（暂定为:
用户名：
省份码+user，密码：
省份码＋user
目录：
/sme/省份码/时间文件夹放置各省BBMS系统传送的源数据文件；
各省BBMS系统定期生成源数据文件；
◆数据文件命名格式
数据文件
文件命名格式：
省份码+表名＋文件采集时间+.txt
文件编码格式：
所有文件以GB2312为统一的编码格式
1）省份码
省份编号如下：
省份
省份码
上海市
S01
江苏省
S02
浙江省
S03
安徽省
S04
陕西省
S05
福建省
S06
甘肃省
S07
北京市
S08
广东省
S09
广西壮族自治区
S10
贵州省
S11
海南省
S12
河北省
S13
河南省
S14
黑龙江省
S15
湖北省
S16
湖南省
S17
吉林省
S18
江西省
S19
辽宁省
S20
内蒙古自治区
S21
宁夏回族自治区
S22
青海省
S23
山东省
S24
山西省
S25
四川省
S26
云南省
S27
西藏自治区
S28
新疆维吾尔自治区
S29
天津市
S30
重庆市
S31
2）表名：
网关型号统计表：
gateway
套餐类型统计表：
series
接入方式统计表：
connect_way
厂商网关型号统计表：
factor_gateway
业务类型统计表：
work_type
3）文件采集时间，（注：
文件生成时间的前一天，既数据采集时间）：
用“YYYYMMDD”表示，如2007年10月20日表示为“20071020”；
◆数据文件格式
采用文本方式，每个字段之间用竖线相隔，如果字段内容为空则用大写字符串“NULL”表示，每一条记录按照换行来相隔。
◆数据传送时间
1）各省BBMS系统每日于3：
00传送相关数据文件；
2）BNSP系统于每日4：
00，读取数据文件；
3）BNSP系统于每日4点30生成当天的采集结果的反馈文件；
◆文件内容
数据文件：
网关型号统计表：
gateway
网关型号统计表（gateway_table）
字段含义
字段名
类型
描述
位置信息（省份）
province
varchar2（20）
参照编码表
受理量
accetp
int
总数量，具体详见备注
注册量
regist
int
总数量，具体详见备注
在线量
device_status
int
总数量，具体详见备注
网关型号
gateway_type
varchar2（20）
参照编码表
统计时间
time
string（10）
格式：
年－月－日
套餐类型统计表：
series
套餐类型统计表（series_table）
字段含义
字段名
类型
描述
位置信息（省份）
province
varchar2（20）
参照编码表
受理量
accetp
int
总数量，具体详见备注
注册量
regist
int
总数量，具体详见备注
套餐类型
series_type
varchar2（20）
参照编码表
速率
gateway_speed
varchar2（20）
参照编码表
统计时间
time
string（10）
格式：
年－月－日
接入方式统计表：
connect_way
接入方式统计表（connect_way_table）
字段含义
字段名
类型
描述
位置信息（省份）
province
varchar2（20）
参照编码表
数量
num
int
总数量
百分比
percent
varchar2（8）
格式为：
25%
接入方式
connect_type
varchar2（20）
参照编码表
统计时间
time
string（10）
格式：
年－月－日
厂商网关型号统计表：
factor_gateway
厂商网关型号统计表（factory_gateway_table）
字段含义
字段名
类型
描述
位置信息（省份）
province
varchar2（20）
参照编码表
注册量
regist
int
总数量，具体详见备注
网关型号
gateway_type
varchar2（20）
参照编码表
厂商
factory_name
varchar2（20）
参照编码表
统计时间
time
string（10）
格式：
年－月－日
业务类型统计表：
work_type
业务类型统计表（work_type_table）
字段含义
字段名
类型
描述
位置信息（省份）
province
varchar2（20）
参照编码表
开通量
opensnumber
int
总数量
暂停量
pausenumber
int
总数量
复机量
restorationnumber
int
总数量
移机量
movesnumber
int
总数量
拆机量
stopsnumber
int
总数量
业务名称
work_name
varchar2（20）
参照编码表
统计时间
time
string（10）
格式：
年－月－日
备注：
受理量：
受理量是CRM受理的网关设备量的统计
注册量：
注册量是BBMS管理的网关设备量的统计
在线量：
在线量是BBMS统计时刻网关设备在线数量
4.2.获取数据集成反馈结果接口
4.2.1.接口场景描述
该接口用于BNSP系统反馈数据集成结果。
4.2.2.接口时序
业务流程：
发起方：
各省BBMS系统
接收方：
BNSP系统
接口协议：
ftp
接收数据集成反馈结果接口格式：
◆数据传送方式
IP地址为：
xxx.xxx.xxx.xxx
FTP帐号为：
同上面定义，
目录：
BBMS系统需去BNSP系统FTP服务器下指定路径去获取
/SME/省份码/时间文件夹BNSP系统上传的反馈信息文件；
在每天BNSP系统采集完各省的BBMS数据后，系统会对采集的数据文件进行检查，以确定从各省采集的BBMS数据是否有数据文件缺失。
如果某省发生数据文件缺失，则BNSP系统将不对该省的数据进行数据预处理和数据分析。
并会向发生数据文件缺失的省BBMS给出数据缺失通知，存放在BNSP系统的本地服务器中，要求该省BBMS必须在当天将缺失的数据文件重新上传FTP，省BBMS对接收到的数据缺失报告进行解析，然后将缺失的数据文件上传，再由BNSP系统进行采集，直至BNSP系统反馈成功为止。
如果重试还是失败，BNSP系统应该向本系统管理员发送邮件告警，并转人工干预。
1.数据反馈通知方式
要求BNSP系统给出数据缺失通知文件，BBMS系统通过FTP方式读取数据缺失通知文件；省BBMS对接收到的数据缺失通知文件进行解析，然后将缺失的数据文件上传。
各省BBMS系统对BNSPFTPServer的要求：
⏹FTP用户名和密码：
BNSP开通FTPServer上为BBMS系统开设FTP登录用户名和密码；
用户名/密码暂定为：
定义同上
⏹FTP文件目录：
BNSPFTPServer上为BBMS系统开设数据缺失通知文件的上传目录；
FTP文件目录暂定为：
/SME/省份码/时间文件夹
2.数据反馈通知文件命名及格式规范
1）文件命名规范
当发生数据文件缺失时，系统会向相关省BBMS发送数据缺失通知信息；若数据文件完整（文件齐全，格式正确）BNSP系统也会向相关省BBMS发送数据接收成功通知信息。
反馈文件后缀名规则：
re{n}”（n表示重传次数）标识，进行区别。
数据通知文件的命名格式为：
INFORM.re{n}
⏹INFORM：
表示是数据反馈通知；
例：
INFORM.re1：
表示BNSP第一次反馈的文件
INFORM.re2：
表示BNSP第二次反馈的文件
2）文件格式规范
反馈文件：
字段内容
字段类型
注释
反馈结果（0：
成功，1：
文件缺失失败，2：
格式错误失败，3：
其他错误）
CHAR
（2）
缺失文件名（如有多条，以分号分割）
CHAR（256）
5.异常处理
异常自动处理场景描述：
1．当BNSP系统数据采集应用发现数据有误（文件未找到、格式错误、数据错误等），以FTP反馈文件（后缀为re{n}）的方式通知BBMS厂商；
2．厂商收到需要定期检查反馈文件，并及时处理，重新上传相关文件；
3．BNSP系统数据采集应用在等待指定的时间后，重新下载所有的文件，并进行相关检查和处理。
异常自动处理每天处理2次，超过2次的采用人工干预
具体时间和任务如下：
时间（24H）
BBMS厂商
BNSP系统
4:
00之前
上传当天数据
4:
00
下载相关文件
6:
00之前
上传反馈文件
6:
00
检查相关反馈文件
如果有错误则处理如下事务
8:
00之前
修正错误（第一次）,重新上传文件
8:
00
重新下载并处理
10:
00之前
第二次上传反馈文件
10:
00
检查相关反馈文件
如果有错误则处理如下事务
12:
00之前
修正错误（第二次）,重新上传文件
12:
00
重新下载并处理
14:
00之前
第三次上传反馈文件
14:
00
检查相关反馈文件
如果有错误则人工干预
升级会员 