QB-XX-XXX-XXXX
接口说明：
1、资源数据接口：数据量相对较小，周期性单向传送，数据时延要求较低。 2、性能数据接口：数据量相对较大，周期性单向传送，数据时延要求一般。 3、告警数据接口：单条信息数据量较小、总体数据量较大，要求数据实时传送。 4、操作指令接口：网络设备的操作指令通道接口，为上层网管提供下行指令通道，并反馈操作指令返回结果，数据量相对较小，实时性要求较高。 5 通用技术约定 5.1 公共要求 1、 时间同步
OMC北向接口服务器必须采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。接口服务器使用OMC系统的时间同步服务器或公共的时间同步服务器。 2、 编码方式
所有消息和文件的数据编码采用UTF-8（No BOM）编码方式。 3、 数据时间格式
如无特殊说明，时间类字段数据格式均为：“YYYY-MM-DD HH24:mm:ss”。 5.2 FTP通用要求 1、 服务端与客户端
6/ 36
QB-XX-XXX-XXXX
OMC提供可以获取资源、告警和性能数据的FTP server，NMS为 FTP client。OMC系统将数据文件放到FTP server上，NMS自行采集数据文件。 2、 安全性要求
通过授权的用户名、密码信息才能够访问FTP服务器。 3、 目录规则
目录结构：/FTP根目录/省简称/专业简称/厂家编码/OMC名称/数据类别/日期或时间/ 示例：
资源目录：/ftproot/GD/WX/HW/GZ_OMC2/CM/20150611/ 性能目录：/ftproot/GD/WX/HW/GZ_OMC2/PM/2015061101/ 告警目录：/ftproot/GD/WX/HW/GZ_OMC2/FM/20150611/ 1） FTP根目录：OMC厂家自定义的ftp根目录。
2） 省份简称、专业简称、厂家编码、数据类别：参见《OMC北向接口数据规范-公共
数据分册》。
3） 日期或时间：资源、告警数据按天存放，格式为YYYYMMDD；性能数据按小时存
放，格式为YYYYMMDDHH24，小时数为性能数据统计起始时间。 4、 文件命名规则
1) 文件名字符：英文字母全部大写，不允许有中文字符。 2) 文件命名规则：
<数据类别>-<网元类型>[-网元子类]-<主机编号>-<数据版本>-<数据时间>[-登录用户名][-Ri][-统计周期][-序列号].<后缀>
3) 网元类型：资源、性能数据为网元类型，如MME、ENB、PTN、PON等；告警数
据为“OMC”。
4) 网元子类：无线网、核心网的资源、性能数据的网元子类为资源数据、性能数据规
范定义的空间粒度名称，如：EutranCellTDD、InventoryUnitRru、EthernetPort等；告警数据无此项。传输网的资源、性能数据的资源对象类名，填写资源对象简称，如：隧道（TNL）、标签交换（LBS）。资源对象简称参见《OMC北向接口数据规范-XX资源数据分册》或《OMC北向接口数据规范-XX性能数据分册》。IP网数据无
7/ 36
QB-XX-XXX-XXXX
此项，核心网的资源、性能数据该项可选。 5) 主机编号：两位，每1位可用0-9、A-Z编码。
6) 数据版本：遵循接口数据规范规范版本，允许同一目录下存放不同版本的数据文件。 7) 数据时间：采用YYYYMMDDHH24MMSS格式。资源、告警数据为数据文件开始
生成时间，其中资源数据文件开始生成时间指0点或12点；性能数据为统计周期的起始时间。
8) 登录用户名：仅在告警文件同步时使用。用以解决多个NMS同时对同一个OMC发
起告警文件同步请求，生成的同步文件名冲突的问题。
9) Ri：可选。当接口数据文件内容有误（如数据缺失等）时，OMC重新生成文件提供
给NMS进行数据补采，新文件在原文件名后增加”Ri”进行标识，i从1开始，每重新生成一次i加1。
10) 统计周期：两位，取值范围为00-99，仅针对性能数据文件，统计周期的分钟数，
如05、15、60。资源、告警数据文件无此项。
11) 序列号：当文件总量小于100MB(允许上下浮动10%)时，应只形成一个文件；当文
件总量大于100MB(允许上下浮动10%)时要求进行文件分割，即分割后的文件大小（除最后一个）均应介于（90MB,110MB）之间。分割后的文件增加序列号标识，序列号为三位，取值为001-999。在文件切分过程中，不能把资源、性能或告警的一条完整的记录切开放到两个文件中。
12) 后缀：每个文件都进行压缩，统一采用zip或gzip压缩，压缩文件后缀是zip或gz。 13) 文件名样例
资源文件：CM-ENB-EUTRANCELLTDD-A1-V1.1.0-20151227000000-001.xml.zip 性能文件：PM-ENB-EUTRANCELLTDD-01-V1.1.0-20151227000000-15-001.csv.zip 告警文件：FM-OMC-1A-V1.1.0-20150611011603-001.txt.zip
对于设备厂家北向接口上报的私有参数文件，在数据版本前增加ALL字样，其他字段要求保持不变。
样例：
性能文件：PM-ENB-EUTRANCELLTDD-01-ALLV1.1.0-20151227000000-15-001.csv.zip
5、 文件生成过程标识
8/ 36
QB-XX-XXX-XXXX
文件生成过程中，文件名后缀增加“.tmp”标识，该文件全部生成完成后，去掉“.tmp”标识，以确保NMS获取到的北向数据文件是完整的。
对于在数据规范中定义的一个单一接口文件，如果由于文件过大拆分或分布式处理，形成多个文件的，要求在该批次文件全部生成完成后，去掉“.tmp”标识。 6 资源数据接口 6.1 接口协议
接口协议：采用SFTP或者FTP协议。
数据周期：无线网、核心网、传输网和IP网四个专业每12小时生成一次，即每天0点和12点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。智能家庭网关的终端管理平台的资源数据周期为每24小时生成一次，即每天0点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。 6.2 接口数据
接口数据含公共信息和业务数据。业务数据字段参见相关数据规范。公共信息如下：
No 字段名称 英文名称 数据类型 取值或说明 时间 字符串 开始生成数据文件的时间戳。 时区信息，如：北京时间为“UTC+8”。 字符串，取值长度不大于64个字节，不限制字符类型。通过该属性取值应可明确识别厂商名称 如MME、ENB、PTN、PON 资源数据版本 网络资源对象的全网唯一标识，具体定义请见《OMC系统北向接口数据规范-公共数据分册V1.0.0》 无线、核心网专业该字段必选，传输、IP专业无该字段 无线、核心网专业该字段必选，传输、IP专业无该字段 1. 数据生成时间 TimeStamp 2. 时区 生成这个网络资源模型文件3. 的OMC的设备供应商 4. 网元类型 TimeZone VendorName 字符串 ElementType 字符串 字符串 字符串 5. 资源数据版本 CmVersion 6. 网络资源对象的全网唯一标识 7. 网元标识 8. 用户友好名 rmUID Dn UserLabel 字符串 字符串 9/ 36
QB-XX-XXX-XXXX
ObjectType 字符串 9. 网络资源类别名称 该组网络资源模型归属的对象类，具体定义请见《OMC北向接口数据规范-XX资源数据分册》。如：EutranCellTDD、InventoryUnitRru、EthernetPort等。 核心网专业该字段必选。 6.3 数据格式
资源数据文件采用XML格式。
给定一个网元类型，有两种文件组织方式：（1）同一个空间粒度的资源数据在同一数据文件中；（2）对所有的空间粒度，启用一个CM文件存储其资源数据。核心网专业优选文件组织方案（2）。
XML文件格式要求如下。
1、标签说明
标签名称 dataFile fileHeader FiledName Object N V 要求 必须 必须 必须 必须 必须 有条件 说明 数据文件 文件头 网元对象的参数集合 网元 网元对象参数集合中每个参数名称 网元的参数取值，值的个数要与参数的个数相同 2、xml标签属性
10/ 36