1、 KK2011EKP 部署 手册 Landray 蓝凌版权所有 第 1 页 /共 18 页 KK2011 服务器安装 手册 版权说明 未得到深圳蓝凌软件股份有限公司明确的书面许可，不得为任何目的、以任何形式或手段 (电子的或机械的 )复制或传播文档的任何部分。 本文档以及相关的计算机软件程序 (以下简称“文 档” )仅用于为最终用户提供信息，深圳蓝凌软件股份有限公司有权随时更改或撤销其内容。本手册是深圳蓝凌软件股份有限公司的专有信息，并受中华人民共和国版权法和国际公约的保护。 在有关法律允许的范围内，深圳蓝凌软件股份有限公司按“既定”方式提供本文档，且不对本文档提供任何形式的担保，包括 (但不
2、限于 )对特定目的的适销性、适用性以及无侵权行为不作任何暗示担保。在任何情况下，深圳蓝凌软件股份有限公司不对最终用户或任何第三方因使用本文档而引发的任何直接或间接的丢失或损坏负责，包括 (但不限于 )利润损失、业务中断、商誉影响或信 息丢失等，即使已将此类损失或损坏明确告知深圳蓝凌软件股份有限公司。 本文档以及本文档所提及的任何产品的使用均受适用的最终用户许可协议限制。本文档由深圳蓝凌软件股份有限公司制作。 本文档内容若有变动，恕不另行通知。本文档例子中所用公司、人名和数据若非特别声明，均属虚构。 本文档中提及的所有商标、商标名称、服务标志及徽标均归其各自公司所有。 Landray 蓝凌版权所
3、有 第 2 页 /共 18 页 KK2011 服务器安装 手册 目 录 第一章 关于本手册 3 1.1 关于本手册 . 3 1.2 手册结构 . 3 1.3 针对的用户 3 1.4 技术支持 . 3 第二章 EKP 整合指南 . 4 一 EKP 与 KK 配置服务拓扑图 4 二 EKP 与 KK 分功能配置说明 5 1 组织架构及人员同步 . 5 2 EKP 与 KK SSO 集成 . 6 3 EKP 与 KK 门户集成 9 4 迷你新闻配置 12 第三章 常见问题 . 16 1 EKP-D 为什么设置了 SSO， KK 客户端还是无法登录？ 16 2 使用 EKP 用户名和密码为什么无法登录
4、 KK 客户端？ . 16 3 KK 客户端相关的集成门户页面和演示的不一致 . 16 4 在进行组织机构同步时报找不到 WEBSERVICE 的错误问题 . 16 5 关于进行组织机构同步时输入的 WEBSERVICE 的用户名和密码问题 . 16 Landray 蓝凌版权所有 第 3 页 /共 18 页 KK2011 服务器安装 手册 第一章 关于本手册 1.1 关于本手册 本文档是 KK 人智互联平台产品 与 EKP 集成 部署手册 ，主要是为指导用户 更好更快速搭建KK 与 EKP 快速集成部署 而编写的。在文档中，我们将以该产品 安装在简体中文 Windows 2003 Standa
5、rd x64 上为例进行详细的介绍。 希望本文档能够帮助您在短时间内对 KK 人智互联平台有一个概括的了解，让您亲身体验到它所带来的方便与快捷。 1.2 手册结构 本手册针对用户如何使用 KK 客户端进行了详细的介绍，请认真阅读其中的内容。 下表是本手册的详细结构。 章节 描述 第一章关于本手册 介绍本手册的阅读方法。 第二章 EKP 整合指南 引导 您快速 实现 EKP 与 KK 服务器整合 。 第三章 常见问题 了解 EKP 整合过程中常见问题解决方案 1.3 针对的用户 本手册默认用户具备基本的计算机操作技能，熟悉 Windows 操作环境并且已经掌握基本的软件操作方法。 您可以按顺序阅
6、读每一章，或利用目录寻找您需要的主题。下表可以指导您使用本手册： 如果您 请阅读 要学习 安装部署 KK 与 ekp 整合 本手册全部内容 要 整合 EKP 第二 章 EKP 整合 指南 要了解 EKP 部署常见问题 第三章 常见问题 1.4 技术支持 您可以在北京时间周一至周五 9:00 17:30(节假日除外 )拨打热线电话获得技术支持服务。 电 话： (86-755) 2601-2345-8858 电子信箱： 传 真： (86-755) 2671-0099 产品网址： Landray 蓝凌版权所有 第 4 页 /共 18 页 KK2011 服务器安装 手册 第二章 EKP 整合 指南
7、 一 EKP 与 KK 配置服务拓扑图 系统集成支持 1 、 k k s i t e c o n f i g . x m l2 、 f o r w a r d . h t m l3 、 后 台 集 成 门 户 配 置K K 服 务 器与 E K P 的 S S O 集 成1 、 f o r w a r d . h t m l 地 址2 、 E K P 登 录3 、 待 办 待 阅1 、 应 用 功 能2 、 迷 你 页 面配置拓扑图 Landray 蓝凌版权所有 第 5 页 /共 18 页 KK2011 服务器安装 手册 二 EKP 与 KK 分功能配置说明 1 组织架构及人员同步 A 通过
8、LDAP 同步组织架构及人员，具体参看 KK2011 管理员手册 B KK 现在通过 Webservice 来同步 EKP 组织架构及人员 ,进行组织架构同步前，需要做如下准备 : 1)获取 EKP webservice 地址 2）获取具有同步权限的 Webservice 用户名及密码 进入 KK 服务器后台点击“数据导入导出”中“ Webservice 数据同步”打开 webservice同步设置页面 参数说明： 默认域： 需要将 Webservice 数据同步到 KK 服务器的目标域 Webservice 路径： EKP 数据同步 Webservice 路径 PS： 1 EKP 的 Web
9、Service 分 EKP-J 和 EKP-D。不同的 EKP， WebService 的路径不一样。 假设 EKP 地址为 http:/ EKP-J 的 WebServcie 地址： http:/ EKP-D 的 WebService 地址： http:/ 2 ekp-j与 kk的集成，在申请 ekp组件时请记得要申请 webservice组件和 UCStartLandray 蓝凌版权所有 第 6 页 /共 18 页 KK2011 服务器安装 手册 集成（ KK 集成）组件 。要不会产生 在进行组织机构同步时报找不到 webservice 的错误问题 。 Ekp-j 组织机构同步时的用户名和
10、密码并不是 ekp-j 管理员登陆时的用户名和密码。用户名和密码是配置在 ekp-j目录的 users.lst文件中，默认为 admin password。可以自行添加和删减 具体可以看下以下链接的文件 http:/ 访问用户名： 访问 Webservice 并具有同步权限的用户名 访问密码： 该用户的密码 Ps:访问用户名 及密码 推荐使用 EKP 管理员帐号和密码 不参与覆盖的信息： 同步的时候选中项将不覆盖 KK 服务器数据，需要说明：如果勾选了“是否删除不存在记录“则在数据同步的时候将会删除 Webservice 不存在而 KK服务器上存在的部门及人员数据。 新增用户默认密码： 为 K
11、K 同步到 KK 服务器的新用户给予默认密码，如果后续服务器验证方式采用 KK 登录方式，则使用此密码 定时同步设置： 设置同步模式，定时同步为安装定时同步设置时间，到点同步；周期同步，则为按照周期同步设置，每隔设置周期同步一次；不同步，则为数据不从Webservice 同步 定时同步： 设置定时同步时间，该选项 需在“定时同步”设置选择了“定时同步”选项下有效 周期同步： 设置周期同步周期，该选项需在“定时同步”设置中选择了“周期同步”选项下有效 上次同步时间： 本次设置时上次数据同步的时间 手动同步： 手动同步数据，增量同步为同步时只同步 Webservice 新增的数据；完整同步则为完整
12、同步 Webservice 数据 2 ekp 与 KK SSO 集成 1) 配置文件说明 A. 文件 :kksiteconfig.xml 配置 SSO 跳转页面 的地址、 EKP 的登录地址和参数、 EKP 待办待阅获取地址及详细信息配置。该文档的编码为 UTF-8 无签名（无 BOM） 操作方法：需要修改 forward.html 地址、登录地址、待办待阅地址等相关参数 B. 文件 : forward.html 说明： SSO 集成跳转页面。该文档的编码为 UTF-8 操作方法：不需要修改。 2) 配置文件存放位置 打开 KK 服务器安装目录下 serverupdate目录 依据您的 EKP
13、系统将该相关目录下面的文件复制并覆盖到 serverupdate 目录 kksiteconfig.xml 以及 forward.html。另外还需要将 forward.html 依据 EKP 版本不同放置在如下位置： Domino EKP 服务器 : domino/html 目录下 Java EKP 服务器 : index.jsp 同级目录 下 Landray 蓝凌版权所有 第 7 页 /共 18 页 KK2011 服务器安装 手册 3) kksiteconfig.xml 配置详细说明 A. “ sitesys-param” : SSO集成 跳转页面的地址 。最终地址为 url+forward
14、-page。 注意： url 与 EKP 的域名必须保持在同域。 B. “ siteurl-param”：系统内设参数 ,请勿修改。 C. “ siteserviceslogin”： 用于登录 EKP 的相关参数 。 url 表示接收登录信息的地址； fields 表示登录时，需要提交的参数； cookie 表示登录成功后，Cookies 中应包含的 cookie 字段； failure-content 表示登录失败后，返回的网页中包含的文本内容 ,例如： D. “ siteserviceslogout”： 退出 EKP，清理相关 Cookie 信息的地址 ，例如： E. “ siteserv
15、icesuser”：从 EKP 上读取用户信息的地址。该配置仅在 EKP-D中需要配置。若是 EKP-D 环境，保持原默认即可，例如： F. “ siteservicestodo”： 获取待办待阅信息的配置 。请将该配置块中，所有url 的值改成 EKP 的地址，其他保持默认即可，例如： Landray 蓝凌版权所有 第 8 页 /共 18 页 KK2011 服务器安装 手册 4) 修改客户端登录模式 服务器 WEB 页面设置服务器环境设置 环境配置 服务器环境配置 系统设置 ，选择登录方式为“ EKP 登录” Landray 蓝凌版权所有 第 9 页 /共 18 页 KK2011 服务器安装
16、 手册 3 EKP 与 KK 门户集成 集成门户指的是 KK 客户端中，每一个迷你页面或应用。如下图所示： 配置这些迷你页面的方法是：进入 KK 服务器 Web 管理后台 -管理器环境配置 -打开集成门户管理 -新建相关门户页面 -保存。 详细配置如下图： Landray 蓝凌版权所有 第 10 页 /共 18 页 KK2011 服务器安装 手册 新建后界面： 参数说明： 应用名称： 集成应用的名称可以手动输入也可以点击“选择初始化应用”选择确定 EKP应用如下图： 根据上图选择相应的应用即可 应用图标： 该应用在客户端上显示的图标 强制设置： 控制是否允许用户在客户端隐藏该门户，如勾选则不允
17、许用户隐藏 服务器端强制显示后，客户端中就不可以再隐藏该门户。如图（“企业 IM”被置为不可修改）： Landray 蓝凌版权所有 第 11 页 /共 18 页 KK2011 服务器安装 手册 所属模块： 该应用控制显示在客户端的模块 应用类型： 应用页面指基于 KK 系统外的应用页面， KK 应用则为 KK 技术部门开发的产品 URL 地址： 应用类型选择为“应用页面”时出现，此处填写该应用的 URL 地址 ， EKP 相关地址需要咨询 EKP 人员 主页地址： 该应用的主页 URL 地址 ， EKP 应用地址需要咨询 EKP 人员 排序号： 客户端根据此排序号显示应用 应用范围： 能使用该
18、应用的范围，如果选择了部门则只能选择范围内的部门人可用，默认为空则所有人可用 备注： 备注信息 PS: 1 EKP-D 与 KK 集成中，需要以下模块中的新设计元素以支持 KK 展示，其中默认 85 以上有该设计元素，如果是低版本或者定制版本，可以申请最新相对应的模块来更新该版本中的设计元素，主要涉及以下几个模块： A. 待办事宜 模块 ,相对应元素： FM_KKTaskList 路径为： server/path/sys/lks_tasks.nsf/FM_KKTaskList B. 信息发布模块，相对应元素： PG_TopPage 路径为： server/path/sys/lks_news.n
19、sf/PG_TopPage C. 知识中心模块，相对应元素： PG_TopPage 路径为： server/path/koa/lks_filemng.nsf /PG_TopPage D. 规范制度模块，相对应元素： PG_TopPage 路径为： server/path/koa/lks_rules.nsf /PG_TopPage E. 流程管理模块，相对应元素： PG_TopPage 路径为： server/path/koa/lks_review.nsf /PG_TopPage Landray 蓝凌版权所有 第 12 页 /共 18 页 KK2011 服务器安装 手册 2 EKP-J 与 KK
20、 的集成中，还需要申请对应的 ekp-java 模块 代办事宜 （消息机制，属于核心 core） sys/notify 工作流程（流程管理） km/review 新闻系统（新闻管理） sys/news 企业知识（知识中心） km/doc 公司论坛（论坛管理） km/forum 规范制度（规范制度） km/institution 常用资料（常用资料） km/comminfo 4 迷你新闻配置 此处设置 KK 客户端登录之后弹出的迷你新闻页面内容 参数说明： 启用迷你新闻： 是否启用 KK 客户端在用户登录后弹出的迷你新闻页面 迷你新网网址： 地址可以自己指定，严格按照指定大小设计 ，您 也可以选
21、择 默认迷你新闻网址，只需要修改此处迷你页面的网址就可以了 默认 迷你新闻页面的修改 1 打开服务器安装目录 KKServer sp1serverWebServerMinipotal 下 index.html 进行相关页面配置保存就可以了 PS： KKServer sp1serverWebServerMinipotal 下文件及文件夹说明 Landray 蓝凌版权所有 第 13 页 /共 18 页 KK2011 服务器安装 手册 2 index.html 页面相关说明，此页面主要是配置迷你新闻页面的显示内容 。 打开 index.html 找到 此处配置的是默认迷你首页中页面的名称， 修改此处
22、则迷你新闻页面的名称也相应修改， 如下图 新闻 推荐 公文 热评 论坛 案例 爱问 Landray 蓝凌版权所有 第 14 页 /共 18 页 KK2011 服务器安装 手册 然后找到 Landray 蓝凌版权所有 第 15 页 /共 18 页 KK2011 服务器安装 手册 其中每一个 div 中 id 依据序号对应的迷你页面的 TAB 内容， 其中 SRC 为该应用下面的 EKP 地址，也即是迷你新闻页面显示内容的 URL 地址，大小为宽440px，高 368px，不建议修改大小，该地址一般根据 EKP 部署情况修改需域名为 EKP 部署域名即可，详细配置需要咨询 EKP 相关实施人员 L
23、andray 蓝凌版权所有 第 16 页 /共 18 页 KK2011 服务器安装 手册 第三章 常见问题 1 EKP-D 为什么设置了 SSO， KK 客户端还是无法登录？ 您设置 EKP SSO 时， EKP-D 需要使用域名，否则 KK 客户端无法登录服务器 2 使用 EKP 用户名和密码为什么无法登录 KK 客户端？ 请您确定以下操作： A. 是否已经通过 webservice 同步了 EKP 组织架构以及密码 B. 是否已经在服务器 WEB 页面设置服务器环境设置 环境配置 服务器环境配置 系统设置，选择登录方式为“ EKP 登录” C. 是否将 KK 客户端网络设置中的服务器地址设
24、置正确的 KK 服务器地址 D. 是否将服务器 WEB 页面设置服务器环境设置 环境配置 服务器环境配置 系统设置，“登录地址”填写为 KK 服务器地址 E. 该用户帐号的登录方式是否为 EKP 方式以及系统默认登录方式 3 KK 客户端相关的集成门户页面和演示的不一致 KK 客户端的集成门户地址是由 KK 服务器后台配置的，请确认您门户集成中填写的 EKP 应用的 URL 地址是否正确，详细地址您需 要咨询 EKP 产品部相关人员 4 在进行组织机构同步时报找不到 webservice 的错误问题 出现这种情况的原因大多是因为没有申请 UCStart 集成（ KK 集成）组件，如果要做集成请
25、务必在申请 java 组件时勾选上这个组件 5 关于 进行组织机构同步时输入的 webservice 的用户名和密码问题 很多项目实施人员误以为调用 webservice 的用户名和密码就是 ekp-j 登陆时的用户名和密码，其实不然。这里的 webservice 采用 axis 实现，调用 webservice 的用户名密码是保存在一个叫 users.lst 的文件中，此文件在项目 WEB-INF 下，格式如下： 其中 admin、 password 分别就是 ekp-j 提供的默认用户名和密码，即是说输入 webserviceLandray 蓝凌版权所有 第 17 页 /共 18 页 KK2011 服务器安装 手册 后同时输入用户名 admin、密码 password 后就能就进行组织机构的同步了。如果想更改或新增用户名和密码只需要按对应的格式进行修改，例如： 这 里 一 并 附 上 组 织 机 构 同 步 的 webservice 地 址 ：http:/localhost:8080/ekp/axis/UcStarOrgSynchroService?wsdl 注：红色部分使用实际的 ekp 访问地址进行替换（ 如果 tomcat 服务器是本地安装的，不要写 localhost，这里要填写 ip 或域名 ）
