金蝶EAS_V8.5_OpenApi用户手册金蝶EASV8.5异构系统预算控制API金蝶软件（中国）有限公司2021年08月金蝶软件（中国）有限公司iOpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound1概述本章介绍Api配置系统相关的运行环境以及接口配置的总体操作流程，并介绍Api系统应用过程中所涉及到的一些基本概念。运行环境介绍Api的调用依赖于业务数据。在进行流程配置之前，需要了解并准备好相关的环境和数据。 EAS系统环境EAS系统是流程的运行、监控和管理平台，同时，它为流程运行提供所需要的业务数据。操作前，请确保完成EAS系统的安装。EAS系统提供客户端访问和Web访问的两种方式。通过客户端访问EAS系统需要安装配套版本的EAS客户端。目前Api配置系统只支持Web端访问。 业务数据Api依赖于具体的业务数据，包括异构系统的数据库连接和单据的数据库表名，还有一些表字段映射和基础信息映射的配置操作流程介绍异构系统预算控制的应用主要包含数据连接配置、单据表配置、基础数据映射配置、单据注册和制作控制策略以及接口调用六个过程。其中API就是接口调用这一过程。接口调用在方案的停用阶段可以进行方案/方法的配置编辑。在方案/方法配置完之后，要将该方案启用才可以调用该方案下面的接口。http调用方式登录：http://127.0.0.1:6888/easportal/openapi/login?金蝶软件（中国）有限公司1OpenApi用户手册Error:ReferencesourcenotfoundError:ReferencesourcenotfoundauthPattern=BaseDB&dcName=EAS850BETA3&isEncodePwd=0&language=l2&password=&user=zqtest返回格式：{"data":{"token":"qZbT9PATjqwuINItQwIZxCSYjesmiDtSYVIPuvV3LzPty2feKpVeFdJrcRnUS9iL"},"errCode":0,"errMsg":"执行成功"}username:用户password:密码dcName:数据中心代码language:语言isEncodePwd:默认为0authPattern:验证方式默认"BaseDB";其他认证方式KEY可从easAuthPatterns.xml中获取。如BaseTrdLtpaToken可动态切上下文errCode为0代表执行成功，其他为失败调用：http://127.0.0.1:6888/easportal/openapi/api?token=？请求body两种方式一、{"api":"BgControlIsomerFacade-bgControlHandle","data":[{"dataJson":{"billNumber":"qMjYlF1KSpeLW+XQvcqYxEpE9J8=","tableNumber":"T_BC_BIZACCOUNTBILL","connectNubmer":"EAS85"}},{"type":"2"}]}二、{"api":"BgControlIsomerFacade-bgControlHandle","data":[{"dataJson":{"billNumber":"qMjYlF1KSpeLW+XQvcqYxEpE9J8=","tableNumber":"T_BC_BIZACCOUNTBILL",金蝶软件（中国）有限公司2OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound"connectInfo":{"IP":"172.17.7.90","port":"1521","instance":"orcl","userName":"ORA0702TST"}}},{"type":"2"}]}api：固定格式（是eas封装好的openapi（需要配置）的编码，以sql的形式生成好）billNumber:单据的主键信息（跟EAS异构单据配置对应）例如：id，number等tableNumber:单据的数据库表connectNumber:EAS集成系统的编码（直接传配置好）type：预算控制类型0.预算扣减1.预算返还2.预算余额查看3.强制扣减connectionInfo:数据库链接信息（根据这些信息去找EAS集成系统的编码）IP:数据库ip地址port：端口号instance：数据库实例名username：用户名返回结果预算查询{"errCode":0,"errMsg":"执行成功","errStackTrace":null,"data":"{"taskId":null,"result":[{"bgElement":"金额","balance":78,金蝶软件（中国）有限公司3OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound"apply":22,"budget":100,"acScenario":"实际数","bgScenario":"预算数","scheme":"GGG","bgPeriodType":"年+半年+季+月","actual":22,"type":"当期控制","orgUnit":"宁晋基地财务部","bgPeriod":"2021年01月"}]}","description":null,"description_cn":null}errCode为0代表执行成功，其他为失败errMsg:要么是异常要么是执行成功result:执行成功返回的结果集数组为预算查看结果集预算扣减{"errCode":0,"errMsg":"执行成功","errStackTrace":null,"data":"{"taskId":null,"result":[{"cause":"原因。。。"}]}","description":null,"description_cn":null}预算返还{"errCode":0,"errMsg":"执行成功","errStackTrace":null,"data":"{"taskId":null,"result":[{"cause":"原因。。。"}]}","description":null,"description_cn":null金蝶软件（中国）有限公司4OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound}程序内调用方式LoginContextloginCtx=OpenApiContextFactory.createHttpContext("127.0.0.1",6888,"登入用户","用户密码","数据库名","l2");OpenApiInfoinfo=newOpenApiInfo();info.setApi("BgControlIsomerFacade-bgControlHandle");info.setData("json格式的参数”);OpenApiopenApi=OpenApiFactory.getService(loginCtx);Stringresult=openApi.invoke(info);System.out.println("----------result:"+result);金蝶软件（中国）有限公司5OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound第三方依赖包：openapi-server.jar或sp-openapi-server.jarlog4j-1.2.15.jarfastjson-1.2.58.jar获取方式\eas\server\lib\common\trd\eas\server\lib\server\bos\openapi-server.jar或eas\server\lib\patch\sp-openapi-server.jar（只需要一个）ps：1.高版本可反编译查看com.kingdee.bos.openapi.third.login.Example2.如果调用过程中出现404报错，有可能是调用的访问路径不在白名单之中，被拦截，禁用掉白名单的配置即可，配置文件的路径为：apusic/domains/server*/config/web.xml。具体如下图金蝶软件（中国）有限公司6OpenApi用户手册Error:ReferencesourcenotfoundError:ReferencesourcenotfoundEAS预算外部控制接口设置接口配置1.运用外部接口首先要在这里做相应的配置金蝶软件（中国）有限公司7OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound单据配置金蝶软件（中国）有限公司8OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound数据连接金蝶软件（中国）有限公司9OpenApi用户手册Error:ReferencesourcenotfoundError:Referencesourcenotfound单据注册金蝶软件（中国）有限公司10
