泛微E9二次开发,对接金蝶云星空，数据同步，表单同步。

ゝ一世哀愁。 2024-03-26 18:34 67阅读 0赞

#### 文章目录 ####

*  泛微E9二次开发,对接金蝶云星空
 *  一、搭建开发环境，引入相关依赖
 *   *   *  一、创建项目
         *  二、配置javaSDK
         *  三、配置项目依赖
         *  四、编写测试代码
         *  五、配置编译
         *  六、resin远程debug配置
 *  二、开发部署
 *   *   *  1.编写自定义方法, 必须实现 必须实现接口weaver.interfaces.workflow.action方法public String execute(RequestInfo request);
         *  2.将文件上传至服务器D:\\WEAVER\\ecology\\classbean\\weaver\\interfaces\\workflow\\action目录；
         *  3.在后台，新增自定义接口;
         *  4.在后台 流程引擎-路径管理-路径设置, 找到对应流程,选中流程;
         *  5.代码更新操作
 *  三、代码示例
 *   *   *  1.流程自定义接口动作（action）
         *  2.自定义Action Demo
         *  3.采购申请单的同步
         *  3.ERP对接
 *  总结

--------------------

## 泛微E9二次开发,对接金蝶云星空 ##

`泛微E9二次开发,对接金蝶云星空，可以同步采购订单，付款申请单，收料通知单等等：`  
泛微E9二次开发,对接金蝶云星空，数据同步，表单同步。超详细，需要的jar包文档，可以在我的主页找到资源下载。

--------------------

## 一、搭建开发环境，引入相关依赖 ##

可以按照此链接步骤操作：[ecology后端开发环境搭建][ecology]

#### 一、创建项目 ####

1、新建项目：File->New->Project  
![新建项目][45d65c18a887455b9b354e4b239fa7d7.png_pic_center]  
2、选择java项目  
![选择java项目][java]  
3、下一步：Next  
![3][]  
4、继续下一步：Next，并输入项目名字之后点击Finish  
![完成][460dff84ffb643f9a49eb6369c645d8d.png_pic_center]

#### 二、配置javaSDK ####

ecology开发推荐使用idea

1、进入项目设置File-Project Structure  
![2.1][]  
2、点击SDKs->+，添加jdk1.8（e9依赖的版本）  
![2.2][]  
3、点击project，分别选择Project SDK为1.8、、Project language level为SDK default 8  
![2.3][]

#### 三、配置项目依赖 ####

1、进入项目设置：File->Project Structure  
![进入项目][f4bfee2ebd2e49299147b9d90a4299d5.png_pic_center]  
2、添加依赖库：Libaries->±>java  
![3.2][]  
3、找到要调试的ecology demo环境，分别引入以下路径的包

ecology/classbean
    ecology/web-inf/lib
    resin4/lib

**注：可以去服务器上找到相关的依赖**  
![相关依赖][73e84b268ab944ffaf91926db7d14f1b.png_pic_center]  
4、添加完之后点击Apply  
![应用][dcb9c78413c2468b8fc1fc4f989b0790.png_pic_center]

#### 四、编写测试代码 ####

1、点击src右键->new->Package  
![4.1][]  
2、右键点击包名->new->Java，注意包名带有impl层级，才可支持无侵入注解解析  
![4.2][]  
3、测试代码如下：

package com.api.cs.test20200529.service.impl;
    import com.weaverboot.frame.ioc.anno.classAnno.WeaIocReplaceComponent;
    import com.weaverboot.frame.ioc.anno.methodAnno.WeaReplaceAfter;
    import com.weaverboot.frame.ioc.anno.methodAnno.WeaReplaceBefore;
    import com.weaverboot.frame.ioc.handler.replace.weaReplaceParam.impl.WeaAfterReplaceParam;
    import com.weaverboot.frame.ioc.handler.replace.weaReplaceParam.impl.WeaBeforeReplaceParam;
    import com.weaverboot.tools.logTools.LogTools;
    @WeaIocReplaceComponent
    public class Test {
        
        @WeaReplaceBefore(value = "/api/workflow/reqlist/splitPageKey",order = 1,description = "测试拦截前置")
        public void beforeTest(WeaBeforeReplaceParam weaBeforeReplaceParam){
        
            //一顿操作
            LogTools.info("before:/api/workflow/reqlist/splitPageKey");
        }
        @WeaReplaceAfter(value = "/api/workflow/reqlist/splitPageKey",order = 1,description = "测试拦截后置")
        public String after(WeaAfterReplaceParam weaAfterReplaceParam){
        
            String data = weaAfterReplaceParam.getData();//这个就是接口执行完的报文
            LogTools.info("after:/api/workflow/reqlist/splitPageKey");
    //        LogTools.info(data);
            return data;
        }
    }

#### 五、配置编译 ####

1、进入项目设置：File->Project Structure  
![5.1][]  
2、进入Artifacts->±>JAR->Empty  
![5.2][]  
3、修改Name，这里要注意的是如果要支持无侵入注解解析，jar包名称必须包含下划线前缀，类似示例的写法  
![5.3][]  
4、修改jar包输出目录（output directory）到以下目录

ecology/web-inf/lib

![70229434382b4450a9a316f5c584e08d.png_pic_center][]  
5、添加src输出内容到jar包，点击Apply  
![5.5][]  
6、选择build->Build Artifacts  
![5.6][]  
7、点击build，即可完成编译  
![5.7][]  
8、到系统中查看编译结果  
![5.8][]

#### 六、resin远程debug配置 ####

ecology开发推荐使用idea，idea版权归属：JetBrains  
特别提示：调试模式禁止使用到生产系统，必须是开发环境

1、进入resin配置文件：`resin4/config/resin.properties 修改jvm_args`

jvm_args  : -Xdebug -Xrunjdwp:transport=dt_socket,address=9081,server=y,suspend=n -Dcom.sun.management.jmxremote -Xloggc:/var/log/gc.log -Xmx1550m -Xms1550m -XX:ParallelGCThreads=20 -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:+DisableExplicitGC
    jvm_mode  : -server

![6.1][]  
2、添加中间件连接  
![6.2][]  
3、添加±>Resin->Remote远程服务，分别输入ec服务地址URL、远程Resin调试端口Port  
![6.3][]  
4、选择configure，选择resin home  
![6.4][]  
5、添加jar包  
![6.5][]  
6、选择之前定义的Artifacts，点击Apply保存  
![6.6][]  
7、如果是同一个系统内，选择  
![6.7][]  
8、切换Startup/Connection，修改Debug->port为resin的远程调试端口  
![6.8][]  
9、services中启动debug  
![6.9][]  
10、到指定页面刷新（本示例是待办页面），成功进入断点，debug配置成功  
![6.10][]

## 二、开发部署 ##

#### 1.编写自定义方法, 必须实现 必须实现接口weaver.interfaces.workflow.action方法public String execute(RequestInfo request); ####

注： 写好的类需要编译为class 文件;

#### 2.将文件上传至服务器D:\\WEAVER\\ecology\\classbean\\weaver\\interfaces\\workflow\\action目录； ####

![编译类放置路径][68521620dbac4db9b77201f19e67a3c2.png_pic_center]

#### 3.在后台，新增自定义接口; ####

3.1 接口动作类文件填写 classbean 下文件路径;  
在后台 集成中心-流程流转集成, 注册自定义接口;  
![注册自定义接口][a6759ad5975a4b31a43b1132226c3fd4.png]

#### 4.在后台 流程引擎-路径管理-路径设置, 找到对应流程,选中流程; ####

4.1. 在右侧 流转设置-节点信息, 点击对应节点的 节点前后附加操作按钮;  
4.2 弹出窗口中, 选择 外部接口tab, 接口来源 选择 自定义创建的接口;  
4.3 点击确定 保存;  
![在节点上挂操作][2a69b91bfc754abb899901db2573a758.png]

#### 5.代码更新操作 ####

5.1 `重新编译文件;`  
5.2 `将编译后的class 文件上传至服务器对应路径;`

## 三、代码示例 ##

#### 1.流程自定义接口动作（action） ####

一、接口说明  
该接口主要实现在流程的流转当中，实时通过自定义的动作去操作异构系统的数据或者处理其他一些特定的业务，在流程的节点后、出口和节点前都可以定义这样的自定义动作。

二、实现方法&步骤  
**实现weaver.interfaces.workflow.action. Action接口即可**

//接口定义如下：
    import weaver.soa.workflow.request.RequestInfo;
    
    public interface Action {
        
        public static final String SUCCESS="1";
        
        /**
         * 失败信息，返回此信息，如果是节点前附加操作，将会阻止流程提交
         */
        public static final String FAILURE_AND_CONTINUE = "0";
        
        public String execute(RequestInfo request);
    }

#### 2.自定义Action Demo ####

代码如下（示例）：

package test.service.impl;
    
    import org.apache.commons.logging.Log;
    import org.apache.commons.logging.LogFactory;
    import kingdee.bos.webapi.client.K3CloudApiClient;
    import weaver.general.BaseBean;
    import weaver.general.Util;
    import weaver.interfaces.workflow.action.Action;
    import weaver.soa.workflow.request.*;
    import weaver.hrm.User;
    
    
    public class DemoAction implements Action {
        
        private Log log = LogFactory.getLog(DemoAction.class.getName());
        private String p1; // 自定义参数1
        private String p2; // 自定义参数2
    
    	public String getP1() {
        
    		return p1;
    	}
    
    	public void setP1(String p1) {
        
    		this.p1 = p1;
    	}
    
    	public String getP2() {
        
    		return p2;
    	}
    
    	public void setP2(String p2) {
        
    		this.p2 = p2;
    	}
    
    	public Log getLog() {
        
    		return log;
    	}
    
    	public void setLog(Log log) {
        
    		this.log = log;
    	}
    
    	public String execute(RequestInfo requestinfo) {
        
    		System.out.println("进入Action requestid=" + requestinfo.getRequestid());
    		String requestid = requestinfo.getRequestid();// 请求ID
    		String requestlevel = requestinfo.getRequestlevel();// 请求紧急程度
    		String src = requestinfo.getRequestManager().getSrc(); // 当前操作类型	submit:提交/reject:退回
    		String workflowid = requestinfo.getWorkflowid();// 流程路径ID
    		String tablename = requestinfo.getRequestManager().getBillTableName();// 表单主表名称
    		int billid = requestinfo.getRequestManager().getBillid();// 表单数据ID
    		User usr = requestinfo.getRequestManager().getUser();// 获取当前操作用户对象
    		String requestname = requestinfo.getRequestManager().getRequestname();// 请求标题
    		String remark = requestinfo.getRequestManager().getRemark();// 当前用户提交时的签字意见
    		int formid = requestinfo.getRequestManager().getFormid();// 表单ID
    		int isbill = requestinfo.getRequestManager().getIsbill();// 是否是自定义表单
    		//取主表数据
    		Property[] properties = requestinfo.getMainTableInfo().getProperty();// 获取表单主字段信息
    		for (int i = 0; i < properties.length; i++) {
        
    			String name = properties[i].getName();// 主字段名称
    			String value = Util.null2String(properties[i].getValue());// 主字段对应的值
    			System.out.println(name + " " + value);
    			log.info(name + " " + value);
    		}
    		// 取明细数据
    		DetailTable[] detailtable = requestinfo.getDetailTableInfo()
    				.getDetailTable();// 获取所有明细表
    		if (detailtable.length > 0) {
        
    			for (int i = 0; i < detailtable.length; i++) {
        
    				DetailTable dt = detailtable[i];// 指定明细表
    				Row[] s = dt.getRow();// 当前明细表的所有数据,按行存储
    				for (int j = 0; j < s.length; j++) {
        
    					Row r = s[j];// 指定行
    					Cell c[] = r.getCell();// 每行数据再按列存储
    					for (int k = 0; k < c.length; k++) {
        
    						Cell c1 = c[k];// 指定列
    						String name = c1.getName();// 明细字段名称
    						String value = c1.getValue();// 明细字段的值
    						System.out.println(name + " " + value);
    						log.info(name + " " + value);
    					}
    				}
    			}
    		}
    		
    
    //    调用ERP接口 单元测试代码
    //    public static void main(String[] args) {
        
    //        String res = "";
    //        Boolean loginResult = false;
    //        K3CloudApiClient client = new K3CloudApiClient("http://119.23.xx.xx/k3cloud/");
    //        try {
        
    //            loginResult = client.login("612112883069f0","134xxxx0349","JG2xxxxx10",2xxx);
    //            res = client.view("BD_Currency","{\"CreateOrgId\":0,\"Number\":\"PRE001\"}");
    //        } catch (Exception e) {
        
    //            e.printStackTrace();
    //        }
    //
    //        System.out.println("test202201174_1" + client);
    //        System.out.println("test202201174_2" + loginResult);
    //        System.out.println(res.getClass().getSimpleName());
    //        System.out.println("test202201174_3" + res);
    //
    //    }
    
    		//控制流程流转，增加以下两行，流程不会向下流转，表单上显示返回的自定义错误信息，这个控制只支持节点后附加操作
    		requestinfo.getRequestManager().setMessageid("错误信息编号");//126221
    		requestinfo.getRequestManager().setMessagecontent("返回自定义的错误信息");
    		System.out.println("Action执行完成 传入参数p1=" + this.getP1() + "  p2="	+ this.getP2());
    		log.info("Action执行完成 传入参数p1=" + this.getP1() + "  p2="	+ this.getP2());
    		
    		return SUCCESS;// return返回固定返回`SUCCESS`
    		
    //		//如果E8的版本是1604，也可以使用下面的代码进行控制，支持节点后、节点前、出口，注意必须返回 FAILURE_AND_CONTINUE;
    //		requestinfo.getRequestManager().setMessagecontent("返回自定义的错误信息");
    //		return FAILURE_AND_CONTINUE;
    		
    	}
    
    }

#### 3.采购申请单的同步 ####

代码如下（示例）：

package weaver.interfaces.workflow.action;
    
    import com.google.gson.Gson;
    import kingdee.bos.webapi.client.K3CloudApiClient;
    import org.apache.commons.logging.Log;
    import org.apache.commons.logging.LogFactory;
    import weaver.general.BaseBean;
    import weaver.general.Util;
    import weaver.soa.workflow.request.*;
    
    import java.util.*;
    
    
    /**
     * QDT自定义（资产采购申请单）/（维修改造采购申请单）action接口
     */
    public class ActionQDT_ZCCGSQD extends BaseBean implements Action {
        
    
        @Override
        public String execute(RequestInfo requestInfo) {
        
    
            ActionQDT_ZCCGSQD actionQDT_zccgsqd = new ActionQDT_ZCCGSQD();
    
            //设置初始值默认同步成功
            String action = SUCCESS;
    
            // 获取主表信息
            Property[] properties = requestInfo.getMainTableInfo().getProperty();
    
            //定义一个hashMap集合 存储主表的数据。 key存E-COS数据库字段名称  Value存E-cos字段值
            HashMap<String, String> mainTable = new HashMap<>();
            for (int i = 0; i < properties.length; i++) {
        
                String name = Util.null2String(properties[i].getName());// 主字段名称
                String value = Util.null2String(properties[i].getValue());// 主字段对应的值
                mainTable.put(name,value);
            }
    
            //取到主表的“单据类型”                      //单据类型
            int DocumentType = Integer.parseInt(mainTable.get("djlx"));
    
            //0：标准资产采购申请单
            //如果单据类型是 “标准资产采购申请单”
            if (DocumentType==0) {
        
                //定义list集合存储明细表json字符串
                List<String> list_json1 = new ArrayList<String>();
    
                //定义一个集合存储明细表的数据
                List<Map<String,String>> detailTable1=new ArrayList<>();
    
                // 获取所有明细表
                DetailTable[] detailtable = requestInfo.getDetailTableInfo().getDetailTable();
                if (detailtable.length > 0) {
        
                    //循环所有的明细表 【此单据只有一个明细表】
                    for (int i = 0; i < detailtable.length; i++) {
        
                        DetailTable dt = detailtable[i];// 指定明细表
                        Row[] s = dt.getRow();// 当前明细表的所有数据,按行存储
                        for (int j = 0; j < s.length; j++) {
        
                            Row r = s[j];// 指定行
                            Cell c[] = r.getCell();// 每行数据再按列存储
                            Map<String,String> map=new HashMap<>();
                            for (int k = 0; k < c.length; k++) {
        
                                Cell c1 = c[k];// 指定列
                                String name = c1.getName();// 明细字段名称
                                String value = c1.getValue();// 明细字段的值
                                map.put(name,value);
                            }
                            //把明细表的每一行数据都插入集合中
                            detailTable1.add(map);
                        }
                    }
                }
    
                //循环遍历明细表中的数据，将数据拼接添加到list_json1中
                for (Map<String, String> detailMap : detailTable1) {
        
                   String json_main = "   \n{\n" +
                            "   \"FMaterialId\": {\n" +     //物料编码（固定资产类别）
                            "                \"FNumber\": \"" + detailMap.get("gdzclb") + "\"\n" +
                            "     },\n" +
                            "   \"F_RCZU_NBXMH\": {\n" +     //内部项目号（从主表获取）
                            "                \"FNumber\": \"" + mainTable.get("xmh") + "\"\n" +
                            "     },\n" +
                            "   \"FEntryNote\":\"" + detailMap.get("bz") + "\",\n" +         //备注
                            "   \"FMaterialDesc\":\"" + detailMap.get("zcmc") + "\",\n" +      //物料说明 (资产名称)
                            "   \"FRemarksHWMS\": \"" + detailMap.get("sbxh") + "\",\n" +      //物料描述 （设备型号）
                            "   \"F_RCZU_Text1\": \"" + detailMap.get("syr") + "\",\n" +      //使用人
                            "   \"FArrivalDate\": \"" + detailMap.get("xqrq") + "\",\n" +      //到货日期（需求日期）
                            "   \"F_RCZU_YT\": \"" + detailMap.get("yt") + "\",\n" +        //用途
                            "   \"FReqQty\":" + detailMap.get("sl") + ",\n" +             //申请数量
                            "   \"FTAXPRICE\":\"" + detailMap.get("dj") + "\"\n" +       //含税单价
                            "   }";
                    list_json1.add(json_main);
                }
    
                String json = "{\n" +
                        "  \"IsAutoSubmitAndAudit\": \"true\",\n" +  //是否自动提交审核
                        "  \"NeedUpDateFields\": [],\n" +           //需要更新的字段
                        "  \"NeedReturnFields\": [],\n" +           //需返回结果的字段集合
                        "  \"IsDeleteEntry\": true,\n" +            //是否删除已存在的分录
                        "  \"SubSystemId\": \"\",\n" +              //表单所在的子系统内码
                        "  \"IsVerifyBaseDataField\": false,\n" +   //是否验证所有的基础资料有效性
                        "  \"IsEntryBatchFill\": true,\n" +         //是否批量填充分录
                        "  \"ValidateFlag\": true,\n" +             //是否验证数据合法性标志
                        "  \"NumberSearch\": true,\n" +             //是否用编码搜索基础资料
                        "  \"IsAutoAdjustField\": true,\n" +       //是否自动调整JSON字段顺序
                        "  \"InterationFlags\": \"\",\n" +          //交互标志集合
                        "  \"IgnoreInterationFlag\": \"\",\n" +     //是否允许忽略交互
                        "  \"IsControlPrecision\": false,\n" +      //是否控制精度
                        "  \"ValidateRepeatJson\": false,\n" +      //校验Json数据包是否重复传入
                        "   \"Model\":{\n" +
                        "       \"FApplicationOrgId\":{\n" +                   //申请组织（所属公司）
                        "           \"FNumber\":\"" + mainTable.get("szgs") + "\"\n" +
                        "       },\n" +
                        "        \"FApplicationDeptId\": {\n" +                 //ERP申请部门
                        "            \"FNumber\": \"" + mainTable.get("erpsqbm") + "\"\n" +
                        "        },\n" +
                        "       \"FApplicationDate\":\"" + mainTable.get("zdrq") + "\",\n" +  //申请日期（制单日期）
                        "        \"F_RCZU_Base\": {\n" +                //ERP使用部门
                        "            \"FNUMBER\": \"" + mainTable.get("erpsybm") + "\"\n" +
                        "        },\n" +
                        "        \"F_RCZU_mindep\": {\n" +            //ERP归口管理部门
                        "            \"FNUMBER\": \"" + mainTable.get("erpgkglbm") + "\"\n" +
                        "        },\n" +
                        "       \"F_RCZU_Combo\": \"" + mainTable.get("cslb") + "\",\n" +   //厂商类别（下拉列表）
    /*                  "        \"F_RCZU_Assistant2\": {\n" +      //在建项目
                        "            \"FNumber\": \"" + Util.null2String(properties[0].getValue()) + "\"\n" +
                        "        },\n" +*/
                        "       \"F_RCZU_ECOS1\": \"" + mainTable.get("lcbh") + "\",\n" +     //E-COS流程编号
    /*                  "        \"F_RCZU_Base1\": {\n" +           //技术负责人
                        "            \"FSTAFFNUMBER\": \"" + Util.null2String(properties[19].getValue()) + "\"\n" +
                        "        },\n" +*/
                        "       \"FBillTypeID\":{\n" +               //单据类型
                        "           \"FNumber\":\"CGSQD03_SYS\"\n" +
                        "       },\n" +
                        "       \"FNote\":\"" + mainTable.get("ytsm") + "\",\n" +        //备注（用途说明）
                        "   \"FEntity\":" + list_json1.toString()+"  \n" +     //单据体
                        "    }\n" +
                        "}";
    
                 action = actionQDT_zccgsqd.login_save(json);
    
            }
            //1：维修改造采购申请单
            else if (DocumentType==1){
        
                //定义list集合存储明细表json字符串
                List<String> list_json1 = new ArrayList<String>();
    
                //定义一个集合存储明细表的数据
                List<Map<String,String>> detailTable1=new ArrayList<>();
    
                // 获取所有明细表
                DetailTable[] detailtable = requestInfo.getDetailTableInfo().getDetailTable();
                if (detailtable.length > 0) {
        
                    //循环所有的明细表 【此单据只有一个明细表】
                    for (int i = 0; i < detailtable.length; i++) {
        
                        DetailTable dt = detailtable[i];// 指定明细表
                        Row[] s = dt.getRow();// 当前明细表的所有数据,按行存储
                        for (int j = 0; j < s.length; j++) {
        
                            Row r = s[j];// 指定行
                            Cell c[] = r.getCell();// 每行数据再按列存储
                            Map<String,String> map=new HashMap<>();
                            for (int k = 0; k < c.length; k++) {
        
                                Cell c1 = c[k];// 指定列
                                String name = c1.getName();// 明细字段名称
                                String value = c1.getValue();// 明细字段的值
                                map.put(name,value);
                            }
                            //把明细表的每一行数据都插入集合中
                            detailTable1.add(map);
                        }
                    }
                }
    
                //循环遍历明细表中的数据，将数据拼接添加到list_json1中
                for (Map<String, String> detailMap : detailTable1) {
        
                    String json_main = "   \n{\n" +
                            "   \"FMaterialId\": {\n" +     //物料编码（物料编码）（维修费/改造费）
                            "                \"FNumber\": \"" + detailMap.get("wlbm") + "\"\n" +
                            "     },\n" +
                            "   \"F_RCZU_NBXMH\": {\n" +     //内部项目号（从主表获取）
                            "                \"FNumber\": \"" + mainTable.get("xmh") + "\"\n" +
                            "     },\n" +
                            "   \"FEntryNote\":\"" + detailMap.get("bz") + "\",\n" +         //备注
    /*
                                    "   \"FMaterialDesc\":\"" + Util.null2String(c[8].getValue()) + "\",\n" +      //物料说明 (资产名称)
    */
                            "   \"FRemarksHWMS\": \"" + detailMap.get("sbxh") + "\",\n" +      //物料描述 （设备型号）
    /*                                "   \"F_RCZU_Text1\": \"" + Util.null2String(c[3].getValue()) + "\",\n" +      //使用人
                                    "   \"F_RCZU_YT\": \"" + Util.null2String(c[4].getValue()) + "\",\n" +        //用途*/
                            "   \"F_RCZU_Base2\": {\n" +            //卡片编码(资产编码)
                            "                    \"FNUMBER\": \"" + detailMap.get("zcbm") + "\"\n" +
                            "                },\n"+
                            "   \"FReqQty\":" + detailMap.get("sl") + ",\n" +             //申请数量
                            "   \"FArrivalDate\": \"" + detailMap.get("xqrq") + "\",\n" +      //到货日期（需求日期）
                            "   \"FTAXPRICE\":\"" + detailMap.get("dj") + "\"\n" +       //含税单价（预估单价）
                            "   }";
                    list_json1.add(json_main);
                }
    
                String json = "{\n" +
                        "  \"IsAutoSubmitAndAudit\": \"true\",\n" +  //是否自动提交审核
                        "  \"NeedUpDateFields\": [],\n" +           //需要更新的字段
                        "  \"NeedReturnFields\": [],\n" +           //需返回结果的字段集合
                        "  \"IsDeleteEntry\": true,\n" +            //是否删除已存在的分录
                        "  \"SubSystemId\": \"\",\n" +              //表单所在的子系统内码
                        "  \"IsVerifyBaseDataField\": false,\n" +   //是否验证所有的基础资料有效性
                        "  \"IsEntryBatchFill\": true,\n" +         //是否批量填充分录
                        "  \"ValidateFlag\": true,\n" +             //是否验证数据合法性标志
                        "  \"NumberSearch\": true,\n" +             //是否用编码搜索基础资料
                        "  \"IsAutoAdjustField\": true,\n" +       //是否自动调整JSON字段顺序
                        "  \"InterationFlags\": \"\",\n" +          //交互标志集合
                        "  \"IgnoreInterationFlag\": \"\",\n" +     //是否允许忽略交互
                        "  \"IsControlPrecision\": false,\n" +      //是否控制精度
                        "  \"ValidateRepeatJson\": false,\n" +      //校验Json数据包是否重复传入
                        "   \"Model\":{\n" +
                        "       \"FApplicationOrgId\":{\n" +                   //申请组织（所属公司）
                        "           \"FNumber\":\"" + mainTable.get("szgs") + "\"\n" +
                        "       },\n" +
                        "        \"FApplicationDeptId\": {\n" +                 //ERP申请部门
                        "            \"FNumber\": \"" + mainTable.get("erpsqbm") + "\"\n" +
                        "        },\n" +
                        "       \"FApplicationDate\":\"" + mainTable.get("zdrq") + "\",\n" +  //申请日期（制单日期）
                        "        \"F_RCZU_Base\": {\n" +                //ERP使用部门
                        "            \"FNUMBER\": \"" + mainTable.get("erpsybm") + "\"\n" +
                        "        },\n" +
    /*                    "        \"FApplicantId\": {\n" +                //申请人
                        "            \"FNUMBER\": \"" + mainTable.get("") + "\"\n" +
                        "        },\n" +*/
                        "        \"F_RCZU_mindep\": {\n" +            //ERP归口管理部门
                        "            \"FNUMBER\": \"" + mainTable.get("erpgkglbm") + "\"\n" +
                        "        },\n" +
    /*                    "       \"F_RCZU_Combo\": \"" + mainTable.get("") + "\",\n" +   //厂商类别（下拉列表）
                        "        \"F_RCZU_Assistant2\": {\n" +      //在建项目
                        "            \"FNumber\": \"" + mainTable.get("") + "\"\n" +
                        "        },\n" +*/
                        "       \"F_RCZU_ECOS1\": \"" + mainTable.get("lcbh") + "\",\n" +     //E-COS流程编号
    /*                    "        \"F_RCZU_Base1\": {\n" +           //技术负责人
                        "            \"FSTAFFNUMBER\": \"" + mainTable.get("") + "\"\n" +
                        "        },\n" +*/
                        "       \"FBillTypeID\":{\n" +               //单据类型
                        "           \"FNumber\":\"CGSQD07_SYS\"\n" +
                        "       },\n" +
                        "       \"FNote\":\"" + mainTable.get("ytsm") + "\",\n" +        //备注（用途说明）
                        "   \"FEntity\":\n" +                //单据体
                                        list_json1.toString() +
                        "       \n" +
                        "    }\n" +
                        "}";
    
                    action = actionQDT_zccgsqd.login_save(json);
            }
    
            return action;
    
        }
    
        public String login_save(String json){
        
            //设置初始值默认同步成功
            String action;
            // 日志
            Log log = LogFactory.getLog(this.getClass());
    
            //解析json字符串
            Gson gson = new Gson();
    
            // 调用ERP接口
            String resultJson = "";
            //初始值登录失败
            Boolean loginResult = false;
            //拆分后生产环境
            K3CloudApiClient client = new K3CloudApiClient("http://xx.xxx.xx.xx:x/k3cloud/");
            try {
        
                loginResult = client.login("6xxxxxxxd", "账号", "密码", 2052);
                // 判断登录成功就调用ERP相应方法
                if (loginResult) {
        
                    //调用保存的方法  保存 付款申请单
                    // 具体参数和调用方法参见  https://openapi.open.kingdee.com/ApiCenterDoc
                    resultJson = client.save("PUR_Requisition", json);
    
                    //解析金蝶调用接口后返回的json数据
                    HashMap<String,Object> map = gson.fromJson(resultJson, HashMap.class);
                    LinkedHashMap<String,Object> sec= gson.fromJson(map.get("Result").toString(),LinkedHashMap.class) ;
                    LinkedHashMap<String,Object> thr=gson.fromJson(sec.get("ResponseStatus").toString(),LinkedHashMap.class) ;
                    Boolean isSuccess = (Boolean) thr.get("IsSuccess");
    
                    //对返回结果进行解析和校验
                    if (isSuccess) {
        
                        log.info("QDP采购申请单同步结果: 同步成功"+resultJson);
                        action = SUCCESS;
                    } else {
        
                        log.info("QDP采购申请单同步结果: 同步失败"+resultJson);
                        log.info("QDP采购申请单json数据："+json);
                        action = FAILURE_AND_CONTINUE;
                    }
    
                } else {
        
                    log.info("QDP采购申请单登录失败"+loginResult);
                    action = FAILURE_AND_CONTINUE;
                }
    
            } catch (Exception e) {
        
                action = FAILURE_AND_CONTINUE;
                log.info("QDP采购申请单同步结果: 同步失败"+resultJson);
                log.info("QDP采购申请单json数据："+json);
                log.info("错误信息:" + e);
                e.printStackTrace();
            }
            return action;
        }
    
    
    }

#### 3.ERP对接 ####

云星空文档： [金蝶API文档][API]  
或者登录管理员账号，搜索WebAPI；

3.1引入 K3CloudApiClient 包;  
3.2实例化 client;  
3.3执行登录动作;  
3.4判断登录经过为 true , 执行余下动作;

Demo
    
    // 查看
    client.View("BD_Account","{"CreateOrgId":0,"Number":"","Id":""}");
    
    // 保存
    client.Save("BD_Account","{"NeedUpDateFields":[],"NeedReturnFields")
    
    // 审核 
    client.ExcuteOperation("BD_Account","Forbid","{"CreateOrgId":0,"Numbers":[],"Ids":"","PkEntryIds":[],"NetworkCtrl":""}");
    
    // 反审
    client.UnAudit("BD_Account","{"CreateOrgId":0,"Numbers":[],"Ids":"","InterationFlags":"","NetworkCtrl":"","IsVerifyProcInst":""}");
    
    ... 
    更多执行参见 金蝶云星空官方文档  https://openapi.open.kingdee.com/ApiCenterDoc
    或者登录管理员账号，搜索WebAPI

--------------------

## 总结 ##

以上就是泛微E9对接金蝶云星空的方法，同步表单，注意如果同步多张表单到金蝶ERP中，注意ERP中的表单关联关系。

[ecology]: https://e-cloudstore.com/doc.html?appId=c6a9ae6e47b74d4da04c935ed51d177a&maxImgWidth=800#ecology%E5%90%8E%E7%AB%AF%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA
[45d65c18a887455b9b354e4b239fa7d7.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/c79482b7d69e479ea080425a12d1133b.png
[java]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/87d5dd4eb5cb4354bee7db83854e0f5f.png
[3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/6e9acd250e994e8e813cad58f1fa9fe2.png
[460dff84ffb643f9a49eb6369c645d8d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e6b4a77cf0ef40319eba7cbc05254d8a.png
[2.1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/38f42c98809d4032855441926c4d4ac6.png
[2.2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/39e66d6430a7470b9fe1936caf8d46d8.png
[2.3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/77cf75918f7a42d58a6a2ddc3f80e94f.png
[f4bfee2ebd2e49299147b9d90a4299d5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/03ec0fecd1534aecb3664902615eec6e.png
[3.2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/4afb6384d9f2435a94ac520293685127.png
[73e84b268ab944ffaf91926db7d14f1b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/b2b32414250a48c2af4890177746b986.png
[dcb9c78413c2468b8fc1fc4f989b0790.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/7be87cc6314a42a6a7456fc5a464e97e.png
[4.1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/56c78755aea349b1b48e5cfa1c809bc2.png
[4.2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/635fed1f6d284e2a95c25ae90fef59a9.png
[5.1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/d3f868f75ec94639961feb16b41a5214.png
[5.2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/993f0cbcc55c4dcdbbd597f3931222c2.png
[5.3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/88b244637051452b80df8efc7e9297d5.png
[70229434382b4450a9a316f5c584e08d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/0b4dbe4294fa4f49bd4ed8ec197c5350.png
[5.5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/efb1d9f421254a5ca97aefc9199234a8.png
[5.6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/7aa2c550147842b6a11c783f7bffd57c.png
[5.7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/b01b868b3bf84bf5a8f33536838c3098.png
[5.8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/85c45dbc38f0435bb1d08737c5d0a668.png
[6.1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/64cc12c54a9b4ee99b8e77df6ae634b2.png
[6.2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/691dba9cbb9840c9900db2cb68a7b232.png
[6.3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/4a26dbbf2f054fbe8d6fb537bdcf5246.png
[6.4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/1583ce9691094e40b70573ea1303deff.png
[6.5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/ce55417b795e41c6bd0b172a0d568237.png
[6.6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/3d6bd0a9f32d4fa49fc876321ec4046f.png
[6.7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/7c3a9cfd6f314084af0b16dc7ea1198b.png
[6.8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/aee5eb30ca8a42dfbf62b8e8a0a06322.png
[6.9]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/6457314cac844d558fd27c22177a5ced.png
[6.10]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/8e8f25f1e7c941b2a369b149a18db96a.png
[68521620dbac4db9b77201f19e67a3c2.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/5bf3305f6ec54cf08ccd53b239f49f35.png
[a6759ad5975a4b31a43b1132226c3fd4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/b814cef9361d4984bfeb6e823221983a.png
[2a69b91bfc754abb899901db2573a758.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/016c6497c81a465ca7483136d761423e.png
[API]: https://openapi.open.kingdee.com/ApiDoc