eSpace UC服务端集成开发 UC1.1 ISV集成开发培训教材

1 eSpace UC服务端组网介绍 2 eSpace UC服务端开放接口介绍 3 开发环境搭建

eSpace UC服务端开放能力介绍 管理平台(BMU) 企业IT系统 ERP CRM EMail .. 能力开放部件 APP Server Http+XML SOAP 能力开放部件 管理平台(BMU) APP Server BMU 语音 通讯录 IM 短信 鉴权 业务 U19XX Intranet/GRPS/UMTS/Internet/PSTN/PLMN/IMS Terminal 手机客户端 IP Phone PC客户端 客户端插件 （Outlook，Notes，Web）

eSpace UC服务端系统结构 服务端开放的部件：AppServer(应用服务)，BMU（SOAP接口） eSpace客户端 第三方应用 eServer AppServer 手机客户端 eSpace客户端 MAA http+xml U19XX 1 UDP U19XX 2 TCP 第三方应用 CDRServer ftp SOAP 服务端开放的部件：AppServer(应用服务)，BMU（SOAP接口）

1 eSpace UC服务端组网介绍 2 eSpace UC服务端开放接口介绍 3 开发环境搭建

服务端请求接口介绍 序号 接口名称 说明 备注 1 第三方应用鉴权 客户需要针对eSpace UC服务器作集成开发，而此接口用于所有第三方应用接入的鉴权。使用其他接口前，必须请求此接口获取tag后才能使用其他接口 2 用户鉴权 第三方用户鉴权接口，下面备注中需要鉴权的接口，都需要通过此接口鉴权 3 即时消息发送 用于即时消息的发送 需要鉴权 4 短信发送 用于短信的发送 5 WEB页面呈现eSpace状态 在企业网站的通讯录页面上，可以显示eSpace状态，并支持添加联系人、发起即时消息等功能 6 CTD呼叫 用于向某个号码发起CTD（点击拨号）呼叫。通过服务器接口触发U19XX的呼叫业务，分别拉起主叫和被叫，并建立主叫和被叫的媒体通道，最终实现主叫和被叫的语音通话

服务端请求接口介绍 序号 接口名称 说明 备注 7 查询用户好友列表 第三方应用通过账号查询出该账号下所有的好友 需要鉴权 8 查询用户好友分组列表 用于查询某个账号下的所有好友分组 9 查询企业通讯录 用于查询企业通讯录下的部门及员工信息 10 搜索个人信息 用于从企业通讯录条件查询用户信息 11 查询用户状态 第三方应用通过账号查询出该账号当前的状态 12 查询群组列表 用于获取个人群组列表 13 查询群组成员列表 用于获取某个群组下的成员列表

服务端通知接口介绍 服务端集成接口介绍 序号 接口名称 说明 备注 序号 接口名称 说明 备注 1 即时消息回调 用于即时消息的获取 需要鉴权 2 状态回调 好友状态变更，服务器主动推送好友状态 服务端集成接口介绍 序号 接口名称 说明 备注 1 单点登录 UC服务器调用第三方鉴权系统完成用户名和密码的鉴权

服务端SOAP接口介绍 序号 接口名称 说明 备注 1 连续批量SIP放号 用于向U19XX系列网关添加SIP号码 2 批量SIP销号 3 添加账号信息 向UC服务器数据库中添加账号 4 修改账号信息 修改UC服务器数据库中某个账号信息 5 删除账号信息 删除UC服务器数据库中某个账号信息 6 查询账号信息 条件查询UC服务器中的账号

第三方系统 集成短信发送功能 第三方系统 短消息：公文已发，请及时流转 应用服务器 U19XX IAD eSpace 网管 IP Phone eSpace UC系统 调用UC短信能力 某企业客户希望在自身的OA系统中直接调用UC服务端的短消息能力，此时可通过服务端的Webservice接口， 实现OA系统向eSpace手机客户端的短消息发送 。

第三方应用 查询企业通讯录 客户希望在企业OA中输入某个用户姓名，可以查出所有含此信息的员工的详细信息，并且包含该员工的状态。 第三方OA系统或WEB应用通过UC接口查询企业通信录，便于与UC作深入集成 用户已登 构造请求XML消息 发送请求消息，并获取响应消息。 接口地址：http://ip:port /queryEnterpriseAction.do?method=queryEnterprise 客户希望在企业OA中输入某个用户姓名，可以查出所有含此信息的员工的详细信息，并且包含该员工的状态。

第三方应用 查询用户好友列表，分组列表，群组列表等 一般与企业通信录结合使用，集成到第三方OA，ERP等系统中，查阅好友状态 用户已登 构造请求XML消息 发送请求消息，并获取响应消息。 接口地址：http://ip:port / queryGroupAction.do?method=queryGroup 第三方应用通过账号查询出该账号下所有的好友。用户希望在某个账号登录以后，可以看到该账号下所有好友以及好友分组。

第三方应用 发起CTD呼叫 注：CTD的优势：接口形式简单，不需要使用协议栈和媒体库这样复杂的API进行开发调测就可以实现两方通话的业务，易于集成开发和实现。 用户已登 构造请求XML消息 发送请求消息，并获取响应消息。 接口地址：http:// ip:port/ctdAction.do?method=call 用于向某个号码发起CTD（点击拨号）呼叫。通过服务器接口触发U19XX的呼叫业务，分别拉起主叫和被叫，并建立主叫和被叫的媒体通道，最终实现主叫和被叫的语音通话

第三方WEB/OA呈现用户状态 安装UC客户端后，可在WEB网页中通过几句简单的JavaScript脚本调用本地运行的UC客户端的功能，如发起对指定号码的呼叫或即时消息； eSpace服务器部署并调试完成 eSpace服务器存在与企业网站通讯录联系人同名的账户 客户PC机上已正确安装eSpace客户端 客户PC机IE浏览器安全设置允许ActiveX控件加载。 拥有企业网站的版本发布/更新权限

1 eSpace UC服务端组网介绍 2 eSpace UC服务端开放接口介绍 3 开发环境搭建

JDK安装与配置 选择如下版本下载 参考链接：http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u20-oth-JPR 比如我们把JDK安装到D:\Java\jdk1.6.0_20\目录，请记住这个路径，后面配置JDK的时候会用到 在系统变量中新增JAVA_HOME环境变量，变量值为刚才JDK的安装路径 打开“系统属性”窗口，选择“高级”页签，单击“环境变量”

Eclipse安装与配置 访问eclipse官方网站，下载Eclipse IDE for Java Developers. 参考连接： http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/indigo/SR2/eclipse-java-indigo-SR2-win32.zip 下载后的压缩包解压到任何目录直接可以使用，双击eclipse.exe直接打开 启动eclipse后，eclipse会首先询问你设定工程路径，我们可以为我们的ISV开发单独设定一个目录来存放我们开发的集成工程，本文设定为D:\Work\JavaProject\EclipseISV，如果你不希望下次启动再次询问，请勾选此处 打开设置窗口 选择设置“Installed JREs”，单击“Add”