KMPRO知识管理系统接口规范

Version 2.1.1

北京深海域蓝信息科技有限公司
2008年12月
所有权声明
除特别声明外，此文档所用的公司名称、个人姓名及数据均属为说明的目的而模拟。
本文档的版权属北京深海域蓝信息技术有限公司(本公司)所有，受中华人民共和国法律的保护。
本文档所含的任何构思、设计、工艺及其他技术信息均属本公司所有，受中华人民共和国法律的保护。未经本公司书面同意，任何单位和个人不得使用、泄露、告知、公布、发表、出版、传授、转让或者以其他任何方式使第三方知悉。
如有任何问题，请联系：service@kmpro.cn

前言
目的
本文档定义了深蓝海域KMPRO知识管理系统与其他系统之间的接口，目的是为其他系统整合KMPRO知识管理系统和二次开发提供指导规范。
本文档为基本用户接口文档,不是详细API文档.具体的API细节请参阅API DOC.

适用范围
本文档阅读对象：
?????整合知识管理系统的开发人员

?????集成商二次开发的开发人员

参考文档
[1] Bradner, Scott, "RFC 2119 Key words for use in RFCs to Indicate Requirement Levels,"
March 1997, ftp://ftp.isi.edu/in-notes/rfc2119.txt .
SDS/T 2221.2—2004
[2] Bray, Paoli, Sperberg-McQueen, eds., "Extensible Markup Language (XML) 1.0", 2nd
edition, October 2000, W3C Recommendation, http://www.w3.org/TR/2000/REC-xml.
[3] Beech, David, Maloney, Murry, Mendelson, Noah, Thompson, Harry S., “XML Schema Part
1: Structures”, May 2001, W3C Recommendation, http://www.w3c.org/TR/xmlschema-1.
[4]Bray, Hollander, Layman, eds., “Namespaces In XML”, January 1999, W3C Recommendation,
http://www.w3.org/TR/2000/REC-xml-names.
[5]Clark, James, DeRose, Steve, “XML Path Language (XPATH), Version 1.0”, November 1999,
W3C Recommendation, http://www.w3c.org/TR/XPath.
[6] Fielding et. al., "Hypertext Transfer Protocol – HTTP/1.1," IETF RFC 2616, June 1999,
http://www.ietf.org/rfc/rfc2616.txt.
[7]Berners-Lee, T., Fielding, N., and Masinter, L., "Uniform Resource Identifiers (URI):
Generic Syntax", IETF RFC 2396, http://www.ietf.org/rfc/rfc2396.txt.
[11]National Center for Supercomputing Applications, "The Common Gateway Interface,"
http://hoohoo.ncsa.uiuc.edu/cgi/.
[8]Freed, N. and Borenstein N., "Multipurpose Internet Mail Extensions (MIME) Part One:
Format of Internet Message Bodies", IETF RFC 2045, November 1996,
http://www.ietf.org/rfc/rfc2045.txt.
[9]Internet Assigned Numbers Authority,
http://www.isi.edu/in-notes/iana/assignments/media-types/
[10]KMPRO Technology White Paper
[11]KMPRO Requirement Analysis
术语说明
缩写词
CGI 公共网关接口Common Gateway Interface
DCP 分布式计算平台Distributed Computing Platform
DTD 文档类型定义Document Type Definition
HTTP 超文本传输协议Hypertext Transfer Protocol
MIME 多目标Internet 邮件扩展Multipurpose Internet Mail Extensions
URL 统一资源定位符Uniform Resource Locator
XML 可扩展置标语言Extensible Markup Language
SOAP 简单对象访问协议 Simple Object Access Protocol
RPC 远程过程调用 Remote procedure call

接口概要
Kmpro知识管理系统拥有较强的集成功能，开放性的设计使其在UI集成、数据集成、用户集成等多个方面都能够胜任，并有多个系统集成案例。本项目的KM部分与其他核心组成，其主要分工界面涉及层次为——UI层、逻辑层、数据层和硬件部署。以下为常见项目集成分工界面交割：
UI：
1. 按照统一风格要求和界面模板、深蓝海域方负责KM系统的界面实现。
2. KM系统界面风格与主系统风格保持基本一致。
逻辑：
在主系统相关UI位置，设置知识库按钮，坐席应用、管理界面访问知识库按钮，由新的窗口弹出知识库应用。
用户：
用户数据和组织架构统一维护管理，并给出相应接口，KM系统获取用户数据，用户进入KM系统后的权限由KM系统自行定义。

KMPRO提供数据层,服务层,应用层三个层次的接口.以满足不同工业场景的和不同级别的整合需求.
数据层:数据层接口主要提供数据迁移,转换,和合并.一般用于深度整合的场合,由于增加了耦合,一般不推荐.
服务层:服务层提供广泛的服务接口,用于数据交换,信息提取等.
应用层:上层的服务接口提供所得及所见的服务.提供的格式如JOSN,HTML,XML等.
技术说明
Web Service:Web Service主要是为了使原来各孤立的站点之间的信息能够相互通信、共享而提出的一种接口。 Web Service所使用的是Internet上统一、开放的标准，如HTTP、XML、SOAP（简单对象访问协议）、WSDL等，所以Web Service可以在任何支持这些标准的环境（Windows,Linux）中使用。注：SOAP协议（Simple Object Access Protocal,简单对象访问协议）,它是一个用于分散和分布式环境下网络信息交换的基于XML的通讯协议。在此协议下，软件组件或应用程序能够通过标准的HTTP协议进行通讯。它的设计目标就是简单性和扩展性，这有助于大量异构程序和平台之间的互操作性，从而使存在的应用程序能够被广泛的用户访问。
RPC:远程过程调用 (RPC) 是一种协议，程序可使用这种协议向网络中的另一台计算机上的程序请求服务。由于使用 RPC 的程序不必了解支持通信的网络协议的情况，因此 RPC 提高了程序的互操作性。
JDBC:JDBC（Java Data Base Connectivity,java数据库连接）是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问，它由一组用Java语言编写的类和接口组成。JDBC为工具/数据库开发人员提供了一个标准的API，据此可以构建更高级的工具和接口，使数据库开发人员能够用纯 Java API 编写数据库应用程序.