金蝶k3开发集成文档Word格式.docx
- 文档编号:8320423
- 上传时间:2023-05-11
- 格式:DOCX
- 页数:18
- 大小:763.85KB
金蝶k3开发集成文档Word格式.docx
《金蝶k3开发集成文档Word格式.docx》由会员分享,可在线阅读,更多相关《金蝶k3开发集成文档Word格式.docx(18页珍藏版)》请在冰点文库上搜索。
Container"
type="
javax.sql.DataSource"
maxActive="
30"
maxIdle="
20"
maxWait="
10000"
******username="
sa"
password="
driverClassName="
net.sourceforge.jtds.jdbc.Driver"
url="
jdbc:
jtds:
sqlserver:
//127.0.0.1:
1433;
DatabaseName=k3hr"
/>
增加后的效果如图:
●Apusic下配置:
\KingdeeOA\apusic\domains\server1\config\datasources.xml(D:
\KingdeeOA为OA的安装路径)文件,增加一个名称为“jdbc/K3DS”(注意大小写)的数据源,连接到K3的数据库。
<
datasourcename="
K3DS"
jndi-name="
driver-class="
url="
DatabaseName=k3hr"
>
propertyname="
user"
value="
k3"
/>
password"
test-before-reused"
false"
<
/datasource>
b)在OA配置文件中调用中间件定义的数据源
\KingdeeOA\firstframe\resources\jdbc.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/K3DS
3、修改OA配置文件
●修改firstframe.properties
\KingdeeOA\firstframe\resources\firstframe.properties文件,找到plugins.k3参数,有两个值false和true,true为集成K3HR;
false为不集成K3HR。
plugins.k3=true
●配置定时同步(可默认不修改)
系统后台能定时将K3中的数据自动同步到系统中,同时可以设置定时同步的时间间隔,默认是每2小时做一次同步。
配置文件\resources\cn\firstsoft\firstframe\plugins\quartz\applicationContext-quartz.xml
设置自动同步间隔时间。
beanid="
dataSyncAllTrigger"
class="
org.springframework.scheduling.quartz.CronTriggerBean"
jobDetail"
reflocal="
dataSyncAllDetail"
/property>
!
--所有的都同步一次,调整为每2个小时做一次,效率问题-->
cronExpression"
value>
0010,12,15,18,20,23*,**?
alue>
/bean>
4、数据同步操作
完成上述配置后,启动OA服务,就能将K3中的相应数据同步到OA系统中了,其同步方式有两种,一种是手动同步,在OA系统的系统管理,同步管理中有“K3/HR部门用户同步”,点击此按钮系统触发同步操作,进行数据同步。
同时系统还会根据配置的定时同步时间将K3中的数据进行定时同步。
在安装完OA后,按上述操作配置好系统后,需要手工做一次数据的同步,之后就可以由系统定时同步来处理K3部门、用户等信息的同步了,至此,K3数据开放的配置就完成了,OA系统中的组织架构,用户等信息就保持了跟K3的同步。
5、注意事项
●用户同步
在K3/HR中,对用户的信息记录,有用户名和登录名等等,在具体的实施过程中,如果HR员工平台数很少,一般起登录名是空的,那么OA会将用户姓名同步过来,作为OA的登陆名(loginid),这里需要注意用户重名的问题。
●先确认K3数据已经导入
先确认K3系统中已经完成了组织架构、用户、职位等数据的导入工作后,再进行OA数据集成的配置。
三、流程转凭证
1、OA流程转凭证功能描述
OA流程单据(费用报销、借款单、付款凭证)→单据数据导入OA的数据库→K3转凭证工具将OA中间表的记录导入K3数据库→K3财务生成凭证。
转凭证界面数据的说明,如下图所示:
红色框中的数据是从K3财务系统读取的数据,而蓝色框的数据则从OA表单中转过来的数据,由于OA的表单是自定表单,因此需要做相应的字段对应配置工作才能将OA表单的数据转到该界面。
2、OA流程转凭证配置方法
●数据同步配置
如果要做转凭证的操作,需要先配置好数据同步,具体操作按本文档中的第一条“数据集成设置”。
如果K3中有多个帐套,在转凭证的时候,不同的表单可能要转入到对应的帐套中去,需要这是多个K/3帐套,其操作在数据库中执行
SETIDENTITY_INSERT[system_dicts]ON
INSERT[system_dicts]([id],[label],[name],[options])VALUES(11,N'
k3.datacenter'
N'
K/3帐套'
'
)
SETIDENTITY_INSERT[system_dicts]OFF
然后,在系统管理→系统字典里设置K/3帐套的字典项(帐套编码|描述),如“K3CS|财务凭证”。
同时确认firstframe\webappWEB-INF\firstframe-servlet.xml(5.33及以前版本)、firstframe\resources\context\applicationContext-controller.xml(6.0及以后版本)文件中
importresource="
file:
${oa_application.config}/cn/firstsoft/firstframe/plugins/kingdee/k3/
applicationContext-k3Integration-controller.xml"
是否被<
---->
注释,如果是,请去掉它外面的注释符<
--和-->
●配置财务数据来来源(在OA转凭证时数据取自哪一个K3财务数据库)
在设计工作流后,先要查看firstframe\resources\jdbc.properties文件
#kingdeeK3databasevoucher
#MSSQL,jtds-1.2.jarDriver
k3.jdbc.driverClassName=net.sourceforge.jtds.jdbc.Driver
k3.jdbc.url=jdbc\:
jtds\:
sqlserver\:
//127.0.0.1\:
DatabaseName\=K3CW
k3.jdbc.username=oadb
k3.jdbc.password=oapassword
红色字部分请根据实际K3财务数据库设置
●设置OA库中间表(在OA转凭证后,数据是存放在中间表中,需要k/3凭证导入工具把中间表数据导到K3财务数据库,下面会讲到导入操作)
请将以下脚本在OA数据库中执行
执行脚本:
●流程中K3转凭证节点的设置(流程配置)
①在设计工作流后,先要查看firstframe\data\workflow\config\stepinfo.xml文件
K3转凭证>
id>
001<
/id>
name>
K3转凭证<
/name>
url>
/oa/modules/workflow/k3Integration.do?
method=getK3VoucherInfo<
/url>
winsize>
100,100,1000,450<
/winsize>
title>
转凭证<
/title>
info>
info<
/info>
/K3转凭证>
2在设计转凭证结点时,结点的以格式为:
[***]例如[转凭证],中括号的内容是可以改变,但结点名称内容必须跟stepinfo.xm名称相同。
属性:
主要显示特殊工作点结点按钮显示名称.可以修改的.
主要调整弹出窗口的大小的。
在流程设计里设置如下图:
●报销流程表单转凭证的属性配置(表单配置)
配置OA应用程序,D:
\KingdeeOA\firstframe\data\workflow\config\
目录下的文件voField_X.xml(X代表表单的id,并保留原来的voField.xml文件),因为在企业实际应用中,存在多张表单的数据需要导入K3的财务,所以只要配置好voField_X.xml文件,就可以OA系统中扩展多张表单转凭证。
需要注意的是,voField_X.xml与OA的表单是一一对应的,也就说有几张表单需要转凭证,就必须配置几个voField_X.xml来匹配。
voField_X.xml文件配置:
OA表单中短字段、长字段在voField_X.xml文件中的配置。
OA表单中列表字段在voField_X.xml文件中的配置。
●流程转凭证效果示意
付款转凭证:
费用报销转凭证
四、凭证导入
1、凭证导入工具设置
K3转凭证工具已经在K3服务器上部署完成,由OA系统管理员来维护及设置,一般操作用户不需要了解。
登录至K3服务器即可看见该工具的界面。
用户只需设置自动导入的周期或手动导入,如下图所示。
凭证导入工具下载:
需要配置两个数据源,因为需要从OA的中间表中取得数据,需要配置连接OA系统的数据库的数据源。
同时需要将OA中间表的数据写入的K3系统中,需要在导入数据的时候,需要选择对应的帐套,输入登陆用户名和密码。
2、凭证导入操作
在上述的配置文档中,有工作方式的配置,“工作方式”是指工具把OA中间表中的数据转入财务数据的操作方式,分为两种:
1、“手动执行”,每次转凭证时,需要打开此工具手工点“手动导入”来完成凭证的导入。
2、“自动执行”,自动执行又分“按月执行”、“按周执行”、“按日执行”、“自定义执行频率”四个方面。
⑴“按月执行”是每个月的某一天某一时刻执行一次转入凭证操作;
⑵“按周执行”是每周的某一天某一时刻执行一次转入凭证操作;
⑶“按日执行”是每天的某一时刻执行一次转入凭证操作;
⑷“自定义执行频率”是每阁多少天多少小时多少分执行一次转入凭证操作。
配置完参数设置保存配置后,点击“查看数据”,可以更新“已导入数据”和“未导入数据”。
如图5。
如果设置的是“手动执行”,那么直接点“手动导入”就可以把当前所有未导入的数据导入凭证,在最下面有信息,可显示导入成功数量和失败数量,成功后即可去财务系统里进行凭证审核。
如图。
五、单点登录
1、单点登录实现原理
申请了注册码,开放了K3单点登录功能后,会在功能列表中多一个K3单点登录的按扭,点击后会新增一个页面进入HR系统,不用再输入用户名和密码,直接跳转到登录后的界面,如图。
需要注意的是,如果要做单点登陆,需要在申请注册码的时候,勾选上K3HR的模块。
它的原理是用HR的系统管理员帐户,生成一个系统集成用户,其实登录的时候是用系统集成用户来登录系统的,再根据你登录OA的用户名,可以对于HR登录后的用户,所以前提条件是两个系统的用户必须一致,否则点击后会提示:
“用户不存在”。
2、单点登录配置说明
●完成“K3数据开放设置”的配置。
●执行下面的数据库脚本
setIDENTITY_INSERT[system_modules]on
INSERT[system_modules]([id],[label_id],[name],[path],[url],[target],[pos],[isdisplay],[descn])VALUES(32,1,N'
K3HR'
k3hr'
../../plugins/k3hr/login_k3hr.jsp?
openwin=true'
_blank'
300,1,N'
K3HR'
setIDENTITY_INSERT[system_modules]off
setIDENTITY_INSERT[system_menus]on
INSERT[system_menus]([id],[name],[path],[type],[icon],[url],[target],[pos],[isdisplay],[descn])VALUES(900,N'
登录K3HR'
N'
1'
link.gif'
../../'
N'
_self'
3400,1,N'
)
setIDENTITY_INSERT[system_menus]off
setIDENTITY_INSERT[system_perms]on
INSERT[system_perms]([id],[name],[descn],[operation],[status],[path],[menus])VALUES(25,N'
AUTH_K3HR'
K3HR登录'
900'
setIDENTITY_INSERT[system_perms]off
需要oracle数据库脚本请联系技术支持
●修改firstframe.properties文件
修改\firstframe\resources\firstframe.properties文件,增加/修改plugins.k3hr.sso_url,这个参数是K3HR单点登录的URL,格式如下后续说明中详细介绍此URL的生成方法;
红色部分需要根据实际情况修改。
plugins.k3hr.sso_url=http:
//localhost/KDHRMS/LoginStraight.aspx?
IDUserName=HROpenUser&
IDPassword=KQAgACAARgAgACIALAAgACwAUAAgAFQAIAAjADgAIAAqAFAAIQBEACAAJgBEACAAOAAwACEATgAgACYAQAAgADwAMAAgAEMAIAAnADwAIAA6ACAAIQBNACAAJgA0ACAKQAwACAAUQAgACMAKAAgACwAUAAgAFQAIAAgAA==&
UserName=
●K3HR单点登录URL生成(参考《K3客户化开发指导手册v1[1].0.pdf》)
A、设置配置文件
用文本编辑器打开\Kingdee\K3ERP\KDHR\SITEFILE\WEBUI\Web.config,定位<
addkey="
AccountNumber"
01.00333"
,填写中间层账套管理里的相应账套的账套编号。
设置HR账套编号为001.01,则该节修改为<
001.01"
。
B、设置系统集成账号
用管理员账户登录HR系统,进入用户管理,选择系统集成账户,设置该用户名和密码。
如下图:
点击上图的按钮“生成集成密码”打开页面,然后输入系统集成用户的密码,点击“生成加密密码”按钮,如图。
C、生成登录字符串
生成的单点登录URL格式如下,其中红色部分为需要根据实际情况修改;
其中localhost必须是发布的HR系统WEB地址。
IDUserName为系统集成账户名,IDPassward为集成用户加密的密码。
UserName为登录用户名,后面值为空;
将生成的URL写入firstframe.properties中的plugins.k3hr.sso_url属性。
http:
IDUserName=HRUser&
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 金蝶 k3 开发 集成 文档