《2022年2022年金蝶k开发集成文档 .pdf》由会员分享,可在线阅读,更多相关《2022年2022年金蝶k开发集成文档 .pdf(19页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
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 页 -