中国电信商务领航定制终端技术服务支撑平台系统_源数据采集接口技术方案1013

接口规范页码：1/14中国电信商务领航定制终端管理系统技术规范（BNSP接口）2008年10月接口规范页码：2/141.定义和缩写......................................................................................................................................32.系统目标..........................................................................................................................................43.接口概述..........................................................................................................................................54.接口说明..........................................................................................................................................74.1.源数据发布接口.....................................................................................................................74.1.1.接口场景描述.....................................................................................................................74.1.2.接口时序.............................................................................................................................74.2.获取数据集成反馈结果接口................................................................................................114.2.1.接口场景描述...................................................................................................................114.2.2.接口时序...........................................................................................................................111.数据反馈通知方式....................................................................................................................122.数据反馈通知文件命名及格式规范........................................................................................135.异常处理........................................................................................................................................14接口规范页码：3/141.定义和缩写接收数据系统：商务领航定制终端技术服务支撑平台系统：简称（BNSP）传送数据系统：各省的网关管理系统：简称（BBMS）接口规范页码：4/142.系统目标能查询按网关类型划分的统计内容能查询按套餐类型划分的统计内容能查询按接入方式划分的统计内容能查询按厂商划分的统计内容能查询按业务状态划分的统计内容接口规范页码：5/143.接口概述BNSP（商务领航定制终端技术服务支撑平台系统）A省BBMS系统B省BBMS系统C省BBMS系统数据传送接口各省BBMS作为源系统，将源数据以文本文件方式通过FTP方式（程序自动实现）保存到BNSP系统的指定路径，BNSP系统去指定路径获得源数据。具体流程如下：BNSP系统首先在本地FTP的指定路径下建立省份文件夹，其次在省份文件中每天创建时间文件夹各省BBMS系统按照规定的格式，将源数据生成的文本文件保存在BNSP系统的服务器下，.数据生成以天为单位，形成多个数据源文件。BNSP系统去本地指定的文件夹进行数据采集。BNSP系统读取BBMS系统数据进行入库处理。数据入库处理结束后，同时生成结果报告反馈给各省BBMS系统。如果其中某个省的传输源文件没有收到、格式错误和其它错误，BNSP系统会生成ErrorReport文件，并把反馈文件存放在本地的服务器下，BBMS系统进行自动获取该文件，并判断传输数据是否正确。各系统接口的实现功能接口规范页码：6/14BNSP（商务领航定制终端技术服务支撑平台系统）实现的功能：定期创建时间文件夹，存放BBMS系统的源数据定期获取BBMS系统传送的源数据文件数据处理完成后，反馈数据集成结果给各省BBMS系统各省BBMS系统实现的功能：定期生成源数据文件并发送到BNSP系统指定的文件路径。获取BNSP（商务领航定制终端技术服务支撑平台系统）的数据集成结果的反馈接口规范页码：7/144.接口说明4.1.源数据发布接口4.1.1.接口场景描述该接口用于各业务系统（各省BBMS系统）向BNSP系统定期传送源数据。4.1.2.接口时序业务流程：省BBMS系统BNSP系统1、传送源数据3、获取数据集成反馈（异步）2、数据读取、处理发起方：各省BBMS系统接收方：BNSP系统接口协议：ftp数据传送方式IP地址为：xxx.xxx.xxx.xxxFTP帐号为：用户名/******，（暂定为:用户名：省份码+user，密码：省份码＋user目录：/sme/省份码/时间文件夹放置各省BBMS系统传送的源数据文件；接口规范页码：8/14各省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接口规范页码：9/14天津市S30重庆市S312)表名：网关型号统计表：gateway套餐类型统计表：series接入方式统计表：connect_way厂商网关型号统计表：factor_gateway业务类型统计表：work_type3)文件采集时间，（注：文件生成时间的前一天，既数据采集时间）：用“YYYYMMDD”表示，如2007年10月20日表示为“20071020”；数据文件格式采用文本方式，每个字段之间用竖线相隔，如果字段内容为空则用大写字符串“NULL”表示，每一条记录按照换行来相隔。数据传送时间1)各省BBMS系统每日于3：00传送相关数据文件；2)BNSP系统于每日4：00，读取数据文件；3)BNSP系统于每日4点30生成当天的采集结果的反馈文件；文件内容数据文件：网关型号统计表：gateway网关型号统计表（gateway_table）字段含义字段名类型描述位置信息（省份）provincevarchar2(20)参照编码表受理量accetpint总数量，具体详见备注注册量registint总数量，具体详见备注在线量device_statusint总数量，具体详见备注接口规范页码：10/14网关型号gateway_typevarchar2(20)参照编码表统计时间timestring(10)格式：年－月－日套餐类型统计表：series套餐类型统计表（series_table）字段含义字段名类型描述位置信息（省份）provincevarchar2(20)参照编码表受理量accetpint总数量，具体详见备注注册量registint总数量，具体详见备注套餐类型series_typevarchar2(20)参照编码表速率gateway_speedvarchar2(20)参照编码表统计时间timestring(10)格式：年－月－日接入方式统计表：connect_way接入方式统计表（connect_way_table）字段含义字段名类型描述位置信息（省份）provincevarchar2(20)参照编码表数量numint总数量百分比percentvarchar2(8)格式为：25%接入方式connect_typevarchar2(20)参照编码表统计时间timestring(10)格式：年－月－日厂商网关型号统计表：factor_gateway厂商网关型号统计表（factory_gateway_table）字段含义字段名类型描述位置信息（省份）provincevarchar2(20)参照编码表注册量registint总数量，具体详见备注网关型号gateway_typevarchar2(20)参照编码表厂商factory_namevarchar2(20)参照编码表统计时间timestring(10)格式：年－月－日业务类型统计表：work_type业务类型统计表（work_type_table）接口规范页码：11/14字段含义字段名类型描述位置信息（省份）provincevarchar2(20)参照编码表开通量opensnumberint总数量暂停量pausenumberint总数量复机量restorationnumberint总数量移机量movesnumberint总数量拆机量stopsnumberint总数量业务名称work_namevarchar2(20)参照编码表统计时间timestring(10)格式：年－月－日备注：受理量：受理量是CRM受理的网关设备量的统计注册量：注册量是BBMS管理的网关设备量的统计在线量：在线量是BBMS统计时刻网关设备在线数量4.2.获取数据集成反馈结果接口4.2.1.接口场景描述该接口用于BNSP系统反馈数据集成结果。4.2.2.接口时序业务流程：省BBMS系统BNSP系统数据集成反馈（异步）发起方：各省BBMS系统接口规范页码：12/14接收方：BNSP系统接口协议：ftp接收数据集成反馈结果接口格式：数据传送方式IP地址为：xxx.xxx.xxx.xxxFTP帐号为：同上面定义，目录：BBMS系统需去BNSP系统FTP服务器下指定路径去获取/SME/省份码/时间文件夹BNSP系统上传的反馈信息文件；在每天BNSP系统采集完各省的BBMS数据后，系统会对采集的数据文件进行检查，以确定从各省采集的BBMS数据是否有数据文件缺失。如果某省发生数据文