中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx
《中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx》由会员分享，可在线阅读，更多相关《中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013.docx（15页珍藏版）》请在冰点文库上搜索。
中国电信商务领航定制终端技术服务支撑平台系统源数据采集接口技术方案1013
中国电信商务领航定制终端
管理系统技术规范
（BNSP接口）
2008年10月
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
检查相关反馈文件
如果有错误则人工干预
当我被上帝造出来时，上帝问我想在人间当一个怎样的人，我不假思索的说，我要做一个伟大的世人皆知的人。
于是，我降临在了人间。
我出生在一个官僚知识分子之家，父亲在朝中做官，精读诗书，母亲知书答礼，温柔体贴，父母给我去了一个好听的名字：
李清照。
小时侯，受父母影响的我饱读诗书，聪明伶俐，在朝中享有“神童”的称号。
小时候的我天真活泼，才思敏捷，小河畔，花丛边撒满了我的诗我的笑，无可置疑，小时侯的我快乐无虑。
“兴尽晚回舟，误入藕花深处。
争渡，争渡，惊起一滩鸥鹭。
”青春的我如同一只小鸟，自由自在，没有约束，少女纯净的心灵常在朝阳小，流水也被自然洗礼，纤细的手指拈一束花，轻抛入水，随波荡漾，发髻上沾着晶莹的露水，双脚任水流轻抚。
身影轻飘而过，留下一阵清风。
可是晚年的我却生活在一片黑暗之中，家庭的衰败，社会的改变，消磨着我那柔弱的心。
我几乎对生活绝望，每天在痛苦中消磨时光，一切都好象是灰暗的。
“寻寻觅觅冷冷清清凄凄惨惨戚戚”这千古叠词句就是我当时心情的写照。
最后，香消玉殒，我在痛苦和哀怨中凄凉的死去。
在天堂里，我又见到了上帝。
上帝问我过的怎么样，我摇摇头又点点头，我的一生有欢乐也有坎坷，有笑声也有泪水，有鼎盛也有衰落。
我始终无法客观的评价我的一生。
我原以为做一个着名的人，一生应该是被欢乐荣誉所包围，可我发现我错了。
于是在下一轮回中，我选择做一个平凡的人。
我来到人间，我是一个平凡的人，我既不着名也不出众，但我拥有一切的幸福：
我有温馨的家，我有可亲可爱的同学和老师，我每天平凡而快乐的活着，这就够了。
天儿蓝蓝风儿轻轻，暖和的春风带着春的气息吹进明亮的教室，我坐在教室的窗前，望着我拥有的一切，我甜甜的笑了。
我拿起手中的笔，不禁想起曾经作诗的李清照，我虽然没有横溢的才华，但我还是拿起手中的笔，用最朴实的语言，写下了一时的感受：
人生并不总是完美的，每个人都会有不如意的地方。
这就需要我们静下心来阅读自己的人生，体会其中无尽的快乐和与众不同。
“富不读书富不久，穷不读书终究穷。
”为什么从古到今都那么看重有学识之人？
那是因为有学识之人可以为社会做出更大的贡献。
那时因为读书能给人带来快乐。
自从看了《丑小鸭》这篇童话之后，我变了，变得开朗起来，变得乐意同别人交往，变得自信了……因为我知道：
即使现在我是只“丑小鸭”，但只要有自信，总有一天我会变成“白天鹅”的，而且会是一只世界上最美丽的“白天鹅”……
我读完了这篇美丽的童话故事，深深被丑小鸭的自信和乐观所折服，并把故事讲给了外婆听，外婆也对童话带给我们的深刻道理而惊讶不已。
还吵着闹着多看几本名着。
于是我给外婆又买了几本名着故事，她起先自己读，读到不认识的字我就告诉她，如果这一面生字较多，我就读给她听整个一面。
渐渐的，自己的语文阅读能力也提高了不少，与此同时我也发现一个人读书的乐趣远不及两个人读的乐趣大，而两个人读书的乐趣远不及全家一起读的乐趣大。
于是，我便发展“业务”带动全家一起读书……现在，每每遇到好书大家也不分男女老少都一拥而上，争先恐后“抢书”，当我说起我最小应该让我的时候，却没有人搭理我。
最后还把书给撕坏了，我生气地哭了，妈妈一边安慰我一边对外婆说：
“孩子小，应该让着点。
”外婆却不服气的说：
“我这一把年纪的了，怎么没人让我呀？
”大家人你一言我一语，谁也不肯相让……读书让我明白了善恶美丑、悲欢离合，读一本好书，犹如同智者谈心、谈理想，教你辨别善恶，教你弘扬正义。
读一本好书，如品一杯香茶，余香缭绕。
读一本好书，能使人心灵得到净化。
书是我的老师，把知识传递给了我；书是我的伙伴，跟我诉说心里话；书是一把钥匙，给我敞开了知识的大门；书更是一艘不会沉的船，引领我航行在人生的长河中。
其实读书的真真乐趣也就在于此处，不是一个人闷头苦读书；也不是读到好处不与他人分享，独自品位；更不是一个人如痴如醉地沉浸在书的海洋中不能自拔。
而是懂得与朋友，家人一起分享其中的乐趣。
这才是读书真正之乐趣呢！
这所有的一切，不正是我从书中受到的教益吗？
我阅读，故我美丽；我思考，故我存在。
我从内心深处真切地感到：
我从读书中受到了教益。
当看见有些同学宁可买玩具亦不肯买书时，我便想到培根所说的话：
“世界上最庸俗的人是不读书的人，最吝啬的人是不买书的人，最可怜的人是与书无缘的人。
”许许多多的作家、伟人都十分喜欢看书，例如毛泽东主席，他半边床上都是书，一读起书来便进入忘我的境界。
书是我生活中的好朋友，是我人生道路上的航标，读书，读好书，是我无怨无悔的追求。
当我被上帝造出来时，上帝问我想在人间当一个怎样的人，我不假思索的说，我要做一个伟大的世人皆知的人。
于是，我降临在了人间。
我出生在一个官僚知识分子之家，父亲在朝中做官，精读诗书，母亲知书答礼，温柔体贴，父母给我去了一个好听的名字：
李清照。
小时侯，受父母影响的我饱读诗书，聪明伶俐，在朝中享有“神童”的称号。
小时候的我天真活泼，才思敏捷，小河畔，花丛边撒满了我的诗我的笑，无可置疑，小时侯的我快乐无虑。
“兴尽晚回舟，误入藕花深处。
争渡，争渡，惊起一滩鸥鹭。
”青春的我如同一只小鸟，自由自在，没有约束，少女纯净的心灵常在朝阳小，流水也被自然洗礼，纤细的手指拈一束花，轻抛入水，随波荡漾，发髻上沾着晶莹的露水，双脚任水流轻抚。
身影轻飘而过，留下一阵清风。
可是晚年的我却生活在一片黑暗之中，家庭的衰败，社会的改变，消磨着我那柔弱的心。
我几乎对生活绝望，每天在痛苦中消磨时光，一切都好象是灰暗的。
“寻寻觅觅冷冷清清凄凄惨惨戚戚”这千古叠词句就是我当时心情的写照。
最后，香消玉殒，我在痛苦和哀怨中凄凉的死去。
在天堂里，我又见到了上帝。
上帝问我过的怎么样，我摇摇头又点点头，我的一生有欢乐也有坎坷，有笑声也有泪水，有鼎盛也有衰落。
我始终无法客观的评价我的一生。
我原以为做一个着名的人，一生应该是被欢乐荣誉所包围，可我发现我错了。
于是在下一轮回中，我选择做一个平凡的人。
我来到人间，我是一个平凡的人，我既不着名也不出众，但我拥有一切的幸福：
我有温馨的家，我有可亲可爱的同学和老师，我每天平凡而快乐的活着，这就够了。
天儿蓝蓝风儿轻轻，暖和的春风带着春的气息吹进明亮的教室，我坐在教室的窗前，望着我拥有的一切，我甜甜的笑了。
我拿起手中的笔，不禁想起曾经作诗的李清照，我虽然没有横溢的才华，但我还是拿起手中的笔，用最朴实的语言，写下了一时的感受：
人生并不总是完美的，每个人都会有不如意的地方。
这就需要我们静下心来阅读自己的人生，体会其中无尽的快乐和与众不同。
“富不读书富不久，穷不读书终究穷。
”为什么从古到今都那么看重有学识之人？
那是因为有学识之人可以为社会做出更大的贡献。
那时因为读书能给人带来快乐。
自从看了《丑小鸭》这篇童话之后，我变了，变得开朗起来，变得乐意同别人交往，变得自信了……因为我知道：
即使现在我是只“丑小鸭”，但只要有自信，总有一天我会变成“白天鹅”的，而且会是一只世界上最美丽的“白天鹅”……
我读完了这篇美丽的童话故事，深深被丑小鸭的自信和乐观所折服，并把故事讲给了外婆听，外婆也对童话带给我们的深刻道理而惊讶不已。
还吵着闹着多看几本名着。
于是我给外婆又买了几本名着故事，她起先自己读，读到不认识的字我就告诉她，如果这一面生字较多，我就读给她听整个一面。
渐渐的，自己的语文阅读能力也提高了不少，与此同时我也发现一个人读书的乐趣远不及两个人读的乐趣大，而两个人读书的乐趣远不及全家一起读的乐趣大。
于是，我便发展“业务”带动全家一起读书……现在，每每遇到好书大家也不分男女老少都一拥而上，争先恐后“抢书”，当我说起我最小应该让我的时候，却没有人搭理我。
最后还把书给撕坏了，我生气地哭了，妈妈一边安慰我一边对外婆说：
“孩子小，应该让着点。
”外婆却不服气的说：
“我这一把年纪的了，怎么没人让我呀？
”大家人你一言我一语，谁也不肯相让……读书让我明白了善恶美丑、悲欢离合，读一本好书，犹如同智者谈心、谈理想，教你辨别善恶，教你弘扬正义。
读一本好书，如品一杯香茶，余香缭绕。
读一本好书，能使人心灵得到净化。
书是我的老师，把知识传递给了我；书是我的伙伴，跟我诉说心里话；书是一把钥匙，给我敞开了知识的大门；书更是一艘不会沉的船，引领我航行在人生的长河中。
其实读书的真真乐趣也就在于此处，不是一个人闷头苦读书；也不是读到好处不与他人分享，独自品位；更不是一个人如痴如醉地沉浸在书的海洋中不能自拔。
而是懂得与朋友，家人一起分享其中的乐趣。
这才是读书真正之乐趣呢！
这所有的一切，不正是我从书中受到的教益吗？
我阅读，故我美丽；我思考，故我存在。
我从内心深处真切地感到：
我从读书中受到了教益。
当看见有些同学宁可买玩具亦不肯买书时，我便想到培根所说的话：
“世界上最庸俗的人是不读书的人，最吝啬的人是不买书的人，最可怜的人是与书无缘的人。
”许许多多的作家、伟人都十分喜欢看书，例如毛泽东主席，他半边床上都是书，一读起书来便进入忘我的境界。
书是我生活中的好朋友，是我人生道路上的航标，读书，读好书，是我无怨无悔的追求。
升级会员 