a8接口和增值开发手册.docVIP

A8 平台接口和增值开发手册 2006 UF Seeyon Co., Ltd. All rights reserved. This document contains information that is proprietary and confidential to UF Seeyon., which shall not be disclosed outside the recipients company or duplicated, used or disclosed in whole or in part by the recipient for any purpose other than to evaluate this file. Any other use or disclosure in whole or in part of this information without the express written permission of UF Seeyon. is prohibited. Date: 2009-01-04 Author: 王文友 Version: V1.0 修改记录 3 1. 概述 4 1.1 编写目的 4 1.2 开发背景 4 1.3 应用价值 4 1.4 接口范围 5 2. 二次开发接口 6 2.1 接口一览 6 2.2 服务列表 6 3. Portal 集成 7 3.1 单点登录 (SSO) 7 3.1.1 外部平台集成 A8 . 7 实现说明 7 接口说明 8 代码示例 8 部署说明 9 3.1.2 A8 集成第三方系统 9 实现方式一： Ticket 9 实现方式二：关联系统 +扩展栏目 1 1 3.2 Portlet 13 3.2.1 概述 1 3 3.2.2 开发说明 1 3 确定栏目数据 1 3 确定栏目显示模板 1 3 开发说明 1 4 注册到系统 1 4 3.2.3 代码示例 1 5 3.2.4 待办事项和跟踪事项 2 2 3.2.5 新闻和公告 2 2 4. 消息集成 22 4.1 消息通道 22 4.1.1 概述 2 2 4.1.2 接口说明 2 2 方法说明 2 2 注册到系统 2 3 原理说明 2 3 4.1.3 代码示例 2 3 4.2 短信接口 24 4.2.1 概述 2 4 4.2.2 接口说明 2 4 注册到系统 2 7 原理说明 2 7 4.2.3 代码示例 2 8 5. 组织模型同步 30 5.1 初始化同步 30 5.1.1 导出 3 0 5.1.2 导入 3 0 2 / 39 5.2 实时同步 30 5.2.1 实现 A8 组织模型事件监听接口 3 0 5.2.2 注册事件监听 3 7 6. BPM 集成 37 6.1 准备 . 37 6.2 外部系统发起 A8 表单流程 38 6.3 轮询完成的表单流程 38 6.4 导出 A8 表单流程到外部系统 38 7. 附录 39 7.1 术语表 39 修改记录 日期 修改人 修改内容 备注 2008-12-08 王文友 创建文档，编写文档模板。 2008-12-15 王文友 增加了安装服务文档。 2008-12-23 王文友 增加了文档导出接口例程。 2008-12-29 王文友 合并刘娜组织模型文档， 加入例程； 合并于荒津 BPM 文档。 2009-01-04 王文友 合并张勇 Portal 和消息文档， 拆分 API 文档。 2009-06-16 张勇 增加单点登录不打开页面方式说明 和待办事项接口说明 2009-9-27 王文友 增加组织模型同步和 BPM 集成 3/ 39 . 概述 1.1 编写目的 本手册主要面向二次开发人员，内容涵盖 A8 平台的二次开发、第三方应用集成。如果需要更详细的开发信息，请参考《平台 API 参考手册》。 1.2 开发背景 接口的目标是 1 、 与第三方应用集成，达成松散耦合，紧密集成的目标； 2 、 与异构应用集成； 3 、 降低二次开发的技术难度； 4 、 规范化二次开发，提升二次开发的稳定性； 5 、 保证二次开发的延续性，降低二次开发应用升级难度。 1.3 应用价值 目前平台开放的接口支持： 1 、 组织模型同步 使用组织模型导入接口，实现外部系统到 A8 的组织模型初始化同步； 调用组织模型管理远程接口，在外部系统组织模型发生变化时实时同步到 A8 。 实现组织模型事件接口，将 A8 组织模型变更实时同步到外部系统。 2 、 表单流程集成 外部系统通过 BPM 集成远