《金蝶协同办公软件V6.0二次开发指南》由会员分享，可在线阅读，更多相关《金蝶协同办公软件V6.0二次开发指南（26页珍藏版）》请在金锄头文库上搜索。
1、金蝶协同办公软件V6.0二次开发指南金蝶协同办公软件二次开发指导手册V1.0金蝶软件（中国）有限公司2010.6目 录1前言32二次开发32.1单点登录32.1.1其它系统单点登录金蝶协同32.1.2金蝶协同单点登录其它系统92.2业务功能调整92.2.1添加一个新的功能模块92.2.2添加菜单102.2.3修改页面信息112.3数据交换/接口数开发122.3.1手机短信接口开发122.3.2档案接口开发142.3.3通知消息交换162.3.4异构系统数据同步192.3.5办结公文数据与其它异构系统的数据交换201 前言金蝶协同软件提供了稳定、标准的运行环境，但为了实现客户更加个性化的需求和保
2、持金蝶协同架构的开放性，还为客户化开发提供了二次开发编程机制：通过金蝶协同业务封装组件进行二次开发从而实现个性化的需求和跟其它异构系统集成从保持金蝶协同架构的开放性。对金蝶协同运行平台进行有效的扩充和扩展。需要注意的是：1.当前版本的金蝶协同软件支持的二次开发，仅适用于金蝶协同软件V6.0以上版本；2.当前版本的金蝶协同软件支持的二次开发J2EE 架构，采用的二次开发方式推荐Spring2.0版本，hibernate3.1版本；在本手册中，我们所有关于金蝶协同二次开发的定义、描述、示例等，都符合上述2点特征。2 二次开发2.1 单点登录单点登录SSO（Single Sign-On）是身份管理中
3、的一部分。SSO的一种较为通俗的定义是：SSO是指访问同一服务器不同应用中的受保护资源的同一用户，只需要登录一次，即通过一个应用中的安全验证后，再访问其他应用中的受保护资源时，不再需要重新登录验证。金蝶协同跟其异构系统集成比较多，主要有金蝶K3系统、金蝶HR系统、金蝶EAS、金蝶PLM系统。如果有新的系统需要二次开发有二种类型1，其它系统登陆单点登录金蝶协同 2，金蝶协同单点登录到其它系统。以下分二种类型详细说明。2.1.1 其它系统单点登录金蝶协同金蝶协同基于kingdee-ltpa是kingdee提供的基于cookie的轻量级的认证方式，如果需要实现SSO的环境为提供中间件，那么使用kin
4、gdee-ltpa将是最佳的方式。场景描述：当用户发出一个URL请求到金蝶协同支持kingdee-ltpa的应用，系统要求输入“用户/密码”，输入并提交后用户就可以访问这个金蝶协同的应用，接着当用户再访问金蝶协同应用，此时无需再次输入“用户/密码”信息即可以访问金蝶协同的相关功能。过程说明：首先需要在两个系统服务器上配置基于LTPA的信任关系，经过配置后的服务器之间建立了信任，当其中一个服务器认证通过后，再去访问其它已经建立过信任关系的服务器时，因为它们之间彼此是信任的，所以就无需再次认证了。1. 其它系统发出一个URL请求到金蝶协同，此请求被单点拦截，单点登录定向到它内置的一个form表单，
5、加入用户/密码进行认证；2. 金蝶协同单点登录认证组件拿着输入的用户/密码到LDAP server进行用户鉴别。金蝶协同单点登录认证组件认证成功后生成一个LTPA的Token，并将请求转发到金蝶协同端，金蝶协同收到请求后，发现此请求含有LTPA的Token，因为之前已经配置了信任关系，所以金蝶协同单点登录认证组件不再要求进行认证，直接将请求的响应返回，用户收到所需的页面信息响应。3.用户再次访问金蝶协同的Web应用，此请求被金蝶协同单点登录认证组件拦截，因为金蝶协同单点登录认证组件之前缓存了LTPA的Token，它快速检查了请求信息是来自它所信任的金蝶协同单点登录认证组件，所以不需要再进行用户
6、信息的鉴别，它把请求直接转给金蝶协同，因为是信任的，所以也不需要再次认证，金蝶协同将直接返回的请求结果。开发过程分为三个步骤1.增加单点登录入口按钮 2.实现单点登录请求 3.实现单点登录验证1. 增加单点登录入口按钮在应用相应页面增加一个按钮访问金蝶协同软件 login/login.jsp2. 实现单点登录请求新建JSP ，例如在webapp/login目录下新建JSP文件，命名为kingdee_sso_auth.jsp, 里面实现业务有以下四步1) 通过请求参数及金蝶协同配置信息，得到其它系统中用户信息，取出相关信息（为一下步验证这个是否合法相关数据）示例核心代码提示 2) 通过用户use
7、rName、用户密码，通过相关业务逻辑验证其信息是否合法。如果不合法，做相关业务异常处理。示例核心代码提示3) 将请求信息通过相关加密方式，然后通过LtpaToken组件相关处理组成DSESSIONID字符串。示例核心代码提示:4) 提交单点登录请求示例核心代码提示：详细例子请参考文件Webapp/login/kingdee_sso_auth.jspResources/conf/ LtpaToken.properties3. 实现单点登录验证新建JSP ，例如在webapp/login目录下新建JSP文件，命名为kingdee_sso_login.jsp, 里面实现业务有以下四步1) 清除se
8、ssion中单点登录相关信息（loginUser EAS_MESSAGEID EAS_nexturl EAS_nexturl）示例核心代码提示 2) 判断是否有效请求。如果判断是无效请求作相关业务异常处理 示例核心代码提示3) 设置访问金蝶协同URL信息示例核心代码提示4) 提交金蝶协同安全验证示例核心代码提示 详细例子请参考文件Webapp/login/kingdee_sso_login.jspResources/conf/ LtpaToken.properties2.1.2 金蝶协同单点登录其它系统其步骤跟其它系统单点登录金蝶协同基本上一样。只过实现单点登录的方式有很大区别，如果金蝶协同单
9、点登录其它系统如果有自己单点登录解决方案，那只能按照他们提供单点登录资源实现二次开发，如果没有单点登录解决方案。就采用其它系统单点登录金蝶协同办法解决，另外请求角色跟验证角色调换一下，所以这里不作详细说明。2.2 业务功能调整业务功能调整主要有：1.新增功能 2 修改功能。新增功能只支持把开发完成功能以菜单形式显示在金蝶协同软件，所以添加模块、添加菜单。 修改功能只能修改页面上文件文字、图片等一些信息。2.2.1 添加一个新的功能模块添加模块:目前版本只支持在首页头部区域增加入口（按钮、超链接）以弹出方式显示添加的模块，加模块功能开发框架不作限制。开发步骤主要有 1.打开文件 2.增加入口1、
10、打开文件：打开webappthemesmskin目录下header_top.jsp2、增加入口header_top.jsp的效果如下增加入口代码,示例如下a class=link_top href= target=”_top” 新增模块2.2.2 添加菜单添加菜单：目前通过在各个菜单扩展页面增加菜单链接来实现各个模块中加菜单功能。开发步骤主要有：1打开文件 2增加菜单链接.1. 打开文件打开webappthemesmskin目录，根据下面列表打开对应文件。 各个模块对应菜单扩展页面如下列表文件对应模块menu_address.jsp通讯录menu_archive2.jsp档案管理menu_bo
11、oks.jsp图书管理menu_bulletin.jsp通知公告menu_calendar2.jsp我的日历menu_docex.jsp协同工作menu_email2.jsp电子邮件menu_fileman.jsp文档管理menu_forum.jsp公司论坛menu_knowledge.jsp知识中心menu_linktree.jsp业务链接menu_meeting.jsp会议管理menu_news.jsp新闻中心menu_plan.jsp计划总结menu_supply.jsp办公用品menu_workflow.jsp协同审批menu_worklog.jsp工作日志2.增加菜单链接在文件底部增
12、加代码 增加菜单名称 注意，增加链接是增加菜单必须以弹出窗口方式显示2.2.3 修改页面信息目前用户修改登录页面和首页顶部内容需求比较频繁。功能中一些页面用户很难找到具体页面文件，所以不提供具体功能页面修改。所以此次二次开发只提供登录页面和首页顶部修改1.登录页面登录页面修改步骤主要有三步：1打开文件2修改内容 打开文件： 打开webappthemesmskinloginlogin.jsp 修改内容：包括文字、图片、样式、布局。 文字： 找到你要修改文字如果没有做国际化，直接在页面上修改文字。 如果做了国际化，打开misci18ncommon.properties文件
13、。找到对应要修改文字国际化标签名字，例如“loginjsp_label4=登陆方式”说明登录方式国际化标签名字是“loginjsp_label4” 打开misci18nextend.properties文件，增加loginjsp_label4=修改后名字，打开misci18nextend_zh_HK.properties 增加loginjsp_label4=修改後名字(这个文件是繁体国际化文件，里面标签值是繁体的)用native2ascii编译 extend.properties extend_zh_HK.properties把编译后文件替换web-inf/classes/i18n/对应文件。 图片： 替换图片，将修改的图片覆盖webappthemesmskinloginimage
