03協(xié)同實施工具04oa與k3集成配置

1、OA 集成 K3 配置說明密級：高版本：1.0目錄一、集成描述21、集成實現(xiàn)功能22、運行環(huán)境2二、數(shù)據(jù)集成21、代碼更新22、配置數(shù)據(jù)源23、修改 OA 配置文件34、數(shù)據(jù)同步操作45、注意事項4三、流程轉(zhuǎn)憑證41、OA 流程轉(zhuǎn)憑證功能描述42、OA 流程轉(zhuǎn)憑證配置方法5四、憑證導(dǎo)入111、憑證導(dǎo)入工具設(shè)置112、憑證導(dǎo)入操作12五、單點登錄141、單點登錄實現(xiàn)原理142、單點登錄配置說明14一、集成描述1、集成實現(xiàn)功能實現(xiàn)數(shù)據(jù)同步，從K3 系統(tǒng)中將部門、用戶、職位等信息同步到OA 系統(tǒng)；實現(xiàn) OA 流程轉(zhuǎn)K3 憑證功能；實現(xiàn)單點登錄，從OA 登錄到 K3HR 系統(tǒng)；2、運行環(huán)境K3 系統(tǒng)版

2、本（V10.6 或以上）OA 系統(tǒng)版本（V6.0）數(shù)據(jù)庫（sql server 2000 或 sql server2005）二、HR 數(shù)據(jù)同步1、代碼更新OA5.31 及以上版本不需要更新代碼，安裝包中已包含集成的代碼，如果需要集成的OA系統(tǒng)版本過低，需要手工更新代碼和數(shù)據(jù)庫，請與技術(shù)支持聯(lián)系。2、配置數(shù)據(jù)源因需要將K3 中的組織架構(gòu)和用戶、職位等信息同步到 OA 系統(tǒng)中，需要配置數(shù)據(jù)源，通過數(shù)據(jù)源取到 K3 中的相關(guān)信息。其配置方法如下：a)在中間件中定義連接K3 數(shù)據(jù)庫的數(shù)據(jù)源，根據(jù)不同的中間件，設(shè)置不同：Tomcat 下配置：修改 D:KingdeeOATomcat_5.5confser

3、ver.xml （D:KingdeeOA 為 OA 的安裝路徑，視具體情況而定）文件，增加一個名稱為“jdbc/K3DS”（注意大小寫）的數(shù)據(jù)源，連接到 K3的數(shù)據(jù)庫。增加后的效果如圖：Apusic 下配置：修改 D:KingdeeOAapusicsserver1configdatasour.xm（l D:KingdeeOA 為OA 的安裝路徑）文件，增加一個名稱為“jdbc/K3DS”（注意大小寫）的數(shù)據(jù)源，連接到K3 的數(shù)據(jù)庫。b)在 OA 配置文件中調(diào)用中間件定義的數(shù)據(jù)源修改 D:KingdeeOA徑，視具體情況而定）文件perties（D:King

4、deeOA 為 OA 的安裝路Tomcat 下配置找到 jndi.eas_namejndi參數(shù)，將該參數(shù)值中的 jdbc/Defaultp/env/jdbc/K3DS改成 jdbc/K3DS 。如： Apusic 下配置找到 jndi.eas_name參數(shù)，將該參數(shù)值中的 jdbc/Default改成 jdbc/K3DS 。如： jndi.eas_name=jdbc/K3DS3、修改 OA 配置文件修改perties修改 D:KingdeeOAperties 文件，找到 plugins.k3 參數(shù)，有兩個值 false 和 true，t

5、rue 為集成 K3HR；false 為不集成K3HR。如：plugins.k3=true配置定時同步系統(tǒng)能定時將K3 中的數(shù)據(jù)自動同步到系統(tǒng)中，同時可以設(shè)置定時同步的時間間隔，默認(rèn)是每 2 小時做一次同步。配置文件 resourcnsoftframepluginsquartzapplicationContext-quartz.xml設(shè)置自動同步間隔時間。0 0 10,12,15,18,20,23 *,* * ?用記事本打開 webappWEB-INFframe-servlet.xml，去掉 K3 的注釋符。請去掉它外面的注釋符即可。如果 OA 版本為 6.0，則上述的修改操作，需要在reso

6、urcontextapplicationContext-controller.xml 文件里進(jìn)行修改，其具體操作同上。4、數(shù)據(jù)同步操作完成上述配置后，啟動OA 服務(wù)，就能將 K3 中的相應(yīng)數(shù)據(jù)同步到 OA 系統(tǒng)中了，其同步方式有兩種，一種是手動同步，在 OA 系統(tǒng)的系統(tǒng)管理，同步管理中有“K3/HR 部門用戶同步”，點擊此按鈕系統(tǒng)觸發(fā)同步操作，進(jìn)行數(shù)據(jù)同步。實時同步按同時系統(tǒng)還會根據(jù)配置的定時同步時間將 K3 中的數(shù)據(jù)進(jìn)行定時同步。在安裝完OA 后，按上述操作配置好系統(tǒng)后，需要手工做一次數(shù)據(jù)的同步，之后就可以由系統(tǒng)定時同步來處理 K3 部門、用戶等信息的同步了，至此，K3 數(shù)據(jù)開放的配置就完成

7、了，OA 系統(tǒng)中的組織架構(gòu)，用戶等信息就保持了跟K3 的同步。5、注意事項用戶同步在 K3/HR 中，對用戶的信息，有用戶名和登錄名等等，在具體的實施過程中，如果HR 員工數(shù)很少，一般起登錄名是空的，那么 OA 會將用戶同步過來，作為OA 的登陸名（loginid），這里需要注意用戶重名。先確認(rèn) K3 數(shù)據(jù)已經(jīng)導(dǎo)入先確認(rèn) K3 系統(tǒng)中已經(jīng)完成了組織架構(gòu)、用戶、職位等數(shù)據(jù)的導(dǎo)入工作后，再進(jìn)行 OA數(shù)據(jù)集成的配置。三、流程轉(zhuǎn)憑證1、OA 流程轉(zhuǎn)憑證功能描述OA 流程單據(jù)（費用報銷、借款單、付款憑證）單據(jù)數(shù)據(jù)導(dǎo)入 OA 的數(shù)據(jù)庫K3 轉(zhuǎn)憑證工具將OA 中間表的導(dǎo)入K3 數(shù)據(jù)庫K3 財務(wù)生成憑證。轉(zhuǎn)憑

8、證界面數(shù)據(jù)的說明，如下圖所示：紅色框中的數(shù)據(jù)是從 K3 財務(wù)系統(tǒng)的數(shù)據(jù)，而藍(lán)色框的數(shù)據(jù)則從OA 表單中轉(zhuǎn)過來的數(shù)據(jù)，由于 OA 的表單是自定表單，因此需要做相應(yīng)的字段對應(yīng)配置工作才能將OA 表單的數(shù)據(jù)轉(zhuǎn)到該界面。K3 財務(wù)系統(tǒng)選取的數(shù)據(jù)OA 表單轉(zhuǎn)過來的數(shù)據(jù)2、OA 流程轉(zhuǎn)憑證配置方法數(shù)據(jù)同步配置如果要做轉(zhuǎn)憑證的操作，需要先配置好數(shù)據(jù)同步，具體操作按本文檔中的第一條“數(shù)據(jù)集成設(shè)置”。如果 K3 中有多個帳套，在轉(zhuǎn)憑證的時候，不同的表單可能要轉(zhuǎn)入到對應(yīng)的帳套中去，需要這是多個 K/3 帳套，其操作在數(shù)據(jù)庫中執(zhí)行然后，在系統(tǒng)管理系統(tǒng)字典 里設(shè)置 K/3 帳套的 字典項(帳套編碼|描述)，如“K3C

9、S|財務(wù)憑證”。同時確認(rèn)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配置財務(wù)數(shù)據(jù)來來源（在 OA 轉(zhuǎn)憑證時數(shù)據(jù)取自哪一個 K3 財務(wù)數(shù)據(jù)庫）在設(shè)計工作流后，先要查看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紅色字部分請根據(jù)實際 K3 財務(wù)數(shù)據(jù)庫設(shè)置設(shè)置 OA 庫中間表（在 OA 轉(zhuǎn)憑證后，數(shù)據(jù)是存放在中間表中，需要 k/3 憑證導(dǎo)入工具把中間表數(shù)據(jù)導(dǎo)到

11、 K3 財務(wù)數(shù)據(jù)庫，下面會講到導(dǎo)入操作）請將以下在 OA 數(shù)據(jù)庫中執(zhí)行執(zhí)行：報銷流程表單轉(zhuǎn)憑證的屬性配置（表單配置）配置 OA 應(yīng)用程序，D:KingdeeOAframedataworkflowconfig目錄下的文件 voField_X.xml（X 代表表單的 id，并保留原來的 voField.xml 文件），因為在企業(yè)實際應(yīng)用中， 存在多張表單的數(shù)據(jù)需要導(dǎo)入 K3 的財務(wù)， 所以只要配置好 voField_X.xml 文件，就可以 OA 系統(tǒng)中擴展多張表單轉(zhuǎn)憑證。需要注意的是，voField_X.xml與 OA 的表單是一一對應(yīng)的，也就說有幾張表單需要轉(zhuǎn)憑證，就必須配置幾個 voFiel

12、d_X.xml來匹配。voField_X.xml 文件配置：OA 表單中短字段、長字段在 voField_X.xml 文件中的配置。voField_X.xml 文件配置：OA 表單中列表字段在 voField_X.xml 文件中的配置。此處填寫 OA 表單中需要導(dǎo)入到 K3 中數(shù)據(jù)的字段名（短字段或長字段的配置格式）流程轉(zhuǎn)憑證效果示意OA 表單的列表字段的配置格式付款轉(zhuǎn)憑證：費用報銷轉(zhuǎn)憑證四、憑證導(dǎo)入1、憑證導(dǎo)入工具設(shè)置K3 轉(zhuǎn)憑證工具已經(jīng)在 K3 服務(wù)器上部署完成，由 OA 系統(tǒng)管理員來及設(shè)置，一般操作用戶不需要了解。登錄至 K3 服務(wù)器即可看見該工具的界面。用戶只需設(shè)置自動導(dǎo)入的周期或手動

13、導(dǎo)入，如下圖所示。憑證導(dǎo)入工具：需要配置兩個數(shù)據(jù)源，因為需要從OA 的中間表中取得數(shù)據(jù)，需要配置連接 OA 系統(tǒng)的數(shù)據(jù)庫的數(shù)據(jù)源。同時需要將 OA 中間表的數(shù)據(jù)寫入的 K3 系統(tǒng)中，需要在導(dǎo)入數(shù)據(jù)的時候，需要選擇對應(yīng)的帳套，輸入登陸用戶名和。2、憑證導(dǎo)入操作在上述的配置文檔中，有工作方式的配置，“工作方式”是指工具把 OA 中間表中的數(shù)據(jù)轉(zhuǎn)入財務(wù)數(shù)據(jù)的操作方式，分為兩種：1、“手動執(zhí)行”，每次轉(zhuǎn)憑證時，需要打開此工具手工點“手動導(dǎo)入”來完成憑證的導(dǎo)入。2、“自動執(zhí)行”，自動執(zhí)行又分“按月執(zhí)行”、“按周執(zhí)行”、“按日執(zhí)行”、“自定義執(zhí)行頻率”四個方面?！鞍丛聢?zhí)行”是每個月的某一天某一時刻執(zhí)行一次

14、轉(zhuǎn)入憑證操作；“按周執(zhí)行”是每周的某一天某一時刻執(zhí)行一次轉(zhuǎn)入憑證操作；“按日執(zhí)行”是每天的某一時刻執(zhí)行一次轉(zhuǎn)入憑證操作；“自定義執(zhí)行頻率”是每閣多少天多少小時多少分執(zhí)行一次轉(zhuǎn)入憑證操作。配置完參數(shù)設(shè)置保存配置后，點擊“查看數(shù)據(jù)”，可以更新“已導(dǎo)入數(shù)據(jù)”和“未導(dǎo)入數(shù)據(jù)”。如圖 5。如果設(shè)置的是“手動執(zhí)行”，那么直接點“手動導(dǎo)入”就可以把當(dāng)前所有未導(dǎo)入的數(shù)據(jù)導(dǎo)入憑證，在最下面有信息，可顯示導(dǎo)入成功數(shù)量和失敗數(shù)量，成功后即可去財務(wù)系統(tǒng)里進(jìn)行憑證審核。如圖。五、單點登錄1、單點登錄實現(xiàn)原理申請了碼，開放了 K3 單點登錄功能后，會在功能列表中多一個 K3 單點登錄的按扭，點擊后會新增一個頁面進(jìn)入 HR

15、 系統(tǒng)，不用再輸入用戶名和界面，如圖。，直接跳轉(zhuǎn)到登錄后的需要注意的是，如果要做單點登陸，需要在申請碼的時候，勾選上 K3HR 的模塊。直接點擊進(jìn)入 HR 系統(tǒng)它的原理是用 HR 的系統(tǒng)管理員帳戶，生成一個系統(tǒng)集成用戶，其實登錄的時候是用系統(tǒng)集成用戶來登錄系統(tǒng)的，再根據(jù)你登錄 OA 的用戶名，可以對于 HR 登錄后的用戶，所以前提條件是兩個系統(tǒng)的用戶必須一致，否則點擊后會提示：“用戶不存在”。2、單點登錄配置說明完成“K3 數(shù)據(jù)開放設(shè)置”的配置。執(zhí)行下面的數(shù)據(jù)庫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 數(shù)據(jù)庫請聯(lián)系技術(shù)支持perties 文件修改修改perties 文件，增加/修改 plugins.k3hr.sso_url，這個參數(shù)是 K3HR 單點登錄的 URL，格式如下后續(xù)說明中詳細(xì)介紹此 URL 的生成方法；紅色部分需要根據(jù)實際情況修改。plugins.k3hr.sso_url=r&IDPassword=KQAgACAARgAgALAAgACwAUAAgAF

18、QAIAAjADgAIAAqAFAAIQBEACAAJgBEACAAOAAwACEATgAgACYAQAAgADwAMAAgAEMAIAAnA DwAIAA6ACAAIQBNACAAJgA0ACAKQAwACAAUQAgACMAKAAgACwAUAAgAFQAIAAgAA=&UserName=K3HR 單點登錄 URL 生成（參考K3 客戶化開發(fā)指導(dǎo)手冊 v11.0.pdf） A、設(shè)置配置文件用文本編輯器打開 SiteFileWebUIWeb.config ， 定位，填寫中間層賬套管理里的相應(yīng)賬套的賬套。設(shè)置 HR 賬套為 001.01，則該節(jié)修改為。 B、設(shè)置系統(tǒng)集成賬號用管理員賬戶登錄HR 系統(tǒng)，進(jìn)入用戶管理，選擇系統(tǒng)集成賬戶，設(shè)置該用戶名和。如下圖：點擊上圖的按鈕“生成集成”打開頁面，然后輸入系統(tǒng)集成用戶的，點擊“生成加密”按鈕，如圖。C、生成登錄字符串生成的單點登錄URL格式如下，其中紅色部分為需要根據(jù)實際情況修改；其中l(wèi)ocalhost必須是發(fā)布的HR