中国电信移动办公产品（EMA）－EMA接口规范 v1.00.01

中国电信移动办公产品 EMA 接口规范 版本号： V1.0 中国电信集团公司 中国电信广州研究院 2008 年 7 月 中 国电信移动办公产品 EMA接口 规范 V1.00.01 - i - 目 录 1 前言 . 1 1.1 编制说明 . 1 1.2 适用范围 . 1 1.3 编写依据 . 1 1.4 缩略语及术语 . 1 1.4.1 缩略语 . 1 1.4.2 术语 . 2 2 EMA 接口 . 3 2.1 接口概述 . 3 2.2 E1：终端应用接口 . 4 2.3 E2： EMA 管理接口 . 4 2.3.1 SNMP 接口 . 4 2.3.2 SOAP 接口 . 31 2.3.3 FTP 接口 . 38 2.3.4 升级维护 . 43 2.4 E3：通信能力接口 . 44 2.5 E4：企业邮件接口 . 44 2.6 E5：应用适配接口 . 45 2.6.1 数据库接口 . 45 2.6.2 WebService 接口 . 54 2.7 E6：业务支撑系统接口 . 81 2.7.1 业务订购信息同 步 . 82 2.7.2 企业客户名单信息同步 . 88 中 国电信移动办公产品 EMA 接口规范 V1.00.01 1 1 前言 1.1 编制说明 本规范 描述中国电信移动办公产品的业务描述、业务特征、业务流程、业务的运营管理及安全机制。 1.2 适用范围 本规范适用于中国电信移动办公产品的设备开发、 招标选 型 、工程建设、运营 维护 。 本规范 适用于 CDMA1x/3G 网络环境。 1.3 编写依据 下列标准所包含的条文 通过 在 本标准引用而 构 成本标准的条 文 。 在标准出版时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨，使用下列标准最新版本的可能性。 1.4 缩略语及术语 1.4.1 缩略语 缩写 英文解释 中文解释 3G 3rd Generator 第三代移动通信 AP Application Provider 应用提供商 SMS Short Message Service 短消息业务 SMSG Short Message Service Gateway 短消息业务网关 SMSC Short Message Service Center 短消息中心 MMS Multimedia Message Service 多媒体消息业务 ISAG Integrated Service Access Gateway 综合业务接入网关 ISMP Integrated Service Management 综合业务管理平台 中 国电信移动办公产品 EMA 接口规范 V1.00.01 2 Platform EC Enterprise Customer 企业 客户 CRM Customer Relationship Management 客户关系管理 SCM Supply Chain Management 供应链管理 OA Office Automation 办公自动化 SI Service Integrator 业务集成商 1.4.2 术语 移动办公业务：传统办公自动化系统（ OA）和其它办公业务与应用，在无线设备上的扩展应用，其中移动 OA、移动 CRM、移动 ERP 等只是移动办公业务中一个具体的应用实例。 移动办公系统（ Moblie Office System）：提供中国电信移动办公业务端到端解决方案的完整系统，包含企业侧、网络侧、以及终端侧所有功能实体。 EMA（ Enterprise Mobile Agent）：移动信息化应用的一种部署模式，设备部署在企业侧、企业独享使用自己专有的移动信息化应用。 EMA 系统：基于 EMA 模式的移动办公系统，包括 EMA 服务器、 EMA 服务平台以及移动办公客户端。 EMA 服务器（ Enterprise Mobile Agent Server）：以 EMA 模式提供基本移动通信应用以及应用集成基础平台的设备。 MOA(Mobile Office Automation)： MOA 是运行在 EMA 服务器上的一种业务，它提供了短信、彩信、 wap 和手机客户端的通信能力。 EMOA： 以 EMA 模式提 供移动办公业务的设备。 EMA 服务平台：部署在电信网络侧，提供统一的运营支撑门户，实现 EMA服务器的业务管理、运行监控与维护等功能。 NMA（ Network Mobile Agent）：移动信息化应用的一种集中部署模式，设备部署在网络侧、企业租赁使用移动信息化应用。 NMOA：以 NMA 模式提供移动办公业务的系统。 移动办公产品：向用户最终交付的移动办公业务称为移动办公产品。 产品形态：指用户可感知、使用的移动办公产品的业务表现形式，在业务支 中 国电信移动办公产品 EMA 接口规范 V1.00.01 3 撑系统中，每种产品形态有唯一对应的产品标识。 2 EMA 接口 2.1 接口概述 图 1 EMA 系统接口图 E1 接口 ：终端应用接口，是 EMA 服务器与 移动 终端的接口，采用基于TCP 或 UDP 的自定义应用协议 。本期 EMA 系统对该接口不做具体要求，但下期需遵循中国电信相关接口规范。 E2 接口： EMA 管理接口，是 EMA 服务平台 与 EMA 服务器接口，采用SNMP、 SOAP、 FTP 协议 E3 接口：通讯能力接口，是 EMA 服务器与 业务引擎 接口，采用 ParlayX协议 E4 接口 ：企业邮件接口，是 EMA 服务器与企 业邮箱 的 接口，采用 SMTP、POP3、 IMAP4 等协议 E5 接口 ：应用适配接口，是 EMA 服务器与企业 OA 等 自有业务的 接口，采用 DB 或 WebService 或自定义接口 中 国电信移动办公产品 EMA 接口规范 V1.00.01 4 E6 接口：业务支撑系统接口，是 EMA 服务平台 与 业务支撑系统的接口，采用 FTP 协议 2.2 E1：终端应用接口 该接口实现 EMA 服务器与手机客户端软件之间的通信。 该接口通过 TCP 或 UDP 协议实现。 本期 EMA 系统对该接口不做具体要求，但下期需遵循中国电信相关接口规范。 2.3 E2： EMA 管理接口 EMA 服务平台 通过 本 接口对 EMA 服务器进行设备监控 、 远程配置 、 接入管理 、日志管理 等 功能。根据接口 协议 的不同，包括 SNMP 接口、 SOAP 接口和FTP 接口。 2.3.1 SNMP 接口 SNMP 即简单网管协议， SNMP 支持的消息类型通常有以下 5 种： Get-Request、Get-Next- Request、 Set-Request、 Set- Response、 Trap。 SNMP 须支持 V2C（参见 RFC 1901-1908）。 EMA 服务平台通过 SNMP 接口对 EMA 服务器进行远程监控、升级维护和统一配置等功能。 配置管理 配置信息的查询 接口应支持查询系统配置信息、软件配置信息、硬件配置信 息，以及各类可提供的业务配置等信息。 配置信息的修改 接口应支持对可配置的信息进行修改。 配置信息改变通知 某些配置信息的变化会引发配置改变通知，接口应支持将配置改变通知上报到 EMA 服务平台 。 中 国电信移动办公产品 EMA 接口规范 V1.00.01 5 性能管理 性能数据的采集 EMA 服务器 实时 更新 MIB 数据，支持 EMA 服务平台发送的性能数据采集要求 。 性能参数门限管理 接口应支持性能参数的门限管理，包括 ： 设置性能参数门限值。 EMA服务器 支持设置某一个监视实体或多个监视实体的性能参数门限值； 查询 /修改性能参数门限值。 EMA服务器 支持通过查询某一个监视实体或多个 监视实体性能参数门限值的当前设置情况，并能对性能参数门限值进行修改； 删除性能参数门限值。 EMA服务器 支持删除某一个监视实体或多个监视实体性能参数门限值。 逾门限事件处理 当性能数据超出了性能门限值的范围时， EMA 服务器 应向 EMA 服务平台以 trap 的形式 发送告警 信息 。 故障管理 通用告警管理 通用告警是指 EMA 服务器可以发送的关于运行状态和链路状态的告警。 EMA 服务平台可以接收来自被管 EMA 服务器的各种告警， EMA 服务器应支持通用告警类型。 通用告警 /通知 类型有 ： 中文名称 英文名称 说明 可选性 备注 系统冷启动 coldStart 当代理检测到系统冷启动时，向管理站发送 coldStart 告警。 M 引自 RFC 1215 系统热启动 warmStart 当代理检测到系统热启动时，向管理站发送 warmStart 告警。 M 引自 RFC 1215 中 国电信移动办公产品 EMA 接口规范 V1.00.01 6 连接中断 linkDown 当代理检测到某条链路的ifOperStatus 将要从其它状态（除notPresent 外）进入 down 状态，将会触发链路中断 Trap， 其状态由 ifOperStatus 表示。 O 引自 RFC 1215 连接建立 Linkup 当代理检测 到某条链路的ifOperStatus 将要从 down 状态进入其他状态（除 notPresent 外），将会触发链路建立 Trap， 其状态由 ifOperStatus 表示。 O 引自 RFC 1215 认证失败 authenticationFailure 当代理检测到认证失败事件发生时，向管理站发送。 M 引自 RFC 1215 特定告警管理 EMA 管理 接口除了支持 通用 告警 /通知的上报外， 根据设备的具体 特点，提供某 些特定告警，特定告警的详见 本部分的 PDU 定义部分 。 安全管理 对于 EMA 服务器的 安全 入侵行为，要能够生成 告 警，并上报给 EMA 服务平台 。 EMA 服务平台 可强制 注销 在线的 EMA 服务器。 升级维护 EMA 服务器 提供升级维护接口，以支持 EMA 服务平台 通过该接口以安全有效的方式对设备进行操作和维护，如 EMA 服务器 的关闭、重启、升级等 操作 。 PDU 定义 .1 配置管理数据 请求消息 ： EMA 服务平台 -EMA 服务器 中 国电信移动办公产品 EMA 接口规范 V1.00.01 7 应答消息 ： EMA 服务平台 -EMA 服务器 .1.1 EMA 主机系统配置参数 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 系统描述 sysDescr 系统的描述 信息 DisplayString (SIZE (0.255) M read-only 引自 RFC 3418 系统标识 sysObjectID 实体的网络管理子系统的厂商授权标识 OBJECT IDENTIFIER O read-only 引自 RFC 3418 管理员联系地址 sysContact 系统管理员的联系地址 DisplayString (SIZE (0.255) M read-write 引自 RFC 3418 系统名 sysName 系统 名称 DisplayString (SIZE (0.255) M read-write 引自 RFC 3418 系统提供的服务 sysServices 系统 提供的服务集合 INTEGER (0.127) M read-only 引自 RFC 3418 系统位置 sysLocation 系统 的物理位置 DisplayString (SIZE (0.255) M read-write 引自 RFC 3418 EMA 服务器编码 EMAID 中国电信统一分配 EMA 服务器的设备 编码 字符串 M read-only 中 国 电 信 统一分配的EMA 服务器帐号（编码） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 8 设备命名 deviceName EMA 服务器 的名称，如主机名 字符串 M read-only 主 机 设 备 的名称，如主机名 设备厂商 deviceVendorName 设备制造商 字符串 M read-only 设备制造商 MAC 地址 deviceMacCode 网卡的 MAC编码 字符串 M read-only 特指 EMA 服务器与 EMA服 务 平 台 有物 理 连 接 的网 络 接 口 的MAC IP 地址 deviceIpAddress 网卡的 IP 地址 IpAddress M read-only 特指 EMA 服务器与 EMA服务 平 台 有物 理 连 接 的网 络 接 口 的IP .1.2 EMA 主机硬件配置参数 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 CPU 主频 cpuWorkFreq EMA 服务器 的CPU 主频 整型 M read-only 单位 ： MHz CPU 总数 cpuNumber EMA 服务器 的CPU 总个数 整型 M read-only EMA 服务器的 CPU 总个数 内存容量 memMaxContent EMA 服务器 的内存容量 整型 M read-only 单位 ： MByte 中 国电信移动办公产品 EMA 接口规范 V1.00.01 9 硬盘容量 diskMaxContent EMA 服务器 的磁盘容量 整型 M read-only 单位 ： MByte .1.3 EMA 主机软件配置信息 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 操作系统名称 OsName 操作系统类型或名称 字符串 M read-only 操作系统类型或名称 操作系统版本 OsVersion 操作系统的版本号 字符串 M read-only 操作系统的版本号 操作系统开发厂商 OsVendor 操作系统的开发厂商 字符串 M read-only 操作系统的开发厂商 应用软件名称 AppSWName 应用软件的名称 字符串 O read-only EMA 服务器软件的名称 应用软件版本 ApSWVersion 应用软件的版本号 字符串 O read-only EMA 服务器软件的版本号 应用软件开发商 AppSWVendor 应用软件的开发商 字符串 O read-only EMA 服务器软件的开发商 数据库软件的类型 dbSWName 数据库软件的类型或名称 字符串 O read-only 数据库软件的类型或名称 数据库软件的版本 dbSWVersion 数据库软件的版本号 字符串 O read-only 数据库软件的版本号 数据库软件的开发 商 dbSWVendor 数据库软件的开发商的名称 字符串 O read-only 数据库软件的开发商的名称 中 国电信移动办公产品 EMA 接口规范 V1.00.01 10 .1.4 EMA 主机业务配置信息 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 ERP业务开通标志 ERP flag 是否开通 ERP 业务应用 布尔 M read-only 是否开通 ERP业务应用 （保留字段） OA 业务开通标志 OA flag 是否开通 OA 业务应用 布尔 M read-only 是否开通 OA业务应用 SCM 业务开通标志 SCM flag 是否开通 SCM 业务应用 布尔 M read-only 是否开通SCM 业务应用 （保留字段） CRM 业务开通标志 CRM flag 是否开通 CRM业务应用 布尔 M read-only 是否开通CRM 业务应用 （保留字段） Mail 业务开通标志 Mail flag 是否开通 Mail 业务应用 布尔 M read-only 是否开通 Mail业务应用 （保留字段） 行业业务开通标志 Industry flag 是否开通行业业务应用 布尔 M read-only 是否开通行业业务应用 （保留字段） 其他业务开通标志 Other flag 是否开通其他类业务应用 布尔 M read-only 是否开通其他类业务应用（保留字段） 短信能力开通标志 SMS flag 是否开通短信通讯能力 布尔 M read-only 是否开通短信通讯能力 中 国电信移动办公产品 EMA 接口规范 V1.00.01 11 彩信能力开通标志 MMS flag 是否开通彩信通讯能力 布尔 M read-only 是否开通彩信通讯能力 USSD 能力开通标志 USSD flag 是否开通 USSD通讯能力 布尔 M read-only 是否开通USSD 通讯能力 （保留字段） WAP 能力开通标志 WAP flag 是否开通 WAP 通讯能力 布尔 M read-only 是否开通WAP 通讯能力 LBS能力开通标志 LBS flag 是否开通 LBS 通讯能力 布尔 M read-only 是否开通 LBS通讯能力 （保留字段） PUSHMAIL 能力开通标志 PUSHMAIL flag 是否开通PUSHMAIL 通讯能力 布尔 M read-only 是否开通PUSHMAIL 通讯能力 （保留字段） EMA 短信接入号SPcode appSMSPCode EMA 短信接入号spcode 字符串（ 32 字节） 若SMS flag 1，则必选 read-only EMA 短信 接入号 spcode EMA 短信接入SPid appSMSPID EMA 短信接入spid 字符串 同上 read-write EMA 短信接入 spid ISAG 短信模块IP ApplicationSMGWIP ISAG 短信模块IP 字符串 同上 read-write ISAG 短信模块 IP 中 国电信移动办公产品 EMA 接口规范 V1.00.01 12 ISAG 短信模块端口 AppSMGWPort ISAG 短信模块端口 字符串 同上 read-write ISAG 短信模块端口 EMA 彩信接入企业代码vaspID appMMvaspID EMA 彩信接入 企业代码 vaspID 字符串（ 32 字节） 若MMS flag 1，则必选 read-only EMA 彩信接入企 业 代 码vaspID EMA 彩信接入号 vasID appMMvasID EMA 彩信接入 号vasID 字符串 同上 read-write EMA 彩信接入 号 vasID EMA 彩信登录帐号Username appMMUsername EMA 彩信登录帐号 Username 字符串 同上 read-write EMA 彩信登录帐号Username ISAG 彩信模块IP ApplicationMMGWIP ISAG 彩信 模块IP 字符串 同上 read-write ISAG 彩信模块 IP. ISAG 彩信模块URL ApplicationMMGWURL ISAG 彩信模块URL 字符串 同上 read-write ISAG 彩信模块 URL。 URL 格式： http:/host:port/path 中 国电信移动办公产品 EMA 接口规范 V1.00.01 13 ISAG USSD 模块 IP ApplicationUSSDGWIP ISAG USSD 模块IP 字符串 若USSD flag 1，则必选 read-write ISAG USSD模块 IP（保留字段） ISAG WAP 模块 IP ApplicationWAPGWIP ISAG WAP 模块IP 字符串 若WAP flag 1，则必选 read-write ISAG WAP 模块 IP. ISAG WAP 模块 URL ApplicationWAPGWURL ISAG WAP 模块URL 字符串 若WAP flag 1，则必选 read-write ISAG WAP 模块 URL。 URL 格式： http:/host:port/path EMA 登录网关用户名 appSMGWLoginUser EMA 网关用户 名 字符串 M read-write EMA 网关用户名 EMA 登录网关密码 appSMGWPasswd EMA 网关密码 字符串 M read-write EMA 网关密码 中 国电信移动办公产品 EMA 接口规范 V1.00.01 14 EMA 各个模块运行状态 appSystemProcessState EMA 各个模块的运行状态，格式 ：模块名 ： 状态，模块名 ： 状态 字符串 M read-only 状态： 0： 运行正常 1： 业务接口断连 2： 业务故障 3： 数据库断连 4： 业务暂停 9：其他 模块名称： 通讯能力 业务能力 （保留字段） EMA 的当前短信下发速度限制设 置 appSMSendSpeedLimit EMA 的当前短信下发速度限制设置 字符串 O read-write EMA 的当前短信下发速度限制设置 （单位：条 /秒） EMA 的当前彩信下发速度限制设置 appMMSendSpeedLimit EMA 的当前彩信下发速度限制设置 字符串 O read-write EMA 的当前彩信下发速度限制设置 （单位：条 /秒） EMA 的当前WAP 限制用户数 appWAPUserLimit EMA 的当前WAP 限制用户数 字符串 O read-write EMA 的当前WAP 限制用户数 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 15 EMA 的当前USSD 限制用户数 appUSSDUserLimit EMA 的当前USSD 限制用户数 字符串 O read-write EMA 的当前USSD 限制用户数 （保留字段） EMA 的当前Email 限制用户数 appEMAILUserLimit EMA 的当前Email 限制用户数 字符串 O read-write EMA 的当前Email 限制用户数 （保留字段） .2 性能管理数据 请求消息 ： EMA 服务 平台 -EMA 服务器 应答消息： EMA 服务平 台 -EMA 服务器 .2.1 EMA 服务器 性能 数据 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 CPU 占用率 cpuLoad 物理设备的 CPU利用率 浮点型，精度为小数点后两位 M read-only 物理设备的CPU 利用率 内存占用率 phyMemUsage 物理设备的内存占用率 浮点型，精度为小数点后两位 M read-only 物理设备的内存占用率 中 国电信移动办公产品 EMA 接口规范 V1.00.01 16 磁盘占用率 diskUsed 物理设备的磁盘空间占用率 浮点型，精度为小数点后两位 M read-only 物理设备的磁盘空间占用率 从启动到现在的运行时间 sysUpTime 物理设备从启动到当前运行的时间 TimeTicks O read-only 引自 RFC 1213 .2.2 EMA 主机业务性能数据 中文名称 英文名称 说明 取值说明 可选性 操作 类型 备注 ERP 系统当前上行短信数目 ErpMoSmCount ERP 系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP 系统当前下行短信数目 ErpMtSmCount ERP 系统当前下行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP 系统当前上 行彩信数目 ErpMoMmCount ERP 系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP 系统当前下行彩信数目 ErpMoMMCount ERP 系统当前下行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 17 ERP系统当前WAP 用户数 ErpWapOnlineUserCount ERP 系统当前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP系统当前USSD 用户数 ErpUssdOnlineUserCount ERP 系统当前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP 系统当前WAPPUSH 成功数 ErpwapPushCount ERP 系统当前WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP系统当前GPRS 流量 ErpGRPSCount ERP 系统当前GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP系统当前 下行短信总 数 ErpMtSmCountAll ERP 系统当前 下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP系统当前 下行 彩 信总 数 ErpMoMMCountAll ERP 系统当前 下行 彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） ERP系统当前WAPPUSH 总数 ErpwapPushCountAll ERP 系统当前WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 18 CRM 系统当前上行短信数目 CrmMoSmCount CRM 系统当 前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前下行短信数目 CrmMtSmCount CRM 系统当前下行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前上行彩信数目 CrmMoMmCount CRM 系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前下行彩信数目 CrmMoMMCount CRM 系统当前下行彩信数目 整型 O read-only 可配 置采集粒度，最小 1 小时 （保留字段） CRM 系统当前WAP 用户数 CrmWapOnlineUserCount CRM 系统当前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前USSD 用户数 CrmUssdOnlineUserCount CRM 系统当前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前WAPPUSH 成功数 CrmwapPushCount CRM 系统当前WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 19 CRM 系统当前GPRS 流量 CrmGRPSCount CRM 系统当前GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前 下行短信 总 数 CrmMtSmCountAll CRM 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） CRM 系统当前 下行彩 信 总 数 CrmMoMMCountAll CRM 系统当前下行 彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （ 保留字段） CRM 系统当前WAPPUSH 总数 CrmwapPushCountAll CRM 系统当前WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） OA 系统当前上行短信数目 OaMoSmCount OA 系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 OA 系统当前下行短信成功 数目 OaMtSmCount OA 系统当前下行短信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 OA 系统当前上行彩信数目 OaMoMmCount OA 系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 中 国电信移动办公产品 EMA 接口规范 V1.00.01 20 OA 系统当前下行彩信成功 数目 OaMoMMCount OA 系统当前下行彩信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 OA 系统当前WAP 用户数 OaWapOnlineUserCount OA 系 统 当 前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 OA 系统当前USSD 用户数 OaUssdOnlineUserCount OA 系 统 当 前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） OA 系统当前WAPPUSH 成功数 OawapPushCount OA 系统当前WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） OA 系统当前GPRS 流量 OaGRPSCount OA 系统当前GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） OA 系统当前 下行短信 总 数 OaMtSmCountAll OA 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （ 保留字段） OA 系统当前 下行彩 信 总 数 OaMoMMCountAll OA 系统当前下行彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 21 OA 系统当前WAPPUSH 总数 OawapPushCountAll OA 系统当前WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前上行短信数目 ScmMoSmCount SCM 系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前下行 短信 成功数目 ScmMtSmCount SCM 系统当前下行短信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前上行彩信数目 ScmMoMmCount SCM 系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前下行彩信 成功数目 ScmMoMMCount SCM 系统当前下行彩信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前WAP 用户数 ScmWapOnlineUserCount SCM 系统当前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 22 SCM 系统当前USSD 用户数 ScmUssdOnlineUserCount SCM 系统当前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前WAPPUSH 成功数 ScmwapPushCount SCM 系 统 当 前WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前GPRS 流量 ScmGRPSCount SCM 系 统 当 前GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前 下行短信 总 数 ScmMtSmCountAll SCM 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前 下行彩 信 总 数 ScmMoMMCountAll SCM 系统当前下行 彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） SCM 系统当前WAPPUSH 总数 ScmwapPushCountAll SCM 系 统 当 前WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL系统当前上行短信数目 EmailMoSmCount EMAIL 系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 23 EMAIL系统当前下行短信 成功 数目 EmailMtSmCount EMAIL 系统当前下行短信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL系统当前上行彩信数目 EmailMoMmCount EMAIL 系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL系统当前下行彩信 成功 数目 EmailMoMMCount EMAIL 系统当前下行彩信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL系统当前 WAP用户数 EmailWapOnlineUserCount EMAIL 系统当前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL系统当前 USSD用户数 EmailUssdOnlineUserCount EMAIL 系统当前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL 系统 当 前WAPPUSH 成功数 EmailwapPushCount EMAIL 系统当前WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 24 EMAIL 系统 当 前GPRS 流量 EmailGRPSCount EMAIL 系统当前GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL 系统当前 下行短信 总数 EmailMtSmCountAll EMAIL 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL 系统当前 下行 彩 信 总数 EmailMoMMCountAll EMAIL 系统当前下行 彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） EMAIL 系统 当 前WAPPUSH 总数 EmailwapPushCountAll EMAIL 系统当前WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业 应用系统当前上行短信数目 IndustryMoSmCount 企业应用系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前下行短信成功 数目 IndustryMtSmCount 企业应用系统当前下行短信 成功数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 25 企业应用系统当前上行彩信数目 IndustryMoMmCount 企业应用系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业 应用系统当前下行彩信成功 数目 IndustryMoMMCount 企业应用系统当前下行彩信 成功数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前WAP 用户数 IndustryWapOnlineUserCount 企业应用系统当前 WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前USSD 用户数 IndustryUssdOnlineUserCount 企业应用系统当前 USSD 用户数 整型 O read-only 可配 置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前WAPPUSH 成功数 IndustrywapPushCount 企业应用 系统当前 WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前GPRS 流量 IndustryGRPSCount 企业应用 系统当前 GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 26 企业应用系统当前下行短信 总 数 IndustryMtSmCountAll 企业应用 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前下行 彩 信总 数 IndustryMoMMCountAll 企业应用 系统当前下行 彩 信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 企业应用系统当前WAPPUSH 总数 IndustrywapPushCountAll 企业应用 系统当前 WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统当前上行短信数目 OtherMoSmCount 其它系统当前上行短信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统当前下行短信 成功数目 OtherMtSmCount 其它系统当前下行短信 成功 数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统当前上行彩信数目 OtherMoMmCount 其它系统当前上行彩信数目 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 27 其它系统当前下行彩信 成功数目 OtherMoMMCount 其它系统当前下行彩信 成功 数目 整型 O read-only 可配置采集 粒度，最小 1 小时 （保留字段） 其它系统当前WAP 用户数 OtherWapOnlineUserCount 其它系统当前WAP 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统当前USSD 用户数 OtherUssdOnlineUserCount 其它系统当前USSD 用户数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统 系统当前WAPPUSH 成功数 OtherwapPushCount 其它系统 系统当前 WAPPUSH 成功数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统 系统当前GPRS 流量 OtherGRPSCount 其它系统 系统当前 GPRS 流量 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 其它系统 系统当前下行短信总 数 OtherMtSmCountAll 其它系统 系统当前下行短信 总 数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） 中 国电信移动办公产品 EMA 接口规范 V1.00.01 28 其它系统 系统当前下行 彩 信总 数 OtherMoMMCountAll 其它系统 系统当前下行 彩 信 总 数 整型 O read-only 可 配置采集粒度，最小 1 小时 （保留字段） 其它系统 系统当前WAPPUSH 总数 OtherwapPushCountAll 其它系统 系统当前 WAPPUSH 总数 整型 O read-only 可配置采集粒度，最小 1 小时 （保留字段） .3 故障管理数据 TRAP 消息 ： EMA 服务平台 -EMA 服务器 中文名称 英文名称 说明 数据类型 可选性 操作类型 备注 告警的序列号 alarmId 告警的序列号 字符串 M read-only 告警的序列号 网元的识别名 Dn 网元的识别名 字符串 M read-only 网元的识别名 告警原始级别 orgSeverity 告警级别，设备上报告警消息中的告警级别。 字符串 M read-only 分为严重告警、主要告警、次要告警、警告告警和不确定告警五种级别。 中 国电信移动办公产品 EMA 接口规范 V1.00.01 29 告警原始类型 orgType 告警类型，设备上报告警消息中的告警类型。 字符串 M read-only 分为通信告警、环境告警、设备告警、处理错误告警、业务告警、服务质量告警等。 告警原因 probableCause 告警原因 整数 M read-only 告警原因 告警发生时间 eventTime 告警发生 时间 字符串 M read-only 告警发生时间 ，格式：YYYYMMDDHHMISS 告警确认时间 ackTime 告警确认时间 字符串 M read-only 仅在告警已确认时，该项不为空。 格式：YYYYMMDDHHMISS 告警清除时间 clearTime 告警清除时间 字符串 M read-only 仅在告警已清除时，该项不为空。 格式： YYYYMMDDHHMISS 中 国电信移动办公产品 EMA 接口规范 V1.00.01 30 告警活跃状态 activeStatus 活动状态，表示告警是否被清除还是处于活跃状态 0, 1 整数 M read-only 活动状态，表示告警是否被清除还是处于活跃状态 0, 1 0：清除 1：活跃 告警标题 alarmTitle 告警标题 字符串 M read-only 告警标题 告警内容 alarmText 告警内容 字符串 M read-only 告警内容中必需告警精确定位信息，能够通过单条告警具体明确定位到发生故障的链路。 .4 升级维护数据 请求消息 ： EMA 服 务平台 -EMA 服务器 应答消息： EMA 服务 平台 -EMA 服务器 中文名称 英文名称 说明 数据类型 可选性 操作类型 备注 关机控制标志 turnOffFlag 远程关机控制标志位 整数 0, 1 O read-write 远程关机控制标志位 0:缺省值，正常 1:关机 中 国电信移动办公产品 EMA 接口规范 V1.00.01 31 重新启动控制标志 resetFlag 远程重新启动控制标志 整数 0, 1 O read-write 远程重新启动控制标志 0:缺省值，正常 1:重启 版本升级通知标志 upgradeFlag 版本升级通知标志 整数 0, 1 O read-write 版本升级通知标志位 ， 通知EMA 服务器升级（仅通知，不负责具体升级），由 EMA服务器 提示管理员进行下载升级 。 0:缺省值，正常 1:通知升级 EMA 服务平台FTP信息 ftpInfo EMA 服务平台FTP 信息，包括url， 用户名，密码 字符串 O read-write EMA 服务平台 FTP 信息，包括 url， 用户名，密码 。 URL 格式 : ftp:/ 用户名 :密码host:port/path. 2.3.2 SOAP 接口 SOAP 即基 于 HTTP 承载的简单对象访问协议。 接口应支 持 SOAP 协议以提供必要的注册、登录、认证、鉴权、登录密码修 中 国电信移动办公产品 EMA 接口规范 V1.00.01 32 改等功能。 注册功能 企业客户 首先去 CRM 申 请开户，包括开通账户和订购 EMA 业务（比如 OA短信 、 CRM 短信）。在第一次使用 EMA 服务器之前，需要用分配的 EMAID、用户名、密码等信息到 EMA 服务平台注册。 EMA 服务器在向 EMA 服务平台注册时，还需要附带上 EMA 服务器的硬件信息（ MAC 地址）。当 EMA 服务平台记录下这些信息之后，返回注册成功的通知。 EMA 服务平台将记录 EMA 服务器及其相应硬件配置等信息用于后续的鉴权流程。 认证 鉴权 功能 EMA 服务器在 EMA 服务平台 完成注册之后，每次系统启动，都需要将 用户名、 密码以及 MAC 地址 送 EMA 服务平台 进行登录认证。 EMA 服务平台在确认登录信息和注册信息一致之 后，启动鉴权流程。 在设备运行过程中，需要周期性的到 EMA 服务平台进行鉴权。只有通过鉴权的 EMA 服务器才能够正常使用业务 ，能够使用哪些业务由 EMA 服务平台 通知EMA 服务器。 密码修改功能 EMA服务器 的 企业管理员可以通过 EMA服务器 提供 的 Portal在本地发起密码修改， EMA 服务器在确认新密码之后，向 EMA 服务平台 发起密码修改同步，并根据 EMA 服务平台 返回的修改结果反馈给企业管理员。 该功能通过 SOAP 通信接口实现。 .1 密码修改请求 序号 父元素名称 元素名称 约束 类型 宽度 描述 1 EMAManagermentInterface Version 1 String 1.0 中 国电信移动办公产品 EMA 接口规范 V1.00.01 33 2 EMAManagermentInterface MsgType 1 String PwdModifyReq 3 EMAManagermentInterface SequenceID 1 String 序列号，从00000001 到99999999 4 EMAManagermentInterface TimeStamp 1 String 时间戳，yyyymmddHHmmss 5 EMAManagermentInterface EMAID 1 String EMA 的 ID 6 EMAManagermentInterface UniMngrID 1 String 保留字段，暂时可以先不填这个字段 7 EMAManagermentInterface OldPassword 1 String 原 密码 8 EMAManagermentInterface NewPassword 1 String 新 密码 9 EMAManagermentInterface Macaddress 1 String EMA 服务 器MAC 地址信息 中 国电信移动办公产品 EMA 接口规范 V1.00.01 34 .2 密码修改响应 序号 父元素名称 元素名称 约束 类型 宽度 描述 1 EMAManagermentInterface Version 1 String 1.0 2 EMAManagermentInterface MsgType 1 String PwdModifyRsp 3 EMAManagermentInterface SequenceID 1 String 序列号，从00000001到99999999 4 EMAManagermentInterface TimeStamp 1 String 时间戳，yyyymmddHHmmss 5 EMAManagermentInterface EMAID 1 String EMA 的 ID 6 EMAManagermentInterface UniMngrID 1 String EMA 服务平台的 ID 7 EMAManagermentInterface ModifyResult 1 String 1:修改成功 , 0:修改失败 8 EMAManagermentInterface FailReason ？ String 失败原因描述 注： EMA 服务器与 EMA 服务平台在注册、认证鉴权中使用密码信息；如服务器接入平台采集 VPN 方式且共用一个密码，该变更是否对 VPN 接入生效需要商讨； 中 国电信移动办公产品 EMA 接口规范 V1.00.01 35 PDU 定义 .1 注册 EMA 服务器向 EMA 服务平台 注册 ： 序号 父元素名称 元素名称 约束 类型 宽度 描述 1 EMAManagermentInterface Version 1 String 1.0 2 EMAManagermentInterface MsgType 1 String RegsiterReq 3 EMAManagermentInterface SequenceID 1 String 序列号，从00000001 到99999999 4 EMAManagermentInterface TimeStamp 1 String 时间戳，yyyymmddHHmmss 5 EMAManagermentInterface EMAID 1 String EMA 的 ID 6 EMAManagermentInterface UniMngrID 1 String 保留字段，暂时可以先不填这个字段 8 EMAManagermentInterface Password 1 String 密码 9 EMAManagermentInterface Mac Address 1 String EMA 服务器上与 EMA 服务平台连接的网卡的MAC 地址 注册应答： 中 国电信移动办公产品 EMA 接口规范 V1.00.01 3