《EKP_for_SAP中间件接口手册_V2》由会员分享,可在线阅读,更多相关《EKP_for_SAP中间件接口手册_V2(18页珍藏版)》请在金锄头文库上搜索。
1、EKP for SAP 中间件 接口手册接口手册版权声明:版权声明: Copyright, All Rights Reserved by Landray, 2012 年 3 月未经蓝凌软件股份有限公司书面许可,本白皮书任何部分的内容不得被复制或抄袭用于任何目的。本白皮书并不意味着蓝凌软件股份有限公司提供的任何产品或服务或其功能与本白皮书描述的内容完全一致。本白皮书的内容可能在未经通知的情形下进行修改。文档控制文档控制/Document/Document ControlControl修改记录修改记录日期日期作者作者版本版本备注备注2011-10-25吴奇川V1.0初稿2012-03-14吴奇川V
2、2.0根据二期项目修改审阅记录审阅记录日期日期审阅人审阅人版本版本备注备注2011-12-23林殿兴V1目目 录录第一章第一章说明说明.1第二章第二章APIAPI 接口介绍接口介绍.22.1中间件基本 API 框架介绍.2 2.2API 说明.3 2.2.1ISapJcoFunctionUtil .3 2.2.2ISapJcoLogUtil.3 2.3XML 模版.4第三章第三章扩展函数扩展函数.83.1JS 扩展函数.8 3.2公式定义器扩展函数.9 3.3JSON 模版.12蓝凌软件股份有限公司 1蓝凌工程文档蓝凌工程文档第 1 章 说明说明本手册主要指导如何调用 EKP for SAP
3、中间件接口,完成相关业务功能。蓝凌软件股份有限公司 2蓝凌工程文档蓝凌工程文档第 2 章 APIAPI 接口介绍接口介绍2.1 中间件基本中间件基本 API 框架介绍框架介绍如图,SAP 中间件 JAVA-API 主要分为两部分:函数接口和日志接口。ISapJcoFunctionUtilgetJson4WebServicegetFunctionByIdgetFunctionFromFuncgetFunctionToXmlByIdgetFunctionToXmlByRfcgetFunctionToXmlByNamegetXMltoFunctiongetJsonToJsonconvertXMLto
4、FunctiongetJsonToXmlgetFunctionToXmlgetFunctionDateToXmlgetXmlToJsongetFunctionByNameAndPoolgetJCoDestinationByNameISapJcoLogUtilsaveJcoLogsaveJcoLogBusinesssetSapJcoLoggetFunctionId蓝凌软件股份有限公司 3蓝凌工程文档蓝凌工程文档2.2 API 说明说明 2.2.1 ISapJcoFunctionUtil接口名称接口名称传入传入传出传出getFunctionByNameAndPoolName:函数名称 poolId
5、:连接池 IDJCoFunction getJson4WebServiceRFCName:在 ekp 集成平 台配置的 webservice 名字 Json:参考 3.3JSON 模板SapReturnVo:返回数据类型 和数据getFunctionByIdId:函数的 fd_idJCoFunctiongetFunctionFromFunc (供定时任务使用)jcoFunction:JCO 函数对象 funcId:函数的 fd_idJCoFunctiongetFunctionToXmlByIdId:函数的 fd_idObject:函数模板的 xml,参 考 2.3XML 函数模板getFunc
6、tionToXmlByRfcName:配置函数名称Object:函数模板的 xml,参 考 2.3XML 函数模板getFunctionToXmlByNameName:BAPI 名称 poolId:连接池名称Object:函数模板的 xml,参 考 2.3XML 函数模板getXMltoFunctionObject:传入参数函数模板 的 xml,参考 2.3XML 函数 模板SapReturnVo:返回数据类型 和数据getXMltoFunctionObject:传入参数函数模板 的 xml,参考 2.3XML 函数 模板 I:table 返回条数为 iSapReturnVo:返回数据类型 和
7、数据getJsonToJsonRfc: 配置函数名称 Json:参考 3.3JSON 模板SapReturnVo:返回数据类型 和数据getJCoDestinationByNamepoolName:连接池名称JCoDestination2.2.2 ISapJcoLogUtil接口名称接口名称传入传入传出传出saveJcoLogStart:开始时间 isErr:若为 0:1 时,直接赋值,否则根据 message 是否为空来 判断(0:成功;1 失败) message:日志信息:为空表示正常日志 in:输入 XML 或 JSON out:输出 XML fdFunctionId:函数 fd_id;
8、可为空,则系统自动根据 in 参数 取 fdFunctionIdVoid蓝凌软件股份有限公司 4蓝凌工程文档蓝凌工程文档saveJcoLogStart:开始时间 isErr:若为 0:1 时,直接赋值,否则根据 message 是否为空来 判断(0:成功;1 失败) message:日志信息:为空表示正常日志 in:输入 XML 或 JSON out:输出 XML fdFunctionName:函数名称 fdPoolName:连接池名称VoidsaveJcoLogBusinessStart:开始时间 message:日志信息:为空表示正常日志 in:输入 XML 或 JSON out:输出 X
9、ML fdFunctionId:函数 fd_id;可为空,则系统自动根据 in 参数 取 fdFunctionIdVoidsaveJcoLogBusinessStart:开始时间 message:日志信息:为空表示正常日志 in:输入 XML 或 JSON out:输出 XML fdFunctionName:函数名称 fdPoolName:连接池名称Void2.3 XML 模版模版参考文档:EKP_for_SAP 中间件数据传递模板_V1.doc2011-05-019999-12-31ABC0000-00-000000-00-00000000000000-00-0000000-00-00000
10、0-00-00000000000000-00-000蓝凌软件股份有限公司 6蓝凌工程文档蓝凌工程文档0000-00-00 0000-00-0000000000蓝凌软件股份有限公司 7蓝凌工程文档蓝凌工程文档0000-00-0000000-00-000000-00-00000000000000-00-000蓝凌软件股份有限公司 8蓝凌工程文档蓝凌工程文档第 3 章 扩展函数扩展函数3.1 JS 扩展函数扩展函数接口名称接口名称传入参数传入参数传出参数传出参数ESAP_RFCBAPI_NAME:RFC 管理中 配置的函数名称 BAPI_CONTENT:BAPI 内 容,将字段、表、结构以 JSON
11、 方式封装到一起传入。RFC_ISSUCCESS:返回是否 成功标识:1 成功,0 失败 RFC_RETURN:函数返回内 容,若成功,将字段、表、 结构以 JSON 方式封装到一起 返回;若失败,则返回错误 信息。实例: 根据填写的员工编号,获取员工相关信息。 新建模板Jsp 片段代码:/middleware/ekp/ekpFormJs.js“/引入 js 扩展函数function getPersonInfo() 蓝凌软件股份有限公司 9蓝凌工程文档蓝凌工程文档var start=GetXFormFieldValueById(“fd_IP_BEGDA“); var end =GetXFormFieldValueById(