03协同实施工具04oa与k3集成配置

1、OA 集成 K3 配置说明密级：高版本：1.0目录一、集成描述21、集成实现功能22、运行环境2二、数据集成21、代码更新22、配置数据源23、修改 OA 配置文件34、数据同步操作45、注意事项4三、流程转凭证41、OA 流程转凭证功能描述42、OA 流程转凭证配置方法5四、凭证导入111、凭证导入工具设置112、凭证导入操作12五、单点登录141、单点登录实现原理142、单点登录配置说明14一、集成描述1、集成实现功能实现数据同步，从K3 系统中将部门、用户、职位等信息同步到OA 系统；实现 OA 流程转K3 凭证功能；实现单点登录，从OA 登录到 K3HR 系统；2、运行环境K3 系统版

2、本（V10.6 或以上）OA 系统版本（V6.0）数据库（sql server 2000 或 sql server2005）二、HR 数据同步1、代码更新OA5.31 及以上版本不需要更新代码，安装包中已包含集成的代码，如果需要集成的OA系统版本过低，需要手工更新代码和数据库，请与技术支持联系。2、配置数据源因需要将K3 中的组织架构和用户、职位等信息同步到 OA 系统中，需要配置数据源，通过数据源取到 K3 中的相关信息。其配置方法如下：a)在中间件中定义连接K3 数据库的数据源，根据不同的中间件，设置不同：Tomcat 下配置：修改 D:KingdeeOATomcat_5.5confser

3、ver.xml （D:KingdeeOA 为 OA 的安装路径，视具体情况而定）文件，增加一个名称为“jdbc/K3DS”（注意大小写）的数据源，连接到 K3的数据库。增加后的效果如图：Apusic 下配置：修改 D:KingdeeOAapusicsserver1configdatasour.xm（l D:KingdeeOA 为OA 的安装路径）文件，增加一个名称为“jdbc/K3DS”（注意大小写）的数据源，连接到K3 的数据库。b)在 OA 配置文件中调用中间件定义的数据源修改 D:KingdeeOA径，视具体情况而定）文件perties（D:King

4、deeOA 为 OA 的安装路Tomcat 下配置找到 jndi.eas_namejndi参数，将该参数值中的 jdbc/Defaultp/env/jdbc/K3DS改成 jdbc/K3DS 。如： Apusic 下配置找到 jndi.eas_name参数，将该参数值中的 jdbc/Default改成 jdbc/K3DS 。如： jndi.eas_name=jdbc/K3DS3、修改 OA 配置文件修改perties修改 D:KingdeeOAperties 文件，找到 plugins.k3 参数，有两个值 false 和 true，t

5、rue 为集成 K3HR；false 为不集成K3HR。如：plugins.k3=true配置定时同步系统能定时将K3 中的数据自动同步到系统中，同时可以设置定时同步的时间间隔，默认是每 2 小时做一次同步。配置文件 resourcnsoftframepluginsquartzapplicationContext-quartz.xml设置自动同步间隔时间。0 0 10,12,15,18,20,23 *,* * ?用记事本打开 webappWEB-INFframe-servlet.xml，去掉 K3 的注释符。请去掉它外面的注释符即可。如果 OA 版本为 6.0，则上述的修改操作，需要在reso

6、urcontextapplicationContext-controller.xml 文件里进行修改，其具体操作同上。4、数据同步操作完成上述配置后，启动OA 服务，就能将 K3 中的相应数据同步到 OA 系统中了，其同步方式有两种，一种是手动同步，在 OA 系统的系统管理，同步管理中有“K3/HR 部门用户同步”，点击此按钮系统触发同步操作，进行数据同步。实时同步按同时系统还会根据配置的定时同步时间将 K3 中的数据进行定时同步。在安装完OA 后，按上述操作配置好系统后，需要手工做一次数据的同步，之后就可以由系统定时同步来处理 K3 部门、用户等信息的同步了，至此，K3 数据开放的配置就完成

7、了，OA 系统中的组织架构，用户等信息就保持了跟K3 的同步。5、注意事项用户同步在 K3/HR 中，对用户的信息，有用户名和登录名等等，在具体的实施过程中，如果HR 员工数很少，一般起登录名是空的，那么 OA 会将用户同步过来，作为OA 的登陆名（loginid），这里需要注意用户重名。先确认 K3 数据已经导入先确认 K3 系统中已经完成了组织架构、用户、职位等数据的导入工作后，再进行 OA数据集成的配置。三、流程转凭证1、OA 流程转凭证功能描述OA 流程单据（费用报销、借款单、付款凭证）单据数据导入 OA 的数据库K3 转凭证工具将OA 中间表的导入K3 数据库K3 财务生成凭证。转凭

8、证界面数据的说明，如下图所示：红色框中的数据是从 K3 财务系统的数据，而蓝色框的数据则从OA 表单中转过来的数据，由于 OA 的表单是自定表单，因此需要做相应的字段对应配置工作才能将OA 表单的数据转到该界面。K3 财务系统选取的数据OA 表单转过来的数据2、OA 流程转凭证配置方法数据同步配置如果要做转凭证的操作，需要先配置好数据同步，具体操作按本文档中的第一条“数据集成设置”。如果 K3 中有多个帐套，在转凭证的时候，不同的表单可能要转入到对应的帐套中去，需要这是多个 K/3 帐套，其操作在数据库中执行然后，在系统管理系统字典 里设置 K/3 帐套的 字典项(帐套编码|描述)，如“K3C

9、S|财务凭证”。同时确认framewebappWEB-INFframe-servlet.xml 文件中是否被 注释，如果是，请去掉它外面的注释符SET IDENTITY_INSERT system_dicts ONINSERT system_dicts ( id , label , name , options ) VALUES ( 11 , Nk3.denter , NK/3帐套 , N )SET IDENTITY_INSERT system_dicts OFF配置财务数据来来源（在 OA 转凭证时数据取自哪一个 K3 财务数据库）在设计工作流后，先要查看frameresour #kingd

10、ee K3 database voucher#MSSQL,jtds-1.2.jar Driver perties 文件k3.jdbc.driverClaame=net.sourcefe.jtds.jdbc.Driverk3.jdbc.url=jdbc:jtds:sqlserver:/:1433;DatabaseName=K3CWk3.jdbc.username=oadbk3.jdbc.password=osword红色字部分请根据实际 K3 财务数据库设置设置 OA 库中间表（在 OA 转凭证后，数据是存放在中间表中，需要 k/3 凭证导入工具把中间表数据导到

11、 K3 财务数据库，下面会讲到导入操作）请将以下在 OA 数据库中执行执行：报销流程表单转凭证的属性配置（表单配置）配置 OA 应用程序，D:KingdeeOAframedataworkflowconfig目录下的文件 voField_X.xml（X 代表表单的 id，并保留原来的 voField.xml 文件），因为在企业实际应用中， 存在多张表单的数据需要导入 K3 的财务， 所以只要配置好 voField_X.xml 文件，就可以 OA 系统中扩展多张表单转凭证。需要注意的是，voField_X.xml与 OA 的表单是一一对应的，也就说有几张表单需要转凭证，就必须配置几个 voFiel

12、d_X.xml来匹配。voField_X.xml 文件配置：OA 表单中短字段、长字段在 voField_X.xml 文件中的配置。voField_X.xml 文件配置：OA 表单中列表字段在 voField_X.xml 文件中的配置。此处填写 OA 表单中需要导入到 K3 中数据的字段名（短字段或长字段的配置格式）流程转凭证效果示意OA 表单的列表字段的配置格式付款转凭证：费用报销转凭证四、凭证导入1、凭证导入工具设置K3 转凭证工具已经在 K3 服务器上部署完成，由 OA 系统管理员来及设置，一般操作用户不需要了解。登录至 K3 服务器即可看见该工具的界面。用户只需设置自动导入的周期或手动

13、导入，如下图所示。凭证导入工具：需要配置两个数据源，因为需要从OA 的中间表中取得数据，需要配置连接 OA 系统的数据库的数据源。同时需要将 OA 中间表的数据写入的 K3 系统中，需要在导入数据的时候，需要选择对应的帐套，输入登陆用户名和。2、凭证导入操作在上述的配置文档中，有工作方式的配置，“工作方式”是指工具把 OA 中间表中的数据转入财务数据的操作方式，分为两种：1、“手动执行”，每次转凭证时，需要打开此工具手工点“手动导入”来完成凭证的导入。2、“自动执行”，自动执行又分“按月执行”、“按周执行”、“按日执行”、“自定义执行频率”四个方面。“按月执行”是每个月的某一天某一时刻执行一次

14、转入凭证操作；“按周执行”是每周的某一天某一时刻执行一次转入凭证操作；“按日执行”是每天的某一时刻执行一次转入凭证操作；“自定义执行频率”是每阁多少天多少小时多少分执行一次转入凭证操作。配置完参数设置保存配置后，点击“查看数据”，可以更新“已导入数据”和“未导入数据”。如图 5。如果设置的是“手动执行”，那么直接点“手动导入”就可以把当前所有未导入的数据导入凭证，在最下面有信息，可显示导入成功数量和失败数量，成功后即可去财务系统里进行凭证审核。如图。五、单点登录1、单点登录实现原理申请了码，开放了 K3 单点登录功能后，会在功能列表中多一个 K3 单点登录的按扭，点击后会新增一个页面进入 HR

15、 系统，不用再输入用户名和界面，如图。，直接跳转到登录后的需要注意的是，如果要做单点登陆，需要在申请码的时候，勾选上 K3HR 的模块。直接点击进入 HR 系统它的原理是用 HR 的系统管理员帐户，生成一个系统集成用户，其实登录的时候是用系统集成用户来登录系统的，再根据你登录 OA 的用户名，可以对于 HR 登录后的用户，所以前提条件是两个系统的用户必须一致，否则点击后会提示：“用户不存在”。2、单点登录配置说明完成“K3 数据开放设置”的配置。执行下面的数据库INSERT system_modules ( id , label_id , name , path , url , , ,isdi

16、splay , VALUES )(31,1,NK3HR,Nk3hr,N././plugins/k3hr/login_k3hr.jsp?openwrue , N_bl , 300 , 1 , NK3 HR )path , type , icon , url , INSERT system_s ( id , name , )N 登 录 K3HR , , isdisplay , VALUES(900,Nk3hr,N1,Nlink.gif,N././,N_self,3400,1,N登录 K3HR)INSERT system_perms ( id , name , , operation , sus ,

17、 path ,s )VALUES ( 84 , NAUTH_K3HR , NK3HR 登录 , NK3HR 登录 , N1 , Nk3hr ,N900 )需要 oracle 数据库请联系技术支持perties 文件修改修改perties 文件，增加/修改 plugins.k3hr.sso_url，这个参数是 K3HR 单点登录的 URL，格式如下后续说明中详细介绍此 URL 的生成方法；红色部分需要根据实际情况修改。plugins.k3hr.sso_url=r&IDPassword=KQAgACAARgAgALAAgACwAUAAgAF

18、QAIAAjADgAIAAqAFAAIQBEACAAJgBEACAAOAAwACEATgAgACYAQAAgADwAMAAgAEMAIAAnA DwAIAA6ACAAIQBNACAAJgA0ACAKQAwACAAUQAgACMAKAAgACwAUAAgAFQAIAAgAA=&UserName=K3HR 单点登录 URL 生成（参考K3 客户化开发指导手册 v11.0.pdf） A、设置配置文件用文本编辑器打开 SiteFileWebUIWeb.config ， 定位，填写中间层账套管理里的相应账套的账套。设置 HR 账套为 001.01，则该节修改为。 B、设置系统集成账号用管理员账户登录HR 系统，进入用户管理，选择系统集成账户，设置该用户名和。如下图：点击上图的按钮“生成集成”打开页面，然后输入系统集成用户的，点击“生成加密”按钮，如图。C、生成登录字符串生成的单点登录URL格式如下，其中红色部分为需要根据实际情况修改；其中localhost必须是发布的HR