集中化经分系统省级数据接口规范总册
(V1.0.1)
中国移动通信有限公司
2015年1月
1
文档变更记录
序号 1-8 9 式；具体的分隔符约定在各分册中明确； 修改3.4.2.1章结非批次上传接口校验文件样式 ，10 添加MD5校验码内容。该项是否启用在各分册中明确； 修改3.4.3.2章结，文件级校验报告，添加，18：11 MD5校验错误，该项是否启用在各分册中明确；记录级校验报告，补充详细代码 修改附录2各数据源系统编码，修改总部合并ERP12 及总部预算一级系统的编码 修改3.4.3.2记录级校验报告，扩充错误代码字段13 为9位，并修改备注说明，分批接口批次结束文件记录级校验报告除外 修订2.3 数据编码及转换要求章节中数字格式规14 范中，增加DECIMAL类型规范说明 1.0.1 2015-01-16 1.0.1 2015-01-15 2015年2月5日起生效(当天下发的记录级报告按新版规范执行) 2015年2月 1.0.1 2014-12-02 2015年2月 1.0.1 2014-12-02 2015年2月 1.0.1 2014-12-02 2015年2月 变更内容说明 见附件3 修订记录历史 修改第3章，每行记录格式的说明。增加分隔符方1.0.1 2014-12-02 版本号 1.0 版本日期 2004-1-15 2015年2月 生效日期
2
目 录
1
总则 ................................................................................................................................................ 5 1.1. 1.2. 2
设计原则 ...................................................................................................................................... 5 名词约定 ...................................................................................................................................... 5
接口上传流程与校验机制 .............................................................................................................. 8 2.1
接口双方责任 .............................................................................................................................. 8
源数据提供方的责任 .......................................................................................................... 8
2.1.2 数据接收方的责任 .............................................................................................................. 8 2.2 接口上传流程 ............................................................................................................................ 10 2.2.1 数据提供方接口的实现 .................................................................................................... 12 2.2.2 数据接收方接口的实现 .................................................................................................... 14 2.2.3 分批次接口上传的实现 .................................................................................................... 15 2.2.4 1%抽样数据接口的实现 ....................................................................................................... 16 2.3 数据编码及转换要求 ................................................................................................................ 17 2.4 接口数据的校验机制 ................................................................................................................ 19 2.4.1 文件级校验 ........................................................................................................................ 19 2.4.2 业务逻辑校验 .................................................................................................................... 20 2.4.2.1 记录级校验 ................................................................................................................................... 20 2.4.2.2 业务指标校验 ............................................................................................................................... 20
2.5
异常数据的处理机制 ................................................................................................................ 21 2.5.1
2.1.1
数据接收方触发 ................................................................................................................ 21 2.5.1.1 非批次上传接口 ........................................................................................................................... 21 2.5.1.2 分批次上传接口 ........................................................................................................................... 21
源数据提供方触发 ............................................................................................................ 22
2.5.2 3
接口文件格式要求及说明 ............................................................................................................ 22 3.1 3.2 3.3
接口数据的抽取周期 ................................................................................................................ 23 接口单元分类及编码 ................................................................................................................ 23 文件分类及命名规则 ................................................................................................................ 24
文件的分类 ........................................................................................................................ 24 3.3.2 文件命名规则 .................................................................................................................... 27 3.4 接口文件格式 ............................................................................................................................ 29 3.4.1 接口数据文件 .................................................................................................................... 29 3.4.2 接口校验文件 .................................................................................................................... 29 3.4.2.1 非批次上传接口 ........................................................................................................................... 29 3.4.2.2 批次接口上传 ............................................................................................................................... 30
3.4.3
3.3.1
校验报告文件格式 ............................................................................................................ 31 3.4.3.1 文件级校验报告 ........................................................................................................................... 31 3.4.3.2 记录级校验报告 ........................................................................................................................... 33
3.4.4 1%抽样用户列表文件格式 ................................................................................................... 36 4
文件目录及维护 ........................................................................................................................... 36
3
4.1 4.2 4.3
文件目录的划分 ........................................................................................................................ 36 文件目录的维护 ........................................................................................................................ 38 文件的存储周期 ........................................................................................................................ 39
附录1 各省级系统运营机构编码 ....................................................................................................... 39 附录2 各数据源系统编码 ................................................................................................................... 41 附录3 修订记录历史 .......................................................................................................................... 41
4
1 总则
为支撑集中化经分系统的建设及运营，满足全网经营管理与决策分析的工作需求，《集中化经分系统省级数据接口规范（总册及各源系统分册）》是总部与各省公司源数据系统之间交互数据的标准规范。
总册说明两级系统之间接口交互时应遵循的的流程、机制与要求。
1.1. 设计原则
为了保证集中化经分系统与各数据源系统方便、可靠的交互接口数据，本接口规范主要遵循以下设计原则：
? 接口定义遵循易理解、易使用、易交流、方便扩展的原则； ? 保证集中化经分系统与各数据源系统中的数据一致性；
? 接口数据传输控制策略可靠且完善，具有可靠的数据异常处理机制。
1.2. 名词约定
名词 源数据提供方 数据接收方 接口文件 说明 负责建设运营源系统并提供接口数据的责任方 负责收取源数数的责任方，本规范默认为总部集中化经分项目组 指源数据提供方根据规范要求生成供集中化经分系统采集的数据，包括接口数据文件、接口校验文件和业务指标校验文件等 接口数据文件 是指源数据提供方根据本规范要求，在指定的时间内，完成对源数据的周期性抽取形成的数据文件 接口校验文件 指由源数据提供方在每一个抽取周期中，针对每个接口单元的接口数据文件生成的文件级校验依据信息 业务指标校验文件 是由源数据提供方提供的一套汇总指标体系，是用于描述源数据方数据的当前状态及相互间逻辑关系，以供数据提供方核对其存储的数据与源数据的一致性。按每日及每月提供 文件级校验报告 指集中化经分系统对接口数据文件做文件级校验后，形成的校验结 5
