1④内部公开请勿外传1993-2017金蝶国际软件集团有限公司④内部公开请勿外传金蝶云星-业务系统集成2019-06陈元喜2④内部公开请勿外传P21.系统集成概述2.供应链集成3.性能优化注意事项4.相关问题大纲：3④内部公开请勿外传P31.1集成方式–WebAPI–WebService–ClientProxy1.2WebAPI–相关接口–在线测试工具1.系统集成概述4④内部公开请勿外传P41.1集成方式1.系统集成概述WebAPIWebServiceClientProxy（客户端代理接口）5④内部公开请勿外传P51.系统集成概述1.2WebAPI1.提供基础资料和单据的标准业务操作2.提供自定义接口3.提供可视化测试工具6④内部公开请勿外传P61.2.1常用相关接口1.2系统集成概述-WebAPI接口编号名称说明1http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc登陆验证接口2http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View.common.kdsvc查看表单数据接口3http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc保存表单数据接口4http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave.common.kdsvc批量保存表单数据接口5http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit.common.kdsvc提交表单数据接口6http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit.common.kdsvc审核表单数据接口7http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit.common.kdsvc反审核表单数据接口8http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete.common.kdsvc删除表单数据接口9http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExecuteBillQuery.common.kdsvc表单数据查询接口10http://ServerIp/K3Cloud/接口命名空间.接口实现类名.方法名,组件名.common.kdsvc自定义WebAPI接口11http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Draft.common.kdsvc暂存表单数据接口12http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Allocate.common.kdsvc分配表单数据接口13http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Push.common.kdsvc下推接口14http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.GroupSave.common.kdsvc分组保存接口7④内部公开请勿外传P7具体相关接口1.1WebAPI-接口8④内部公开请勿外传P81.2系统集成概述-Webapi在线验证工具1.2.2目录：–基础管理-公共设置-动态服务定义-WebAPI9④内部公开请勿外传P92.1基础资料–物料、仓库、辅助资料、批号、序列号2.2单据–销售订单、其他出库单、直接调拨单、分步式调入单2.3业务量–库存量、锁库量、可用量、预计可发量、信用占用额2.4其他–自定义接口（标准，二开，等）2.供应链集成10④内部公开请勿外传P102.1.1物料–分组：如何获取左侧树形结构数据？–枚举：如何获取枚举字段所有值？2.1基础资料-物料11④内部公开请勿外传P112.1.1物料–分组2.1基础资料-物料12④内部公开请勿外传P122.1.1物料–枚举2.1基础资料-物料13④内部公开请勿外传P132.1.1物料–枚举2.1基础资料-物料14④内部公开请勿外传P142.1.2仓库–仓位2.1基础资料-仓库15④内部公开请勿外传P152.1.2仓库–仓位2.1基础资料-仓库16④内部公开请勿外传P162.1.3辅助资料–FormID:BOS_ASSISTANTDATA_DETAIL–按照常规基础资料操作即可2.1基础资料-辅助资料17④内部公开请勿外传P172.1.3批号–保存•业务不能直接新增，需要由单据保存生成–查询•需要注意特殊字段2.1基础资料-批号18④内部公开请勿外传P182.1.3批号–保存•业务不能直接新增，需要由单据保存生成2.1基础资料-批号19④内部公开请勿外传P192.1.3批号–查询•需要注意特殊字段2.1基础资料-批号1.物料内码为masterid。2.业务类型标准是否来自库存单据，批号主档不显示非库存批号3.保质期信息根据物料是否勾选“附属信息”确定4.FMATERIALID+FNUMBER+FLOTSTATUS+FUSEORGID可以唯一确定一条主档信息20④内部公开请勿外传P202.1.4序列号–如何新增?–如何查询某个即时库存下的序列号？2.1基础资料-序列号21④内部公开请勿外传P212.1.4序列号–标准没有提供新增接口•预先生成•单据生成2.1基础资料-序列号22④内部公开请勿外传P222.1.4序列号–支持查询•如果查询即时库存明细下2.1基础资料-序列号23④内部公开请勿外传P232.2.1销售订单–webapi如何实现销售订单的行操作？2.2单据-销售订单24④内部公开请勿外传P242.2.2其他出库单–负库存校验2.2单据-其他出库单25④内部公开请勿外传P252.2.2其他出库单–负库存校验2.2单据-其他出库单InterationFlags：交互标志集合，字符串类型，分号分隔，格式："flag1;flag2;."（非必录），例如（允许负库存标识：STK_InvCheckResult）26④内部公开请勿外传P262.2.2其他出库单–负库存校验•类似的还有如下：物料盘点作业单的盘点数量校验–InterationFlags:"StockCountInputSaveZeroCountQtySpensor“2.2单据-其他出库单27④内部公开请勿外传P272.2.3直接调拨单–webapi保存的调拨类单据容易出现数据问题2.2单据-调拨类单据1.调拨类单据上存在2套字段：调出方和调入方。2.一般调入方很多维度字段隐藏与调出方数据一致。3.webapi数据包中无需传入隐藏字段的数据。28④内部公开请勿外传P282.1.4分步式调入单–不支持手工单独新增–必须由分步式调出单下推生成•保存接口（构造关联关系）•下推接口2.2单据-调拨类单据29④内部公开请勿外传P292.1.4分步式调入单•保存接口（构造关联关系）2.2单据-调拨类单据30④内部公开请勿外传P302.1.4分步式调入单•下推接口2.2单据-调拨类单据31④内部公开请勿外传P312.3.1库存量–基础资料内码不对？–获取库存量不准确？–即时库存上的保质期信息为空？–如何获取库存变动量？2.3业务量-库存量32④内部公开请勿外传P322.3.1库存量2.3业务量-库存量33④内部公开请勿外传P332.3.1库存量–FormID：STK_Inventory–库存实体表：T_STK_INVENTORY•数量字段：仅有基本单位数量（FBaseQty）和辅单位数量（FSecQty）准确•保质期信息：生产日期、有效期至（与参数“是否附属信息”有关）–库存更新日志表：T_STK_INVENTORYLOG2.3业务量-库存量34④内部公开请勿外传P342.3.1库存量–T_STK_INVENTORY2.3业务量-库存量35④内部公开请勿外传P352.3.1库存量–库存更新日志表：T_STK_INVENTORYLOG2.3业务量-库存量36④内部公开请勿外传P362.3.2锁库量–webapi如何查询锁库量？–webapi如何锁库以及解锁？2.3业务量-锁库量37④内部公开请勿外传P372.3.2锁库量–锁库量查询•库存锁库列表•Sum，Count2.3业务量-锁库量38④内部公开请勿外传P382.3.2锁库量–webapi如何锁库•目前系统标准接口中并未提供对应接口，需要封装自定义接口实现–使用系统标准的锁库函数»Kingdee.K3.SCM.App.Core.StockLockService.SaveLockInfo»Kingdee.K3.SCM.App.Core.StockLockService.SaveUnLockInfo–自行根据预留表写数据»T_PLN_RESERVELINK»T_PLN_RESERVELINKENTRY2.3业务量-锁库量39④内部公开请勿外传P392.3.3可用量–webapi如何查询可用量？2.3业务量-可用量40④内部公开请勿外传P402.3.3可用量–锁库属于预留，是一种强预留类型–可用量=库存量–预留量•不启用预留时–可用量=库存量–锁库量»库存-锁库列表即可查询锁库量•启用预留时–可用量=库存量–预留量»预留关系表查询对应预留量2.3业务量-可用量41④内部公开请勿外传P412.3.3可用量–可用量=库存量–预留量•可用预留关系表查询–不启用预留时。»则可用库存锁库列表单独查询锁库数据即可。2.3业务量-可用量42④内部公开请勿外传P422.3业务量-预计可发量2.3.4预计可发量43④内部公开请勿外传P432.3.4预计可发量–接口地址：•Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.GetExpectQty–参数说明：2.3业务量-预计可发量44④内部公开请勿外传P442.3业务量-信用占用额2.3.5信用占用额45④内部公开请勿外传P452.3.5信用占用额–接口地址：•Kingdee.K3.SCM.WebApi.ServicesStub.CreditAPIService.GetCreditInfo–参数说明：2.3业务量-信用占用额46④内部公开请勿外传P462.4.1自定义接口–标准业务系统提供某些逻辑•供应链业务封装接口–Kingdee.K3.SCM.WebApi.ServicesStub–其他部分自行根据业务需要封装2.4其他-自定义接口47④内部公开请勿外传P473.1简化数据包3.2调整业务逻辑3.3优化设计方案3.性能优化注意事项48④内部公开请勿外传P483.1简化数据包–必录字段–业务字段3.性能优化-简化数据包49④内部公开请勿外传P493.2调整业务逻辑–字段相关服务–操作相关服务3.性能优化-调整业务逻辑50④内部公开请勿外传P503.2调整业务逻辑–字段相关服务•辅助录入的作用3.性能优化-调整业务逻辑51④内部公开请勿外传P513.2调整业务逻辑–操作相关服务3.性能优化-调整业务逻辑52④内部公开请勿外传P523.2调整业务逻辑–操作相关服务3.性能优化-调整业务逻辑53④内部公开请勿外传P533.2调整业务逻辑–业务参数3.性能优化-调整业务逻辑54④内部公开请勿外传P543.3优化设计方案–多线程并发（批量保存接口）–数据合并处理–调整实现方案3.性能优化注意事项55④内部公开请勿外传P554.1登陆4.2保存4.3查询4.4卡慢4.相关问题56④内部公开请勿外传P564.1登陆问题–登陆超时–云客户http调整为https4.相关问题-登陆57④内部公开请勿外传P574.2字段赋值无效–字段值合法性–字段值依赖性–字段值顺序性–其他4.相关问题-字段赋值58④内部公开请勿外传P584.3查询数据不一致–需要与数据表比对4.相关问题-查询数据59④内部公开请勿外传P594.4慢–借助日志工具排查•开启统一日志平台记录webapi相关日志、具体分析耗时在哪4.相关问题-慢60④内部公开请勿外传④内部公开请勿外传4.相关问题-日志平台•4.5日志平台–1.创建日志库•管理中心下–2.配置WebApi日志•管理员登陆–3.用户授权•日志管理员权限–4.日志查看•日志管理-日志查询-webapi日志61④内部公开请勿外传④内部公开请勿外传4.相关问题-日志平台•4.5日志平台–1.创建日志库•管理中心下–2.配置WebApi日志•管理员登陆–3.用户授权•日志管理员权限–4.日志查看•日志管理-日志查询-webapi日志62④内部公开请勿外传④内部公开请勿外传4.相关问题-日志平台•4.5日志平台–1.创建日志库•管理中心下–2.配置WebApi日志•管理员登陆–3.用户授权•日志管理员权限–4.日志查看•日志管理-日志查询-webapi日志63④内部公开请勿外传④内部公开请勿外传4.相关问题-日志平台•4.5日志平台–1.创建日志库•管理中心下–2.配置WebApi日志•管理员登陆–3.用户授权•日志管理员权限–4.日志查看•日志管理-日志查询-webapi日志64④内部公开请勿外传1993-2017金蝶国际软件集团有限公司④内部公开请勿外传Thankyou!
