YonBIPV3.0(R6_2407_1)旗舰版云平台-三方集成资产-BIP和SAPECC费控集成资产实施指南用友网络科技股份有限公司2024年9月用户手册1/54版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/54目录第一章概述.............................................................................................................................................................51.1业务场景...................................................................................................................................................51.1.1正向数据同步（YonBIP→SAP）..........................................................................................51.2关键词.......................................................................................................................................................5第二章集成环境初始化......................................................................................................................................62.1仓库初始化..............................................................................................................................................62.2连接器导入..............................................................................................................................................6第三章集成资产包导入与配置.........................................................................................................................93.1集成应用导入..........................................................................................................................................93.2YonBIP旗舰版API授权......................................................................................................................93.3YonBIP旗舰版连接器连接配置创建.............................................................................................103.4SAP-ECC连接器连接配置创建.......................................................................................................123.5集成应用连接配置绑定.....................................................................................................................24第四章集成方案配置说明................................................................................................................................254.1个人借款单............................................................................................................................................254.1.1BIP个人借款单实时同步SAPECC凭证...........................................................................254.2对公预付单............................................................................................................................................264.2.1BIP对公预付单实时同步SAPECC凭证...........................................................................26第五章数据同步任务配置说明.......................................................................................................................285.1立即执行.................................................................................................................................................28用户手册3/545.2定时执行.................................................................................................................................................285.3停止..........................................................................................................................................................30第六章SAP-ECC操作配置说明......................................................................................................................316.1操作配置整体模型结构.....................................................................................................................326.2fieldMappings模型结构....................................................................................................................336.3queryMappings模型结构.................................................................................................................346.4outputMappings模型结构...............................................................................................................356.5rules模型结构......................................................................................................................................396.6操作配置示例........................................................................................................................................40第七章混合云网关配置....................................................................................................................................457.1新建网关.................................................................................................................................................457.2下载网关客户端...................................................................................................................................457.3下载网关密钥........................................................................................................................................467.4启动本地网关客户端..........................................................................................................................477.5验证网关是否启动成功.....................................................................................................................477.6使用混合云网关...................................................................................................................................48第八章注意事项..................................................................................................................................................488.1关于常量、默认值、直接映射使用说明......................................................................................488.2其它..........................................................................................................................................................49第九章常见问题..................................................................................................................................................499.1新建连接配置找不到连接器怎么办？..........................................................................................49用户手册4/549.2集成连接器导入时，缺jar包..........................................................................................................509.3集成方案执行报连接配置错误........................................................................................................509.4集成方案执行API授权错误.............................................................................................................529.5同步任务执行报没检索到可执行函数..........................................................................................52用户手册5/54第一章概述1.1业务场景本文档描述了SAP和YonBIP费控业务的集成场景。通过SAP和YonBIP集成资产包的实施可以快速实现YonBIP与SAP系统之间费控业务的集成，帮助项目快速完成项目交付，降低和SAP的集成难度、成本。1.1.1正向数据同步（YonBIP→SAP）数据集成说明个人借款单BIP个人借款单新增后实时同步生成SAP凭证对公预付单BIP对公预付单新增后实时同步生成SAP凭证1.2关键词费控、SAP-ECC连接器、费控集成资产、SAP-ECC费控集成资产包、BIP和SAPECC费控集成资产用户手册6/54第二章集成环境初始化注意：私有云环境必须先执行此章节操作，公有云环境无须执行。2.1仓库初始化1.下载图中标红的所有仓库文件：https://pan.yonyou.com/s/yOpbN2jWRSw2.在用友YonBIP系统中的云平台>连接集成服务>集成实施工具>连接管理>连接配置界面，点击右上角“更新仓库”按钮选择从云盘中下载的所有repository.tar.gz仓库文件进行上传，文件导入较慢，需要等待一段时间。2.2连接器导入1.从集成资产包目录中下载对应的所有连接器包文件用户手册7/542.在用友YonBIP系统中的云平台>连接集成服务>集成实施工具>连接管理>连接配置界面，点击右上角“导入”按钮选择具体的业务连接器zip文件进行上传，文件导入较慢，需要等待一段时间。示例如下，下载的所有连接器zip文件都要进行导入。注意：每次连接器导入完成之后都要重启一下混合云数据集成服务用户手册8/54用户手册9/54第三章集成资产包导入与配置3.1集成应用导入注意：请先联系集成资产开发部相关老师获取集成应用包。在用友YonBIP系统中的云平台>连接集成服务>数据集成>集成设计>集成方案设计界面，将取得的集成应用包在该界面右上角点击“导入”按钮，完成集成应用的导入新建工作。3.2YonBIP旗舰版API授权1.进入“API调用”节点，点击“添加”按钮2.输入“授权KEY描述”，点击确定用户手册10/543.点击“API授权”4.点击“新增API”，选择“开放API”，进行相关接口的授权需要授权接口如下：接口名称接口地址3.3YonBIP旗舰版连接器连接配置创建集成应用导入成功之后，需要进行连接配置后才能使用，操作步骤如下：1.在用友YonBIP系统中的云平台>连接集成服务>集成实施工具>连接管理>连接配置界面，点击“新建连接”按钮。用户手册11/542.选择对应的连接器3.填写基本配置信息，appkey、appsecret使用上面创建授权配置获取的appkey、appsecret。4.填写完毕后点击测试连接用户手册12/545.提示测试连接成功即可。3.4SAP-ECC连接器连接配置创建在用友YonBIP系统中的云平台>连接集成服务>集成实施工具>连接管理>连接配置界面，点击新建连接按钮>选择对应的连接器>填写基本配置信息>确认>测试连接，提示测试连接成功即可。具体创建步骤可参照BIP连接配置创建。用户手册13/54具体属性说明：sap地址SAP系统域名地址连接方式目前支持SAP、PO、ESB连接协议目前支持REST、SOAPESB类型目前支持YonBIP旗舰版开放平台、YonBIP旗舰版YSBappKey当ESB类型为YonBIP旗舰版开放平台的时候需要配置此项appSecret当ESB类型为YonBIP旗舰版开放平台的时候需要配置此项是否鉴权选项可选true、false鉴权方式目前支持basic、token，当是否鉴权选择是的时候需要配置此项用户名当是否鉴权选择是的时候需要配置此项密码当是否鉴权选择是的时候需要配置此项用户手册14/54操作配置操作的具体配置，主要包括接口路径、集成对象字段映射、映射规则、查询条件字段配置、操作输出结构配置，具体请参考操作配置说明注意：连接配置信息录入完成以后，一定要点击一下“测试连接”按钮，这样可以提前校验出错误的配置信息，尤其是操作配置属性。费控操作配置JSON数据如下：```[{"operationName":"batchSaveVoucher","requestMethod":"POST","url":"/walsin/SAP/sap/rfcproxy","loopSave":true,"fieldMappings":[{"tFieldCode":"fName","sFieldCode":"fName","defaultValue":"Z_FI_RDOWNPAYMENTCREATE_03"},{"tFieldCode":"data.DOHEADER.BLDAT","sFieldCode":"BLDAT","exception":0},{"tFieldCode":"data.DOHEADER.BUDAT","sFieldCode":"BUDAT","exception":0},{"tFieldCode":"data.DOHEADER.BLART",用户手册15/54"sFieldCode":"BLART","exception":0},{"tFieldCode":"data.DOHEADER.BUKRS","sFieldCode":"BUKRS","exception":0},{"tFieldCode":"data.DOHEADER.WAERS","sFieldCode":"WAERS","exception":0},{"tFieldCode":"data.DOHEADER.XBLNR","sFieldCode":"XBLNR","exception":0},{"tFieldCode":"data.DOHEADER.BKTXT","sFieldCode":"BKTXT","exception":0},{"tFieldCode":"data.ITEM47[].NEWKO","sFieldCode":"bodyItems[].LIFNR","exception":0},{用户手册16/54"tFieldCode":"data.ITEM47[].NAME1","sFieldCode":"bodyItems[].NAME1","exception":0},{"tFieldCode":"data.ITEM47[].BSCHL","sFieldCode":"bodyItems[].BSCHL","exception":0},{"tFieldCode":"data.ITEM47[].UMSKZ","sFieldCode":"bodyItems[].UMSKZ","exception":0},{"tFieldCode":"data.ITEM47[].DMBTR","sFieldCode":"bodyItems[].DMBTR","exception":0},{"tFieldCode":"data.ITEM47[].WRBTR","sFieldCode":"bodyItems[].WRBTR","exception":0},{"tFieldCode":"data.ITEM47[].MWSKZ","sFieldCode":"bodyItems[].MWSKZ","exception":0},用户手册17/54{"tFieldCode":"data.ITEM47[].ZTERM","sFieldCode":"bodyItems[].ZTERM","exception":0},{"tFieldCode":"data.ITEM47[].ZFBDT","sFieldCode":"bodyItems[].ZFBDT","exception":0},{"tFieldCode":"data.ITEM47[].KOSTL","sFieldCode":"bodyItems[].KOSTL","exception":0},{"tFieldCode":"data.ITEM47[].ZUONR","sFieldCode":"bodyItems[].ZUONR","exception":0},{"tFieldCode":"data.ITEM47[].ZLSCH","sFieldCode":"bodyItems[].ZLSCH","exception":0},{"tFieldCode":"data.ITEM47[].GENDER","sFieldCode":"bodyItems[].GENDER","exception":0用户手册18/54},{"tFieldCode":"data.ITEM47[].SGTXT","sFieldCode":"bodyItems[].SGTXT","exception":0},{"tFieldCode":"data.ITEM47[].BANKS","sFieldCode":"bodyItems[].BANKS","exception":0},{"tFieldCode":"data.ITEM47[].BANKL","sFieldCode":"bodyItems[].BANKL","exception":0},{"tFieldCode":"data.ITEM47[].BANKN","sFieldCode":"bodyItems[].BANKN","exception":0},{"tFieldCode":"data.ITEM47[].DOTYPE","sFieldCode":"bodyItems[].DOTYPE","exception":0},{"tFieldCode":"data.ITEM47[].HDDID","sFieldCode":"bodyItems[].HDDID",用户手册19/54"exception":0},{"tFieldCode":"data.ITEM47[].ESRRE","sFieldCode":"bodyItems[].ESRRE","exception":0}],"outputMappings":[{"tFieldCode":"code","sFieldCode":"data.RETURN[].NUMBER","exception":0},{"tFieldCode":"successCodeValue","sFieldCode":"","defaultValue":"605"},{"tFieldCode":"message","sFieldCode":"data.RETURN.MESSAGE","exception":0},{"tFieldCode":"data.targetUnique","sFieldCode":"data.RETURN.ID","exception":0},{用户手册20/54"tFieldCode":"data.sourceUnique","sFieldCode":"data.OT_DODATA[].XBLNR","exception":0},{"tFieldCode":"data.retObj","sFieldCode":"data.OT_DODATA","exception":0}],"fieldRules":[{"tFieldCode":"data.ITEM47[].SGTXT","rules":[{"ruleName":"fieldJoin","ruleStruct":{"symbol":"","fields":["BKTXT"],"isPlaceholder":false}}]}],"outputRules":[]},{"operationName":"listVoucherStatus","requestMethod":"POST","url":"/walsin/SAP/sap/rfcproxy","queryMappings":[{"tFieldCode":"fName","sFieldCode":"param1",用户手册21/54"exception":0},{"tFieldCode":"data.I_DOTYPE","sFieldCode":"param2","exception":0},{"tFieldCode":"data.I_NUM","sFieldCode":"param3","exception":0},{"tFieldCode":"data.I_AUGDT_S","sFieldCode":"beginDateTime","exception":0},{"tFieldCode":"data.I_AUGDT_E","sFieldCode":"endDateTime","exception":0}],"fieldMappings":[],"outputMappings":[{"tFieldCode":"code","sFieldCode":"code","exception":0},{"tFieldCode":"successCodeValue","sFieldCode":"","defaultValue":200},用户手册22/54{"tFieldCode":"data.record","sFieldCode":"data.OT_DODATA"},{"tFieldCode":"message","sFieldCode":"data.message","exception":0}],"fieldRules":[]},{"operationName":"batchUpdateVoucherStatus","requestMethod":"POST","url":"/walsin/SAP/sap/rfcproxy","loopSave":true,"fieldMappings":[{"tFieldCode":"fName","sFieldCode":"fName","defaultValue":"Z_FI_ACC_DOCUMENT_READSTATUS03"},{"tFieldCode":"data.I_BUKRS","sFieldCode":"I_BUKRS","exception":0},{"tFieldCode":"data.I_STATUS","sFieldCode":"I_STATUS","exception":0},{用户手册23/54"tFieldCode":"data.I_HDDID","sFieldCode":"I_HDDID","exception":0},{"tFieldCode":"data.I_DOTYPE","sFieldCode":"I_DOTYPE","exception":0},{"tFieldCode":"data.I_XBLNR","sFieldCode":"I_XBLNR","exception":0}],"outputMappings":[{"tFieldCode":"code","sFieldCode":"data.E_RSTATUS","exception":0},{"tFieldCode":"successCodeValue","sFieldCode":"","defaultValue":"Y"},{"tFieldCode":"message","sFieldCode":"data.RETURN.MESSAGE","exception":0}],"fieldRules":[],用户手册24/54"outputRules":[]}]```3.5集成应用连接配置绑定来源系统和目标系统连接配置创建完成之后，点击集成应用的编辑按钮，将刚创建的连接配置选择上，进行保存即可。用户手册25/54第四章集成方案配置说明4.1个人借款单4.1.1BIP个人借款单实时同步SAPECC凭证⚫方案编码：bip_loanbill_sapecc_voucher_em_sync_call⚫集成场景：BIP个人借款单新增后实时同步生成SAP凭证下列映射关系中涉及到的日期格式转换、默认值、常量转换需要确认是否与项目一致用户手册26/54注意：借款信息与结算信息是两个子表，同时同步到SAP的一个子表上，如果借款信息与结算信息子表个数不一致就会出现问题，所以该集成方案在调用之前要求项目上把两个子表个数维护成一致。4.2对公预付单4.2.1BIP对公预付单实时同步SAPECC凭证⚫方案编码：bip_pubprepaybill_sapecc_voucher_em_sync_call⚫集成场景：BIP对公预付单审核通过后实时同步生成SAP凭证下列映射关系中涉及到的日期格式转换、默认值、常量转换需要确认是否与项目一致用户手册27/54注意：预付信息与结算信息是两个子表，同时同步到SAP的一个子表上，如果预付信息与结算信息子表个数不一致就会出现问题，所以该集成方案在调用之前要求项目上把两个子表个数维护成一致。用户手册28/54第五章数据同步任务配置说明集成方案生成的所有任务都将会在数据同步任务中进行管理，数据同步任务目录为云平台>连接集成服务>数据集成>集成任务>数据同步任务。集成方案分为定时任务和实时推送两种方式，实时推送方式的集成方案可以通过开放平台中的“数据同步任务-推送数据”接口进行调用，定时任务的集成方案可以通过立即执行和定时执行进行调用。5.1立即执行在数据同步任务列表上点击【立即执行】按钮，会弹出一个对话框，询问是否强制推送、是否根据时间段补录、是否根据增量时间戳进行查询来源系统数据。⚫强制推送：开启则会无视目标数据是否在数据详情中存在，直接调用目标系统保存接口；不开启则会先与数据详情列表中的数据进行比对，如果数据在数据详情中存在且所有字段值都一样则不进行推送，即不会调用目标系统保存接口，否则进行推送。⚫时间段补录：按照选择的时间段进行来源系统数据的查询，分为开始时间和结束时间，前提是来源系统接口支持根据时间段条件进行查询并且连接器操作打上标签。⚫增量时间戳：修改数据同步任务执行的开始时间，一般用在期初数据的同步，前提是来源系统接口支持根据时间段条件进行查询并且连接器操作打上标签。5.2定时执行点击【定时执行】按钮会弹出“设置时间表达式”弹窗，数据同步任务支持页面端配置用户手册29/54corn表达式的方式配置定时任务。定时任务支持按分钟、小时、日、月、年配置执行周期、执行频率，并生成对应的Corn表达式。定时任务定义完成后，弹窗下方会展示定时任务对应的Corn表达式和最近五次执行时间。用户手册30/54定时任务创建成功后，可在【定时执行列表】中展示已创建的定时任务。5.3停止运行中的任务可以通过点击【停止】按钮人为干预，终止任务执行。用户手册31/54注意：点击停止，任务不会立即停止，同步任务会在执行完本次分页同步后停止。第六章SAP-ECC操作配置说明操作配置内容为一个数组形式的JSON字符串，在连接配置中展示如下：用户手册32/546.1操作配置整体模型结构模型设计整体以集合定义，集合中的每个对象对应一个操作的配置信息，具体如下：```[{"operationName":"","requestMethod":"","url":"","header":{},"loopSave":true,"wsdlUrl":"","methodName":"","contentType":"application/json","queryMappings":[],"fieldMappings":[],"fieldRules":[],"outputMappings":[],"outputRules":[]}]```每个对象中的属性定义如下：用户手册33/54属性编码属性定义operationName连接器中的操作方法编码requestMethod请求方式，支持GET、POST、PUT、DELETEurl三方接口path定义header三方接口请求头定义，{key:value}格式loopSave三方接口是否批量循环保存，true是，false否contentType数据交互的MIME类型，默认是application/jsonqueryMappings查询条件标品字段和实际字段映射配置fieldMappings标品集成对象和实际字段映射配置outputMappings标品返回结构字段与三方接口实际返回结构字段映射配置fieldRules集成对象字段规则集合，集成对象字段需要进行处理的规则都在这个集合下定义outputRules返回结构规则集合，返回结构字段需要进行处理的规则都在这个集合下定义wsdlUrlwsdl地址，SOAP协议使用methodName方法名称，SOAP协议使用6.2fieldMappings模型结构```"fieldMappings":[{"tFieldCode":"b[].a","sFieldCode":"a","exception":0}]```1、fieldMappings为集合形式，包含标品集成对象字段和实际字段映射配置，目标所有需要的字段都需要配置映射关系。2、来源字段、目标字段的定义包含结构体，例如：单个字段定义a、对象下字段定义a.b、用户手册34/54数组下字段定义a[].b[].c。3、如果是整个对象a或数组a[]转换到目标b或数组b[]下，字段转换规则可直接定义对象或数组。例：{"tFieldCode":"a[]","sFieldCode":"b[]"}。4、包含三个属性tFieldCode：目标字段sFieldCode：来源字段exception：异常类型定义，0代表返回原值，1.报错终止，2.返回空值，默认1。6.3queryMappings模型结构```"queryMappings":[{"tFieldCode":"pageIndex","sFieldCode":""},{"tFieldCode":"pageSize","sFieldCode":""},{"tFieldCode":"beginDatetime","sFieldCode":""},{"tFieldCode":"endDatetime","sFieldCode":""},{"tFieldCode":"param1","sFieldCode":""},{"tFieldCode":"param2","sFieldCode":""用户手册35/54},{"tFieldCode":"param3","sFieldCode":""},{"tFieldCode":"param4","sFieldCode":""},{"tFieldCode":"param5","sFieldCode":""}]```1、queryMappings为查询条件标品字段和实际字段映射配置，非必填属性，当为查询操作时需要配置。2、目标字段已预置，包含字段有pageIndex:分页起始页、pageSize:分页大小、beginDatetime:开始时间、endDatetime:结束时间。3、额外预置5个自定义查询参数：param1、param2、param3、param4、param5，可以配置其它SAP查询字段6.4outputMappings模型结构返回结构体映射配置包含查询返回结构体映射配置和保存返回结构体映射配置两种，根据实际操作方法在outputMappings中定义不同的返回结构体。1、查询返回结构体模型结构三方系统业务查询接口的实际返回结构可能不同，需要通过查询返回结构体模型转换将三方实际返回结构转换为数据集成要求的标品返回结构。```"outputMappings":[{"tFieldCode":"successCodeValue","defaultValue":""},{用户手册36/54"tFieldCode":"code","sFieldCode":"","exception":0},{"tFieldCode":"message","sFieldCode":""},{"tFieldCode":"data.record","sFieldCode":""},{"tFieldCode":"data.pageIndex","sFieldCode":""},{"tFieldCode":"data.pageSize","sFieldCode":""},{"tFieldCode":"data.totalCount","sFieldCode":""}]```模型字段说明：⚫code：三方系统返回状态码所对应的字段编码⚫successCodeValue：三方系统状态码代表成功的标识值，配置在defaultValue属性上⚫message：三方系统返回信息所对应的字段编码，主要是错误信息⚫data.record：三方系统返回的数据信息所对应的字段编码⚫data.pageIndex：三方系统当前查询的页码所对应的字段编码⚫data.pageSize：三方系统当前查询的每页行数所对应的字段编码⚫data.totalCount：三方系统查询返回总记录数所对应的字段编码2、保存返回结构体模型结构用户手册37/54三方系统业务保存接口的实际返回结构可能不同，需要通过保存返回结构体模型转换将三方实际返回结构转换为数据集成要求的标品返回结构。```"outputMappings":[{"tFieldCode":"successCodeValue","defaultValue":""},{"tFieldCode":"code","sFieldCode":"","exception":0},{"tFieldCode":"message","sFieldCode":""},{"tFieldCode":"data.record","sFieldCode":""},{"tFieldCode":"data.count","sFieldCode":""},{"tFieldCode":"data.successCount","sFieldCode":""},{"tFieldCode":"data.failCount","sFieldCode":""},{"tFieldCode":"data.messages[].message","sFieldCode":""},{"tFieldCode":"data.messages[].sourceUnique",用户手册38/54"sFieldCode":""},{"tFieldCode":"data.infos[].data[].targetUnique","sFieldCode":""},{"tFieldCode":"data.infos[].data[].sourceUnique","sFieldCode":""},{"tFieldCode":"data.sourceUnique","sFieldCode":"","exception":0},{"tFieldCode":"data.targetUnique","sFieldCode":"","exception":0}]```模型字段说明：⚫code：三方系统返回状态码所对应的字段编码⚫successCodeValue：三方系统状态码代表成功的标识值，配置在defaultValue属性上⚫message：三方系统返回信息所对应的字段编码，主要是错误信息⚫data.record：三方系统返回的数据信息所对应的字段编码⚫data.sourceUnique：来源系统唯一标识所对应的字段编码⚫data.targetUnique：目标系统唯一标识所对应的字段编码⚫data.count保存总记录数所对应的字段编码⚫data.successCount：保存成功记录数所对应的字段编码⚫data.failCount：保存失败记录数所对应的字段编码⚫data.totalCount：保存总记录数所对应的字段编码用户手册39/546.5rules模型结构```[{"tFieldCode":"a.b","rules":[{"ruleName":"","ruleStruct":{}}]}]```1、为了避免fieldMappings和outputMappings中存在相同的字段转换，将规则分为fieldRules和outputRules两部分。2、fieldRules和outputRules规则定义集合非必须定义，如果转换字段需要执行规则必须在此集合下定义。3、支持的规则有：拆分规则、拼接规则、类型转换规则4、包含两个属性⚫tFieldCode：目标字段⚫rules：规则集合，ruleName：规则名；ruleStruct：规则定义结构，每个规则在实现方法中对应不同的实体5、ruleName：规则名称⚫拆分规则：fieldSplit⚫拼接规则：fieldJoin⚫类型转换规则：dataType6、ruleStruct结构⚫拆分规则模型```"ruleStruct":{"symbol":"","index":""用户手册40/54}```模型字段说明：➢symbol：拆分符➢index：拆分后取第几个，脚标从0开始⚫拼接规则模型```"ruleStruct":{"symbol":"","fields":[""],"isPlaceholder":true}```模型字段说明：➢symbol：拼接符➢fields：需要拼接的字段➢isPlaceholder：如果拼接字段对应值为空，是否保留占位符⚫类型转换规则模型```"ruleStruct":{"tFieldType":"","tFieldFormat":""}```模型字段说明：➢tFieldType：目标字段类型，1:字符串，2:数值，3:日期➢tFieldFormat：日期格式6.6操作配置示例```[{"operationName":"listCustomerCategory",用户手册41/54"requestMethod":"POST","url":"/mock/986/listCustomercategory","loopSave":true,"fieldMappings":[],"outputMappings":[{"tFieldCode":"code","sFieldCode":"RESULT.SUCCESS","exception":0},{"tFieldCode":"successCodeValue","sFieldCode":"","defaultValue":1},{"tFieldCode":"data.record","sFieldCode":"RESULT.DATA.ITEMS.ITEM"},{"tFieldCode":"data.totalCount","sFieldCode":"RESULT.TOTALCOUNT"}],"queryMappings":[{"tFieldCode":"PAGE","sFieldCode":"pageIndex","exception":0},{"tFieldCode":"PAGESIZE","sFieldCode":"pageSize"},{"tFieldCode":"TMBEGIN","sFieldCode":"beginDateTime",用户手册42/54"exception":0},{"tFieldCode":"TMEND","sFieldCode":"endDateTime","exception":0},{"tFieldCode":"BUKRS","sFieldCode":"param1","exception":0},{"tFieldCode":"KUNNR","sFieldCode":"param2","exception":0}],"fieldRules":[]},{"operationName":"batchSaveMaterial","requestMethod":"POST","url":"/mock/986/saveMaterial","loopSave":true,"fieldMappings":[{"tFieldCode":"MATNR[].MATNR1","sFieldCode":"MATNR","exception":0},{"tFieldCode":"MAKTX","sFieldCode":"MAKTX","exception":0用户手册43/54},{"tFieldCode":"ZPC","sFieldCode":"ZPC","exception":0},{"tFieldCode":"MTART","sFieldCode":"MTART","exception":0},{"tFieldCode":"MEINS","sFieldCode":"MEINS","exception":0},{"tFieldCode":"WERKS","sFieldCode":"WERKS","exception":0},{"tFieldCode":"MSTAE","sFieldCode":"MSTAE","exception":0},{"tFieldCode":"BSTME","sFieldCode":"BSTME","exception":0}],"outputMappings":[{"tFieldCode":"code","sFieldCode":"status","exception":0用户手册44/54},{"tFieldCode":"successCodeValue","sFieldCode":"","defaultValue":200},{"tFieldCode":"data.targetUnique","sFieldCode":"id"},{"tFieldCode":"data.sourceUnique","sFieldCode":"sourceUnique"},{"tFieldCode":"message","sFieldCode":"msg"}],"queryMappings":[],"fieldRules":[{"tFieldCode":"MAKTX","rules":[{"ruleName":"dataType","ruleStruct":{"tFieldType":3,"tFieldFormat":"yyyy-MM-dd"}}]}]}]```用户手册45/54第七章混合云网关配置混合云网关作为连接配置的选填参数，用于解决企业内服务与公网服务之间的链路通道，混合云网关将部署至本地内网中，用于打通云上云下的内外网穿透。注意：当企业内服务与公网服务网络不通的时候再进行混合云网关的创建与使用。7.1新建网关登录BIP系统，切换到对应租户，在【连接集成服务】->【集成实施共建】->【连接管理】->【混合云网关】节点点击“新建网关”。录入网关编码和网关名称，点击确定即可。刚创建完的网关默认为离线状态7.2下载网关客户端在【连接集成服务】->【集成实施共建】->【连接管理】->【混合云网关】节点找到我用户手册46/54们刚创建完的混合云网关，点击【下载终端】按钮，下载对应版本的网关客户端。这里以windows版本为例，下载的文件以及解压后的文件如下需要注意：⚫找一台7x24小时都能访问您企业内部系统，且能访问互联网的机器，安装网关客户端。⚫下载完成后解压，需保证解压后的文件目录不存在中文字符。7.3下载网关密钥每个网关需要有该网关的秘钥进行安全认证，在【连接集成服务】->【集成实施共建】->【连接管理】->【混合云网关】节点找到我们刚创建完的混合云网关，点击【下载密钥】按钮，下载指定网关的密钥。下载下来的密钥为gateway.config.json文件用户手册47/54将下载的密钥文件（gateway.config.json）移动至网关客户端解压目录的config文件夹下7.4启动本地网关客户端在网关客户端解压目录的bin文件夹，运行iuap-gateway-start.bat。Linux环境在网关客户端解压目录的bin文件夹，运行iuap-gateway-start.sh。双击iuap-gateway-start.bat脚本启动网关，控制台输入1回车。7.5验证网关是否启动成功脚本命令启动成功后，在【连接集成服务】->【集成实施共建】->【连接管理】->【混用户手册48/54合云网关】节点找到我们刚创建完的混合云网关，点击【状态刷新】按钮，可以看到网关状态显示为“在线”，这时我们的本地混合云网关就已经搭建成功了。7.6使用混合云网关当我们在创建连接配置的时候，勾选【启用混合云网关】，即可在【网关信息】属性下拉框中获取当前租户下可用的网关信息。第八章注意事项8.1关于常量、默认值、直接映射使用说明1.常量配置必须配置来源，按照来源取值作为转换前映射转换后数据，需清除默认值。2.集成方案中涉及到的常量转换，项目上需要确认常量转换项是否正确3.默认值使用必须清除来源字段，否则默认值不生效。用户手册49/544.集成方案中涉及到的默认值，项目上需要确认默认值是否正确8.2其它1.BIP的单据编号不允许超过32位，否则无法保存。第九章常见问题9.1新建连接配置找不到连接器怎么办？在新建连接配置前需先进行连接器导入，然后再选择连接器进行连接器连接配置。用户手册50/549.2集成连接器导入时，缺jar包如遇到提示缺jar包，需先更新仓库，操作如下图：仓库地址：https://pan.yonyou.com/web/share.html?hash=yOpbN2jWRSw#9.3集成方案执行报连接配置错误用户手册51/54```{"code":"200","data":{"status":3,"data":null,"error_code":"GWAPI10041","msg":"SICommonException:连接配置数据为空，请检查。"}}```如果在连接配置页面已经创建了SAP-ECC连接器的连接，需要检查集成应用编辑页面在导入集成应用后是否从新编辑了连接配置，如图所示：用户手册52/549.4集成方案执行API授权错误API调用提示```{"code":"310037"，"message":"API未被授权:APPKEY[96edb050b1ca4f3ebfefe0fa98a9a53b]末获得要调用的APl[/yonbip/digitalModel/vendor/batchSaveV2]的授权”，"data":null}```请去API调用进行API授权，操作如下：9.5同步任务执行报没检索到可执行函数在数据同步任务界面查看返回日志如下：用户手册53/54连接器缺少响应的方法，需从新导入连接器，进入技术中台，重启集成平台及混合云数据集成服务即可。
