2022年2022年金蝶k开发集成文档 .pdf

《2022年2022年金蝶k开发集成文档 .pdf》由会员分享，可在线阅读，更多相关《2022年2022年金蝶k开发集成文档 .pdf（19页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、OA 集成 K3 配置说明目录一、集成描述.21、集成实现功能.22、运行环境.2二、数据集成.21、代码更新.22、配置数据源.23、修改 OA 配置文件.44、数据同步操作.55、注意事项.5三、流程转凭证.61、OA 流程转凭证功能描述.62、OA 流程转凭证配置方法.7四、凭证导入.131、凭证导入工具设置.132、凭证导入操作.14五、单点登录.161、单点登录实现原理.162、单点登录配置说明.16名师资料总结-精品资料欢迎下载-名师精心整理-第 1 页，共 19 页 -一、集成描述1、集成实现功能实现数据同步，从K3 系统中将部门、用户、职位等信息同步到OA 系统；实现 OA 流

2、程转 K3 凭证功能；实现单点登录，从OA 登录到 K3HR 系统；2、运行环境K3 系统版本（V10.6 或以上）OA 系统版本（V6.0）数据库（sql server 2000 或 sql server2005）二、HR 数据同步1、代码更新OA5.31 及以上版本不需要更新代码，安装包中已包含集成的代码，如果需要集成的OA系统版本过低，需要手工更新代码和数据库，请与技术支持联系。2、配置数据源因需要将 K3 中的组织架构和用户、职位等信息同步到OA 系统中，需要配置数据源，通过数据源取到K3 中的相关信息。其配置方法如下：a)在中间件中 定义 连接 K3 数据库的数据源，根据不同的中间件

3、，设置不同：Tomcat 下配置：修改 D:KingdeeOATomcat_5.5confserver.xml（D:KingdeeOA为 OA 的安装路径，视具体情况而定）文件，增加一个名称为“jdbc/K3DS”（注意大小写）的数据源，连接到K3的数据库。名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页，共 19 页 -增加后的效果如图：Apusic 下配置：修改 D:KingdeeOAapusicdomainsserver1configdatasources.xml（D:KingdeeOA为OA 的安装路径）文件，增加一个名称为“jdbc/K3DS”（注意大小写）的数据源，连接到K

4、3 的数据库。b)在 OA 配置文件中调用中间件定义的数据源修改 D:KingdeeOAfirstframeresourcesjdbc.properties（D:KingdeeOA为 OA 的安装路径，视具体情况而定）文件Tomcat 下配置找 到jndi.eas_name 参 数，将 该 参 数 值 中 的jdbc/Default改 成jdbc/K3DS。如：jndi.eas_name=java:comp/env/jdbc/K3DS Apusic 下配置找 到jndi.eas_name 参 数，将 该 参 数 值 中 的jdbc/Default改 成jdbc/K3DS。如：jndi.eas_

5、name=jdbc/K3DS名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页，共 19 页 -3、修改 OA 配置文件修改 firstframe.properties修改 D:KingdeeOAfirstframeresourcesfirstframe.properties文件，找到plugins.k3参数，有两个值 false 和 true，true 为集成 K3HR；false 为不集成K3HR。如：plugins.k3=true配置定时同步（可默认不修改）系统后台能定时将K3 中的数据自动同步到系统中，同时可以设置定时同步的时间间隔，默认是每2 小时做一次同步。配置文件resou

6、rcescnfirstsoftfirstframepluginsquartzapplicationContext-quartz.xml设置自动同步间隔时间。名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页，共 19 页 -0 0 10,12,15,18,20,23*,*?4、数据同步操作完成上述配置后，启动OA 服务，就能将K3 中的相应数据同步到OA 系统中了，其同步方式有两种，一种是手动同步，在OA 系统的系统管理，同步管理中有“K3/HR 部门用户同步”，点击此按钮系统触发同步操作，进行数据同步。同时系统还会根据配置的定时同步时间将K3 中的数据进行定时同步。在安装完 OA 后，

7、按上述操作配置好系统后，需要手工做一次数据的同步，之后就可以由系统定时同步来处理K3 部门、用户等信息的同步了，至此，K3 数据开放的配置就完成了，OA 系统中的组织架构，用户等信息就保持了跟K3 的同步。5、注意事项用户同步在 K3/HR 中，对用户的信息记录，有用户名和登录名等等，在具体的实施过程中，如果HR 员工平台数很少，一般起登录名是空的，那么OA 会将用户姓名同步过来，作为OA 的登陆名（loginid），这里需要注意用户重名的问题。先确认 K3 数据已经导入实 时 同 步 按名师资料总结-精品资料欢迎下载-名师精心整理-第 5 页，共 19 页 -先确认K3 系统中已经完成了组织

8、架构、用户、职位等数据的导入工作后，再进行OA数据集成的配置。三、流程转凭证1、OA 流程转凭证功能描述OA 流程单据（费用报销、借款单、付款凭证）单据数据导入OA 的数据库 K3 转凭证工具将OA 中间表的记录导入K3 数据库 K3 财务生成凭证。转凭证界面数据的说明，如下图所示：红色框中的数据是从K3 财务系统读取的数据，而蓝色框的数据则从OA 表单中转过来的数据，由于 OA 的表单是自定表单，因此需要做相应的字段对应配置工作才能将OA 表单的数据转到该界面。K3 财务系统选取的数据OA 表单转过来的数据名师资料总结-精品资料欢迎下载-名师精心整理-第 6 页，共 19 页 -2、OA 流

9、程转凭证配置方法数据同步配置如果要做转凭证的操作，需要先配置好数据同步，具体操作按本文档中的第一条“数据集成设置”。如果 K3 中有多个帐套，在转凭证的时候，不同的表单可能要转入到对应的帐套中去，需要这是多个K/3 帐套，其操作在数据库中执行SET IDENTITY_INSERT system_dicts ON INSERT system_dicts(id,label,name,options)VALUES(11,Nk3.datacenter,NK/3帐套 ,N )SET IDENTITY_INSERT system_dicts OFF然后，在系统管理系统字典里设置K/3 帐套的字典项(帐套编

10、码|描述)，如“K3CS|财务凭证”。同时确认firstframewebappWEB-INFfirstframe-servlet.xml（5.33 及以前版本）、firstframeresourcescontextapplicationContext-controller.xml（6.0 及以后版本）文件中是否被注释，如果是，请去掉它外面的注释符 配置财务数据来来源（在OA 转凭证时数据取自哪一个K3 财务数据库）在设计工作流后，先要查看firstframeresources jdbc.properties文件#kingdee K3 database voucher#MSSQL,jtds-1.

11、2.jar Driver k3.jdbc.driverClassName=net.sourceforge.jtds.jdbc.Driver k3.jdbc.url=jdbc:jtds:sqlserver:/127.0.0.1:1433;DatabaseName=K3CWk3.jdbc.username=oadbk3.jdbc.password=oapassword红色字部分请根据实际K3 财务数据库设置设置 OA 库中间表（在OA 转凭证后，数据是存放在中间表中，需要k/3 凭证导入工具把中间表数据导到K3 财务数据库，下面会讲到导入操作）请将以下脚本在OA 数据库中执行名师资料总结-精品资料

12、欢迎下载-名师精心整理-第 7 页，共 19 页 -执行脚本：K3 转凭证创建中间表.txt流程中 K3 转凭证节点的设置（流程配置）在设计工作流后，先要查看firstframedataworkflowconfig stepinfo.xml文件 001 K3转凭证 /oa/modules/workflow/k3Integration.do?method=getK3VoucherInfo 100,100,1000,450 转凭证 info 在设计转凭证结点时，结点的以格式为：*例如 转凭证，中括号的内容是可以改变，但结点名称内容必须跟stepinfo.xm 名称相同。属性：主要显示特殊工作点结点

13、按钮显示名称.可以修改的.属性：主要调整弹出窗口的大小的。在流程设计里设置如下图：报销流程表单转凭证的属性配置（表单配置）配置 OA 应用程序，D:KingdeeOAfirstframedataworkflowconfig 目录下的文件voField_X.xml（X 代表表单的id，并保留原来的voField.xml 文件），因为在 企 业 实 际 应用 中，存 在 多张 表 单 的 数据 需 要 导 入 K3的财 务，所 以 只 要 配 置 好voField_X.xml文件，就可以 OA 系统中扩展多张表单转凭证。需要注意的是，voField_X.xml与 OA 的表单是一一对应的，也就说有

14、几张表单需要转凭证，就必须配置几个voField_X.xml名师资料总结-精品资料欢迎下载-名师精心整理-第 8 页，共 19 页 -来匹配。voField_X.xml文件配置：OA 表单中短字段、长字段在voField_X.xml文件中的配置。voField_X.xml文件配置：OA 表单中列表字段在voField_X.xml文件中的配置。流程转凭证效果示意此处填写OA 表单中需要导入到K3 中数据的字段名（短字段或长字段的配置格式）OA 表单的列表字段的配置格式名师资料总结-精品资料欢迎下载-名师精心整理-第 9 页，共 19 页 -付款转凭证：名师资料总结-精品资料欢迎下载-名师精心整理

15、-第 10 页，共 19 页 -名师资料总结-精品资料欢迎下载-名师精心整理-第 11 页，共 19 页 -费用报销转凭证名师资料总结-精品资料欢迎下载-名师精心整理-第 12 页，共 19 页 -四、凭证导入1、凭证导入工具设置K3 转凭证工具已经在K3 服务器上部署完成，由OA 系统管理员来维护及设置，一般操作用户不需要了解。登录至K3 服务器即可看见该工具的界面。用户只需设置自动导入的周期或手动导入，如下图所示。凭证导入工具下载：名师资料总结-精品资料欢迎下载-名师精心整理-第 13 页，共 19 页 -需要配置两个数据源，因为需要从OA 的中间表中取得数据，需要配置连接OA 系统的数据

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

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

18、，点击后会新增一个页面进入HR 系统，不用再输入用户名和密码，直接跳转到登录后的界面，如图。需要注意的是，如果要做单点登陆，需要在申请注册码的时候，勾选上K3HR 的模块。它的原理是用HR 的系统管理员帐户，生成一个系统集成用户，其实登录的时候是用系统集成用户来登录系统的，再根据你登录OA 的用户名，可以对于HR 登录后的用户，所以前提条件是两个系统的用户必须一致，否则点击后会提示：“用户不存在”。2、单点登录配置说明完成“K3 数据开放设置”的配置。执行下面的数据库脚本直 接 点 击 进入 HR 系统名师资料总结-精品资料欢迎下载-名师精心整理-第 16 页，共 19 页 -set IDEN

19、TITY_INSERT system_modules on INSERT system_modules(id,label_id,name,path,url,target,pos,isdisplay,descn)VALUES(32,1,NK3HR,Nk3hr,N././plugins/k3hr/login_k3hr.jsp?openwin=true,N_blank,300,1,NK3 HR)set IDENTITY_INSERT system_modules off set IDENTITY_INSERT system_menus on INSERT system_menus(id,name,p

20、ath,type,icon,url,target,pos,isdisplay,descn)VALUES(900,N 登录K3HR,Nk3hr,N1,Nlink.gif,N././,N_self,3400,1,N 登录 K3HR)set IDENTITY_INSERT system_menus off set IDENTITY_INSERT system_perms on INSERT system_perms(id,name,descn,operation,status,path,menus)VALUES(25,NAUTH_K3HR,NK3HR登录 ,NK3HR 登录 ,N1,Nk3hr,N9

21、00)set IDENTITY_INSERT system_perms off 需要 oracle 数据库脚本请联系技术支持修改 firstframe.properties 文件修改 firstframeresourcesfirstframe.properties 文件，增加/修改 plugins.k3hr.sso_url，这个参数是K3HR 单点登录的URL，格式如下后续说明中详细介绍此URL 的生成方法；红色部分需要根据实际情况修改。plugins.k3hr.sso_url=http:/localhost/KDHRMS/LoginStraight.aspx?IDUserName=HROpe

22、nUser&IDPassword=KQAgACAARgAgACIALAAgACwAUAAgAFQAIAAjADgAIAAqAFAAIQBEACAAJgBEACAAOAAwACEATgAgACYAQAAgADwAMAAgAEMAIAAnADwAIAA6ACAAIQBNACAAJgA0ACAKQAwACAAUQAgACMAKAAgACwAUAAgAFQAIAAgAA=&UserName=K3HR 单点登录URL 生成（参考K3 客户化开发指导手册v11.0.pdf ）A、设置配置文件用 文本编辑器 打开 KingdeeK3ERPKDHRSITEFILEWEBUIWeb.config，定位，填写中间

23、层账套管理里的相应账套的账套编号。设 置HR账 套 编 号 为001.01，则 该 节 修 改 为 。B、设置系统集成账号用管理员账户登录HR 系统，进入用户管理，选择系统集成账户，设置该用户名和密码。如下图：名师资料总结-精品资料欢迎下载-名师精心整理-第 17 页，共 19 页 -点击上图的按钮“生成集成密码”打开页面，然后输入系统集成用户的密码，点击“生成加密密码”按钮，如图。C、生成登录字符串生成的单点登录URL 格式如下，其中红色部分为需要根据实际情况修改；其中localhost必须是发布的 HR 系统 WEB 地址。IDUserName 为系统集成账户名，IDPassward为集成

24、用户加密的密码。UserName 为登录用户名，后面值为空；将生成的URL 写入firstframe.properties 中的 plugins.k3hr.sso_url 属性。名师资料总结-精品资料欢迎下载-名师精心整理-第 18 页，共 19 页 -http:/localhost/KDHRMS/LoginStraight.aspx?IDUserName=HRUser&IDPassword=KQAgACAARgAgACIALAAgACwAUAAgAFQAIAAjADgAIAAqAFAAIQBEACAAJgBEACAAOAAwACEATgAgACYAQAAgADwAMAAgAEMAIAAnADwAIAA6ACAAIQBNACAAJgA0ACAKQAwACAAUQAgACMAKAAgACwAUAAgAFQAIAAgAA=&UserName=名师资料总结-精品资料欢迎下载-名师精心整理-第 19 页，共 19 页 -