中国移动一级经营分析系统中央业务平台数据下发接口规.docx
- 文档编号:4007914
- 上传时间:2022-11-27
- 格式:DOCX
- 页数:31
- 大小:39.49KB
中国移动一级经营分析系统中央业务平台数据下发接口规.docx
《中国移动一级经营分析系统中央业务平台数据下发接口规.docx》由会员分享,可在线阅读,更多相关《中国移动一级经营分析系统中央业务平台数据下发接口规.docx(31页珍藏版)》请在冰豆网上搜索。
中国移动一级经营分析系统中央业务平台数据下发接口规
中国移动一级经营分析系统
中央业务平台数据下发接口规范
飞信分册V1.0
中国移动通信有限公司
2007年07月
文档变更记录
序号
变更内容说明
版本号
修订日期
生效日期
1
文档建立
1.0
2007-07-03
2007年7月
1总则
2
2.1背景
2.2
为方便各省经营分析系统共享和利用各中央业务平台产生的大量信息资源,为各省公司的市场经营、决策管理提供及时、准确、科学的数据和应用支撑,特制定本规范。
2.3目的
2.4
Ø制订全国统一的接口规范,由一级经营分析系统将中央业务平台相关数据分发各省经营分析系统;
Ø
Ø各省经营分析系统根据此接口规范获取中央业务平台数据,并依据规定的数据格式入库存储,开展后续应用分析。
Ø
2.5适用范围
2.6
本接口规范是中国移动一级经营分析系统中央业务平台接口数据下发的基本依据。
中国移动各中央业务平台数据的下发以及省公司接收数据应依照本规范执行。
2.7起草单位
2.8
本接口规范由中国移动通信有限公司业务支撑系统部负责起草。
2.9解释权
2.10
本接口规范的增补、修订及解释权属中国移动通信有限公司业务支撑系统部。
2.11参考文档
2.12
《中国移动省级经营分析系统与源系统接口规范v2.0》
《中国移动一级经营分析系统省级数据接口规范》
2.13缩略语
2.14
本文将用到以下名词及缩写:
缩写
专用名词
有限公司
中国移动通信有限公司
一经系统
中国移动一级经营分析系统
二经系统
中国移动省级经营分析系统
飞信
基于手机应用以及与Internet深度互通的即时通讯产品
中央业务平台
泛指在全网一点集中建设运营的业务平台
2.15约定
名词
说明
源数据提供方
有限公司一经系统
数据接收方
各省公司二经系统
接口文件
指源数据提供方根据本方案要求生成的供二经使用的文件,包括接口数据文件、接口校验文件。
接口数据文件
是指源数据提供方根据本方案要求,在指定的时间内,完成对源数据进行周期性抽取所形成的数据文件。
接口校验文件
指由源数据提供方在每一个抽取周期中,针对每个接口数据文件产生的文件级校验所依据的信息。
文件级校验报告
指一级经营分析系统对每一个接口数据文件进行文件级校验后产生的报告文件。
日志文件
指接口系统在操作过程中进行数据处理的记录文件。
由一经系统和中央业务平台产生。
包括传输日志、链路状态日志、告警日志等。
每日增量
指抽取每日00:
00---24:
00发生变化的、新产生数据的最新状态的快照。
每月增量
指抽取每月1日00:
00时始至月未最后一日24:
00止,发生变化的、新产生的数据最新状态的快照。
每日全量
指抽取每日24:
00时,所有数据的最新状态快照。
每月全量
指抽取每月月未最后一日24:
00时,所有数据的最新状态快照。
每日新增数据
指抽取每日00:
00---24:
00新产生的数据。
每月新增数据
指抽取每月1日00:
00时始至月未最后一日24:
00止,新产生的数据。
3接口说明
4
4.1接口双方责任
4.2
4.2.1源数据提供方的责任
4.2.2
Ø保证提供接口方案规定的数据内容,并在指定的时间范围内完成数据的生成。
Ø
Ø保证接口数据文件的大小不能超过2GB,如果接口数据文件太大,必须按要求将文件拆分,拆分后的文件命名参见文件分类及命名规则。
Ø
Ø根据接口规范的要求,保证接口文件中的记录各值域在有效的取值范围内,数据中均不能包含0x0D0A(回车换行符),确保数据的有效性和准确性。
Ø
Ø数据的提供方负责数据的一致性控制,保证生成的接口数据与中央业务平台中存储的数据一致。
Ø
Ø遵循本接口方案中规定的校验规则和异常处理规则,保证提供数据的质量。
Ø
4.2.3数据接收方的责任
4.2.4
Ø负责与源数据提供方的信息交互和沟通。
Ø
Ø负责对源数据提供方提供的接口数据文件、接口校验文件进行即时的读取、接收、核对及传输。
Ø
4.3接口文件命名规则
4.4
4.4.1中央业务平台列表
4.4.2
Ø飞信平台
Ø
4.4.3接口单元编码规则
4.4.4
对中央业务平台的各接口单元的编码采用平台代码与序列号组成,其中平台代码为三位数字,序列号为两位数值,各接口单元的编码规则是:
<平台代码><序列号>。
平台代码编码表:
系统名称
平台代码
飞信业务平台
400
4.4.5文件分类及命名规则
文件类型
文件名格式
备注
接口数据文件
正常数据:
增量/全量/新增数据标志_省份编码_数据日期_接口单元编码_重传序号_序列号.dat
如正常数据为:
a_10100_20031201_01001_00_001.dat
增量_省份编码_数据日期_接口单元编码_重传序号_序列号.后缀名
接口校验文件
正常数据:
增量/全量/新增数据标志_省份编码_数据日期_接口单元编码_重传序号.verf
对同一个抽取周期同一个接口单元产生的接口数据,如果有文件拆分的,需要将这些文件的校验信息写在同一个接口校验文件内,所以文件名不需要序列号
文件级校验报告
单个报告文件命名:
正常数据:
f_增量/全量/新增数据标志_省份编码_数据日期_接口单元编码_重传序号_序列号.verf
每一个数据文件,对应一个文件级校验报告
省份编码参见:
附录一
4.4.6文件命名说明
4.4.7
Ø文件名称中的要素取值
Ø
✧增量/全量标志
✧
取值为:
增量:
“a”,全量:
“i”,新增数据:
“s”;
✧省份编码
✧
具体编码请参见附录一。
✧接口单元编码
✧
接口单元编码是每一个接口单元的唯一标识,各接口单元的编码请参见下文。
✧数据日期
✧
数据日期是描述当前抽取周期中,数据的发生日期(如:
20031201,则表示抽取的数据是2003年12月1日的快照)。
按日抽取的数据文件,其数据日期就是数据的发生日期;按月抽取的数据文件,则数据日期取数据发生的年月(对数据日期有特殊要求的接口单元,将在其“数据要求”中详细描述)。
✧系统日期
✧
系统日期是描述程序处理的日期。
例如:
记录日志文件时,操作日志文件的日期即为当时取得的操作系统时间。
✧重传序号
✧
重传序号必须是二位数字型字符。
重传序号是用于描述同一个接口单元的同一数据日期内,由于数据异常、校验重传等原因,需要重新生成、上传数据时,则需要通过重传序号来描述当前接口文件的重传顺序号:
00:
表示该数据日期的接口文件是首次正常生成数据上传(非重传)
01:
表示该数据日期的接口文件是第一次重传
02:
表示该数据日期的接口文件是第二次重传
…
N+1:
表示该数据日期的接口文件是第N+1次重传
✧序列号
✧
序列号必须是三位数字型字符。
序列号是用于描述同一个接口单元在同一个抽取周期中的文件顺序号,若一个接口单元被分割成多个文件或每日多次抽取同一个接口单元,则其流水号必须不同,并且依次递增,如:
001、002、003;
Ø接口数据文件、接口校验文件、接口文件校验报告等所有文件在文件生成过程中,后缀为.tmp,待生成文件成功后,再改成.dat等后缀名;此措施用于防止文件生成过程中发生异常。
Ø
Ø所有的文件名称中用到的字母均需小写。
Ø
4.5接口文件设计
4.6
4.6.1设计原则
4.6.2
在满足要求的前提下,为了使应用接口尽量简单、明了,并便于实现,一级经营分析系统下发的中央业务平台的数据采用文本文件方式,文件格式采用ASCII码格式。
为了保证接口数据的一致性,避免各类数据类型和格式错误,在形成所传输的ASCII格式文件之前,将数据转成本接口方案所规定的数据类型和格式。
接口文件均按本方案要求的数据内容、数据类型长度及顺序采用定长方式记录数据,每行数据以回车换行符0x0D0A结束(抽取的数据内容中不能包含此符号)。
如果数据的实际字节长度小于方案中要求的字段长度,则必须用空格补齐(右补齐),如果数据的实际长度大于方案中的要求,则需要截断(如字符描述)。
接口数据文件均按此描述及顺序,以定长方式记录数据,并以0x0D0A(回车换行符)为每行的结束标志,因此,数据内容中不能包含0x0D0A(回车换行符)。
4.6.3接口文件格式
4.6.4
4.6.4.1接口数据文件
4.6.4.2
接口数据文件的格式请参见下文中对各接口单元的具体描述。
4.6.4.3接口校验文件
4.6.4.4
接口校验文件是由源数据提供方负责,用于描述每一个传输周期内,提供的接口文件的文件列表及数据校验信息,数据采用定长方式,校验文件中的信息由以下内容组成:
顺序
信息内容
数据类型及长度
说明
1
接口数据文件名称
char(40)
2
文件的大小(字节数)
number(20)
文件的物理存储大小
3
文件中包含的记录数
number(20)
文件中包含的记录数
4
数据日期
char(8)
日期格式:
YYYYMMDD,如果抽取周期为月,则格式为:
YYYMM,后两位补空格;
5
文件的生成时间
char(14)
日期格式:
YYYYMMDDHH24MMSS
6
0x0D0A
回车换行符
4.7数据质量保障
4.8
4.8.1数据转换规则
4.8.2
源数据提供方在生成接口数据文件时,必须遵守如下数据转换规则:
Ø无意义维度取值的转换
Ø
对中央业务平台中维度取值为NULL值、空值,必须转换成规定长度的空格。
Ø编码格式
Ø
✧汉字:
GBK内码
✧
✧西文:
ASCII码
✧
Ø数字格式
Ø
✧在接口数据文件中,数字的表示必须规范,小数点的前后必需有数字,如:
0.01或34.0,不能用“.01”或“34.”表示;
✧
✧符号处理:
数字最高位的左边第一位为符号位。
对于负数,符号位为“-”,正数不用加符号位;
✧
✧左对齐,必须以空格右填充至定义的长度;
✧
Ø字符格式
Ø
✧左对齐,必以空格右填充至定义的长度;
✧
Ø空记录(NULL)
Ø
数据仓库系统中不允许出现NULL,所有中央业务平台中出现的NULL被认为是无意的,所以在上传数据文件中,NULL必须按照如下规则转换:
✧字符类型的NULL,以空格填充至定义的长度
✧
✧数字类型的NULL,以0填充,并加以空格填充至定义的长度
✧
✧时间类型的NULL,以空格填充至定义的长度
✧
Ø空格
Ø
✧在业务系统中,字段的值完全为空格(一个或多个)或字段值首尾包含的空格,在数据仓库中视为无意义,所以如果在业务系统存在中以上类型的空格,必须转换为有意义的其它字符,字符串的前后空格均视为无意义。
✧
Ø日期类型
Ø
✧日期类型统一采用YYYYMMDD格式,YYYYMMDD必须为有意义的日期
✧
✓YYYY为四位数字,必须是有效的年份
✓
✓MM为两位数字,必须是有效的月份(01-12)
✓
✓DD为两位数字,必须是有效的日期(01-31)
✓
✧对于不符合日期约束规则的日期值,处理方式存在以下两种情况:
✧
1)无值的日期或者无意义的日期,这时在接口中一律以“00010101”(公元元年1月1日)填充;
2)
3)接口单元中的“失效日期”在表示“未失效”含义时,一律以“29991231”(公元2999年12月31日)填充。
4)
✧在以下数据接口单元中,日期类型统一使用“date”定义。
✧
Ø时间类型
Ø
✧统一采用HHMMSS格式
✧
✓HH为两位数字,必须是有效的小时(00-23),24小时制
✓
✓MM为两位数字,必须是有效的分钟(00-59)
✓
✓SS为两位数字,必须是有效的秒(00-59)
✓
✧对于不符合时间约束规则的时间值,处理方式同NULL
✧
4.8.3文件级校验
4.8.4
文件级校验是指根据源数据提供方提供的接口校验文件信息,对传输的接口数据文件进行校验,校验内容如下:
Ø接口数据文件名称
Ø
✧根据接口校验文件中记录的文件名,查找“接口数据文件目录”(参见文件目录的划分)下该接口数据文件是否存在。
✧
✧检查接口数据文件的名称是否遵守本规范中的命名规范(参见文件分类及命名规则)。
✧
Ø数据日期
Ø
验证接口校验文件中记载的数据日期与接口数据文件名中的数据日期(参见文件命名说明)是否一致。
Ø文件的生成日期
Ø
验证接口校验文件中记载的文件生成日期与实际接口数据文件的生成日期是否一致。
Ø文件的大小(字节数)
Ø
验证接口校验文件中记载的文件大小与实际接口数据文件的文件大小是否一致。
Ø文件中包含的记录数
Ø
验证接口校验文件中记载的文件记录数与实际接口数据文件中的记录行数是否一致。
Ø文件中单行记录的长度
Ø
验证实际接口数据文件中的每行记录长度是否与本规范定义的长度一致。
4.8.5数据异常处理机制
4.8.6
4.8.6.1发送方触发
4.8.6.2
有限公司一经系统如果发现已经下发的数据有问题,将重新生成数据并进行下发,并通知各省公司重新获取和加载。
4.8.6.3接收方触发
4.8.6.4
各省公司如果发现下发的数据有错误或者未及时下发,需和有限公司联系,由有限公司更新数据。
4.8.7系统及时性要求
4.8.8
对于下发周期为日的接口单元,源数据提供方在当日12点前完成上一日的数据下发任务;对于下发周期为月的数据,源数据提供方在次月5日前完成上月数据下发任务。
数据接收方的接口系统应在2小时内读取当日接口文件并删除。
4.9文件目录及维护
4.10
4.10.1文件目录的划分
4.10.2
一经系统中央业务平台接口数据下发文件目录设置如下。
目录编号
目录名称
存放内容
说明
二经权限
一经权限
①
/interface/fetion/incoming
飞信接口数据文件
存放有限公司下发的飞信文件
读、写
读、写
②
/interface/fetion/backup
数据备份目录
备份数据
读
读、写
说明:
1.incoming目录各省公司登陆后可以读取相关接口文件,各省公司取走之后需要删除原文件以释放空间;
2.
3.当省公司下载下来的文件发生遗失或者损坏,可以到backup目录下重新下载。
4.
4.11文件的保存期
目录名称
存放内容
存放期限
/interface/fetion/backup
数据备份目录
4月
说明:
1.各省接口服务器将配置程序定期删除过期文件。
2.
5接口数据
6
6.1数据接口
接口单元编码
接口单元名称
接口单元说明
40001
日活跃用户明细
截至当日24时,当日有过订购关系的用户且登录过PC客户端或手机客户端或WAP客户端或发送过上行短信或使用过IVR通话的用户
40002
月活跃用户明细
截至当月最后一天24时,当月有过订购关系的用户且登录过PC客户端或手机客户端或WAP客户端或发送过上行短信或使用过IVR通话的用户
40003
日用户开通/关闭操作记录
记录每日00时00分00秒到24时00分00秒,飞信用户开通/关闭操作记录
40004
飞信用户登录信息
记录飞信用户当天24小时内登录操作记录,本接口操作记录数据不进行排重
40005
飞信用户好友明细
本接口提供截止到当月底,在网飞信用户的好友数据
6.1.1日活跃用户明细
6.1.2
6.1.2.1数据内容
接口单元名称:
日活跃用户明细
接口单元编码:
40001
接口单元说明:
截至当日24时,当日有过订购关系的用户且登录过PC客户端或手机客户端或WAP客户端或发送过上行短信或使用过IVR通话的用户
接口单元属性列表:
属性编码
属性名称
属性英文名称
属性类型
备注
00
记录行号
number(8)
唯一标识记录在接口数据文件中的行号。
01
日期
DayTime
Char(8)
格式:
”YYYYMMDD”。
数据日期与接口文件命名中日期保持一致,均取生成接口文件当前日期的前一天作数据日期。
02
手机号
MobileNo
char(11)
手机号
03
飞信号
Sid
char(9)
用户开通的飞信号。
一个手机号码只能拥有一个飞信号
04
活跃方式
OpType
char
(2)
活跃方式,每2位代表一种方式,
01--PC
02--短信
03--IVR
04--Wap
05--手机
具体类型以字典接口为准
0x0D0A
回车换行符
6.1.2.2抽取方式及周期
6.1.2.3
每日新增抽取。
6.1.2.4接口单元文件名称
6.1.2.5
Ø每日新增抽取数据时
Ø
✧接口数据文件名
✧
s_XXXXX_yyyymmdd_40001_XX_XXX.dat
✧校验文件名
✧
s_XXXXX_yyyymmdd_40001_XX.verf
6.1.3月活跃用户明细
6.1.4
6.1.4.1数据内容
接口单元名称:
月活跃用户明细
接口单元编码:
40002
接口单元说明:
截至当月最后一天24时,当月有过订购关系的用户且登录过PC客户端或手机客户端或WAP客户端或发送过上行短信或使用过IVR通话的用户
接口单元属性列表:
属性编码
属性名称
属性英文名称
属性类型
备注
00
记录行号
number(8)
唯一标识记录在接口数据文件中的行号。
01
日期
DayTime
Char(6)
格式:
”YYYYMM”。
02
手机号
MobileNo
char(11)
手机号
03
飞信号
Sid
char(9)
用户开通的飞信号。
一个手机号码只能拥有一个飞信号
04
活跃方式
OpType
char
(2)
活跃方式,每2位代表一种方式,
01--PC
02--短信
03--IVR
04--Wap
05--手机
具体类型以字典接口为准
0x0D0A
回车换行符
6.1.4.2抽取方式及周期
6.1.4.3
每月新增抽取。
6.1.4.4接口单元文件名称
6.1.4.5
Ø每月新增抽取数据时
Ø
✧接口数据文件名
✧
s_XXXXX_yyyymm_40002_XX_XXX.dat
✧校验文件名
✧
s_XXXXX_yyyymm_40002_XX.verf
6.1.5日用户开通/关闭操作记录
6.1.6
6.1.6.1数据内容
接口单元名称:
日用户开通/关闭操作记录
接口单元编码:
40003
接口单元说明:
记录每日00时00分00秒到24时00分00秒,飞信用户开通/关闭操作记录
接口单元属性列表:
属性编码
属性名称
属性英文名称
属性类型
备注
00
记录行号
number(8)
唯一标识记录在接口数据文件中的行号。
01
日期
DayTime
char(8)
格式:
”YYYYMMDD”数据日期与接口文件命名中日期保持一致,均取生成接口文件当前日期的前一天作数据日期。
02
手机号
MobileNo
char(11)
用户手机号码PK
03
飞信号
Sid
char(9)
用户开通的飞信帐号一个用户只能拥有一个飞信号。
04
操作类型
OpType
char
(2)
通过字典传送取值范围和定义
PK
取值如:
00开通
01关闭
02销号
03暂停
04恢复
05
操作时间
OpTime
char(14)
格式:
YYYYMMDDHHMMSS
06
操作方式
OpStyle
char
(2)
通过字典传送取值范围和定义
取值如:
00批开
01自主
07
请求来源
RequestSource
char(10)
通过字典传送取值范围和定义
0x0D0A
回车换行符
6.1.6.2抽取方式及周期
6.1.6.3
每日新增抽取。
6.1.6.4接口单元文件名称
6.1.6.5
Ø每日新增抽取数据时
Ø
✧接口数据文件名
✧
s_XXXXX_yyyymmdd_40003_XX_XXX.dat
✧校验文件名
✧
s_XXXXX_yyyymmdd_40003_XX.verf
6.1.7飞信用户登录信息
6.1.8
6.1.8.1数据内容
接口单元名称:
飞信用户登录信息
接口单元编码:
40004
接口单元说明:
记录飞信用户当天24小时内登录操作记录,本接口操作记录数据不进行排重
接口单元属性列表:
属性编码
属性名称
属性英文名称
属性类型
备注
00
记录行号
number(8)
唯一标识记录在接口数据文件中的行号。
01
日期
DayTime
char(8)
格式:
”YYYYMMDD”
数据日期与接口文件命名中日期保持一致,均取生成接口文件当前日期的前一天作数据日期
02
手机号
MobileNo
char(11)
用户手机号码 PK
03
飞信号
Sid
char(9)
用户开通的飞信帐号一个用户只能拥有一个飞信号。
04
操作类型
OpType
char
(2)
通过字典传送取值范围和定义
取值如:
01登录
02下线
05
操作时间
OpTime
char(14)
格式:
YYYYMMDDHHMMSS24时制
06
终端类型
ClientType
char(10)
通过字典传送取值范围和定义
取值如:
飞信PC客户端
飞信手机JAVA客户端
飞信手机SYMBIAN客户端
飞信手机SMARTPHONE客户端飞信手机POCKETPC客户端
飞信WAP客户端
短信
0x0D0A
回车换行符
6.1.8.2抽取方式及周期
6.1.8.3
每日新增抽取。
6.1.8.4接口单元文件名称
6.1.8.5
Ø每日新增抽取数据时
Ø
✧接口数据文件名
✧
s_XXXXX_yyyymmdd_40004_XX_XXX.dat
✧校验文件名
✧
s_XXXXX_yyyymmdd_40004_XX.verf
6.1.9飞信用户好友明细
6.1.10
6.1.10.1
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国移动 一级 经营 分析 系统 中央 业务 平台 数据 下发 接口
![提示](https://static.bdocx.com/images/bang_tan.gif)