网站建设销售找客源种子搜索
泛微e9 OA中通过Java SDK获取金蝶云星空中的表单数据
一、开发前准备
- 需要先在金蝶中配置金蝶系统中的第三方系统登录授权
- 下载1.8的JavaSDK
- 找到对应表单的接口API文档中心
二、运行环境配置
你最好是先直接跑一下金蝶sdk中的那个demo,再去集成到OA中
首先需要编辑一下配置文件,将金蝶的第三方授权登陆的信息填写过来
上面的这些配置信息中的第一个,AcctID可以这样获取:
然后就是填写应用ID、密钥、用户名。这个LCID不用变,最后就把地址改成你公司的金蝶地址就可以了。需要注意的是这个配置文件需要放到项目的根目录下,在OA中则是将该文件放到ecology/classbean下才会生效。
在本地环境中需要把金蝶sdk加到lib中,在服务器上则是把这个金蝶的包放到ecology/WEB-INF/lib目录下
三、使用金蝶的SDK获取表单数据
3.1 单据查询案例解析
先看官网API使用案例:
使用这个api返回的值其实是数据而不是json,想要json的数据格式就用executeBillQueryJson这个方法,不过我感觉没必要,直接我下面的方式解析就可以:
@Testpublic void getPAYORG() throws Exception {HashMap<Integer, String> orgNameMap = new HashMap<>();// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {JsonObject params = new JsonObject();params.addProperty("FormId", "ORG_Organizations");params.addProperty("FieldKeys", "FOrgID,FName");params.addProperty("StartRow", startRow);params.addProperty("Limit", limit);params.addProperty("IsSortBySeq", false);String jsonData = GSON.toJson(params);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}for (List<Object> obj : result) {orgNameMap.put((Integer) obj.get(0), (String) obj.get(1));}startRow += result.size();}System.out.println(orgNameMap);}
如果你想查别的表就直接换一下params.addProperty(“FormId”, “ORG_Organizations”);当中表名就可以了,表名在api接口中都有。
这个比较麻烦的问题是你不知道你要的字段的字段名到底叫做什么?
解决的办法是去查看保存的api接口
或者是这个地方:
你就能获得大部分的字段名了,如果涉及到多张表的那种表单,有些字段你还是不知道,还可以这样:先去登陆系统,然后找到这张表单,再按照模板引出,这样表单的字段名也会出来。
但是还是有些字段你还是发现查不出来,你还可以通过view来先查询一条数据,这样它会返回给你该数据的所有字段的属性名和值,然后去确认这个字段叫做什么。
但是还是有些字段你还是查不出来,比如这种的情况:
像这种就去金蝶社区的帮助中心查询相关的情况。这样你就应该可以查询金蝶api中所有表单的值了。
3.2 view接口解析
先看官网案例:
只要在json中传入编码或者是id就可以返回对应数据了,你只要能区分什么是编码什么是Id就可以了。
API中的Number就是上图的编码,而Id是指这条数据的数据库id
四、获取金蝶应付单的实际案例
金蝶表单的数据同步可以写到OA的计划任务当中,至于计划任务具体的编写方式可以参考这个:
泛微二开文档
package com.customization.suppy.cron;import com.customization.suppy.pojo.Appayable;
import com.google.gson.*;
import com.kingdee.bos.webapi.sdk.K3CloudApi;
import org.junit.Test;
import weaver.conn.RecordSet;
import weaver.formmode.data.ModeDataIdUpdate;
import weaver.formmode.setup.ModeRightInfo;
import weaver.interfaces.schedule.BaseCronJob;import java.time.LocalDate;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;public class SyncAPPayableCron extends BaseCronJob {K3CloudApi client = new K3CloudApi();private static final Gson GSON = new Gson();HashMap<Integer, String> supplierMap = new HashMap<>();HashMap<Integer, String> unitNameMap = new HashMap<>();HashMap<Integer, String> materialMap = new HashMap<>();HashMap<Integer, String> orderMap = new HashMap<>();/*** 定时任务*/@Overridepublic void execute() {// SYN_PERSON_TABLE_NAME 建模表名String SYN_PERSON_TABLE_NAME = "uf_AP_Payable";// SYN_PERSON_FLOW_ID 模块idint SYN_PERSON_FLOW_ID = 14;RecordSet recordSet = new RecordSet();try {// 首先获取所有的数据List<Appayable> apPayableList = getAPPayableList();// 遍历list,通过FBillNo来判断for (Appayable appayable : apPayableList) {if (appayable.getFBillNo().equals(" "))continue;String sql = "select id from uf_AP_Payable where FBillNo= '"+appayable.getFBillNo()+"';";recordSet.executeQuery(sql);if (recordSet.next()) {String mainid = recordSet.getString("id");// 代表是重复的数据,再查询明细表,将数据插入到明细表String sql_detail = "select id from uf_AP_Payable_dt1 where FMATERIALID='"+appayable.getFMATERIALID()+"'";recordSet.executeQuery(sql_detail);if (recordSet.next()) {// 代表此物料编码已经存在了,直接跳过该条数据} else {// 代表需要插入明细表String insertSql = "INSERT INTO uf_AP_Payable_dt1 (mainid, FBillNo, FMATERIALID, FMaterialDesc, FModel, FPRICEUNIT,FPriceQty,FTaxPrice,FALLAMOUNTFOR_D) " +"VALUES (" + mainid + ", '" + appayable.getFOrderNumber() + "', '" + appayable.getFMATERIALID() + "','" + appayable.getFMaterialDesc() + "','" + appayable.getFModel() + "','" + appayable.getFPRICEUNIT() + "'," + appayable.getFPriceQty() + "," + appayable.getFTaxPrice() + "," + appayable.getFALLAMOUNTFOR_D() + ")";recordSet.executeUpdate(insertSql);}} else {// 新增建模表,然后直接将所有数据更新到建模表当中。// 获取现在的时间LocalDate currentDate = LocalDate.now();LocalTime currentTime = LocalTime.now();DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HH-mm-ss");String _currentTime = currentTime.format(formatter);// 通过代码创建一条建模数据int id = ModeDataIdUpdate.getInstance().getModeDataNewIdByUUID(SYN_PERSON_TABLE_NAME, SYN_PERSON_FLOW_ID, 1, 1, currentDate.toString(), _currentTime);ModeRightInfo ModeRightInfo = new ModeRightInfo();ModeRightInfo.setNewRight(true);// 新建的时候添加共享ModeRightInfo.editModeDataShare(1, SYN_PERSON_FLOW_ID, id);// 新建的时候添加文档共享ModeRightInfo.addDocShare(1, SYN_PERSON_FLOW_ID, id);// 调整主表数据String updateSql = "UPDATE uf_AP_Payable " +" SET FBillNo = '" + appayable.getFBillNo() + "', " +" FSUPPLIER = '" + appayable.getFSUPPLIER() + "', " +" FENDDATE_H = '" + appayable.getFENDDATE_H() + "', " +" FDATE = '" + appayable.getFDATE() + "', " +" FEntryTaxRate = " + appayable.getFEntryTaxRate() +" WHERE id = " + id;recordSet.executeUpdate(updateSql);// 调整明细表数据String insertSql = "INSERT INTO uf_AP_Payable_dt1 (mainid, FBillNo, FMATERIALID, FMaterialDesc, FModel, FPRICEUNIT,FPriceQty,FTaxPrice,FALLAMOUNTFOR_D) " +"VALUES (" + id + ", '" + appayable.getFOrderNumber() + "', '" + appayable.getFMATERIALID() + "','" + appayable.getFMaterialDesc() + "','" + appayable.getFModel() + "','" + appayable.getFPRICEUNIT() + "'," + appayable.getFPriceQty() + "," + appayable.getFTaxPrice() + "," + appayable.getFALLAMOUNTFOR_D() + ")";recordSet.executeUpdate(insertSql);}}} catch (Exception e) {throw new RuntimeException(e);}}/*** 获取所有的供应商名称并且将其传入 supplierMap 当中*/public void getAllSupplier() throws Exception {// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {JsonObject params = new JsonObject();params.addProperty("FormId", "BD_Supplier");params.addProperty("FieldKeys", "FSUPPLIERID,FName");params.addProperty("StartRow", startRow);params.addProperty("Limit", limit);params.addProperty("IsSortBySeq", false);String jsonData = GSON.toJson(params);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}for (List<Object> obj : result) {supplierMap.put((Integer) obj.get(0), (String) obj.get(1));}startRow += result.size();}}/*** 获取所有的计量单位并且存在 unitNameMap 当中*/public void getAllUnitName() throws Exception {// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {JsonObject params = new JsonObject();params.addProperty("FormId", "BD_UNIT");params.addProperty("FieldKeys", "FUNITID,FName");params.addProperty("StartRow", startRow);params.addProperty("Limit", limit);params.addProperty("IsSortBySeq", false);String jsonData = GSON.toJson(params);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}for (List<Object> obj : result) {unitNameMap.put((Integer) obj.get(0), (String) obj.get(1));}startRow += result.size();}}/*** 获取所有的物料信息,然后将物料的id转成物料的编码*/public void getAllMaterial() throws Exception {// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {JsonObject params = new JsonObject();params.addProperty("FormId", "BD_MATERIAL");params.addProperty("FieldKeys", "FMATERIALID,FNumber");params.addProperty("StartRow", startRow);params.addProperty("Limit", limit);params.addProperty("IsSortBySeq", false);String jsonData = GSON.toJson(params);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}for (List<Object> obj : result) {materialMap.put((Integer) obj.get(0), (String) obj.get(1));}startRow += result.size();}}/*** 存采购明细内码和采购订单号*/public void getAllOrderNumber() throws Exception {// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {JsonObject params = new JsonObject();params.addProperty("FormId", "PUR_PurchaseOrder");params.addProperty("FieldKeys", "FPOOrderEntry_FEntryID,FPURCHASEORDERNO");params.addProperty("StartRow", startRow);params.addProperty("Limit", limit);params.addProperty("IsSortBySeq", false);String jsonData = GSON.toJson(params);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}for (List<Object> obj : result) {orderMap.put((Integer) obj.get(0), (String) obj.get(1));}startRow += result.size();}}/*** 获取金蝶中应付单的完整数据*/public List<Appayable> getAPPayableList() throws Exception {getAllSupplier();getAllUnitName();getAllMaterial();getAllOrderNumber();K3CloudApi client = new K3CloudApi();Gson gson = new Gson();ArrayList<Appayable> appayables = new ArrayList<>();// 定义每页获取的数据条数,这里可根据接口最大允许值设置(例如10000)int limit = 10000;// 从第0条数据开始读取int startRow = 0;while (true) {// 构建请求的 JSON 对象JsonObject jsonObject = new JsonObject();jsonObject.addProperty("FormId", "AP_Payable");jsonObject.addProperty("FieldKeys", "FBillNo,FSUPPLIERID,FENDDATE_H,FDATE,FEntryTaxRate,FOrderEntryID,FMATERIALID,FMaterialDesc,FModel,FPRICEUNITID,FPriceQty,FTaxPrice,FALLAMOUNTFOR_D");jsonObject.addProperty("FilterString", "");jsonObject.addProperty("OrderString", "");jsonObject.addProperty("TopRowCount", 0);jsonObject.addProperty("StartRow", startRow);jsonObject.addProperty("Limit", limit);jsonObject.addProperty("SubSystemId", "");String jsonData = gson.toJson(jsonObject);// 调用接口获取一页数据List<List<Object>> result = client.executeBillQuery(jsonData);if (result == null || result.isEmpty()) {// 当返回结果为空时,说明所有数据已经读取完毕,退出循环break;}// 处理当前页数据for (List<Object> obj : result) {Appayable appayable = new Appayable();// 注意:此处的类型转换需要与实际返回的数据类型相符appayable.setFBillNo((String) obj.get(0));appayable.setFSUPPLIER(supplierMap.get((Integer) obj.get(1)));appayable.setFENDDATE_H(((String) obj.get(2)).substring(0,10));appayable.setFDATE(((String) obj.get(3)).substring(0,10));appayable.setFEntryTaxRate((Double) obj.get(4));appayable.setFOrderNumber(orderMap.get((Integer)obj.get(5)));appayable.setFMATERIALID(materialMap.get((Integer) obj.get(6)));appayable.setFMaterialDesc((String) obj.get(7));appayable.setFModel((String) obj.get(8));appayable.setFPRICEUNIT(unitNameMap.get((Integer) obj.get(9)));appayable.setFPriceQty((Double) obj.get(10));appayable.setFTaxPrice((Double) obj.get(11));appayable.setFALLAMOUNTFOR_D((Double) obj.get(12));appayables.add(appayable);}// 累加已读取的行数,准备读取下一页startRow += result.size();}return appayables;}/* @Testpublic void test() throws Exception {List<Appayable> apPayableList = getAPPayableList();for (Appayable appayable : apPayableList) {System.out.println(appayable);}}*/
}