版权所有©2011-2017易顺科技集团有限公司20182018年年66月深圳月深圳k3cloud技术开发培训——WebApi集成易顺云商学院—胡敏锋目录目录概述与案例概述与案例概述与案例概述与案例11WebAPIWebAPI架构架构WebAPIWebAPI架构架构22WebAPIWebAPI接口描述接口描述WebAPIWebAPI接口描述接口描述33自定义自定义WebAPIWebAPI接口接口自定义自定义WebAPIWebAPI接口接口44P3概述目的：为异构系统访问K/3Cloud系统数据提供通用的接口。与第三方系统对接：商城、HR、OA、CRM等与K/3Cloud的对接P4概述目标：1.提供对K/3Cloud单据和基础信息的查看、保存、提交、审核、反审核和删除等功能；2.提供对K/3Cloud单据和基础信息的查询功能；约束：1.数据操作接口仅支持以基础资料编码、单据编号或直接以表单主键去操作数据；2.支持对某一具体单据的数据查询，但多单关联查询需要二开接口实现。P5案例：案例：步科智能仓储系统（WMS)X10屏+扫描枪+条码；看板P6案例：案例：Bartender打印监控程序P7案例：案例：微信公众号的应用客户（经销商）查询可提货余额，查询订单信息，查询发票信息轻应用：生产助手，质量助手，生产汇报P8采用的技术K/3CloudWebAPI是一种轻量级的、可维护的、可伸缩的Web服务。采用HTTP+JSON，也就是用RESTful的方式来开发。使用.NETFramework4.0为开发平台，源代码使用C#编写WebAPIWebAPI架构架构P9整个框架由三个组装件组成：Kingdee.BOS.WebApi.FormService.dll此组装件包含WebAPI主要接口的功能实现。部署在应用层服务器。Kingdee.BOS.WebApi.ServicesStub.dll此组装件主要包含WebAPI接口定义，扩展接口定义以及登陆验证接口。部署在应用层服务器。Kingdee.BOS.WebApi.Client.dll此组装件为WebAPI的客户端组件，封装了一些在异构系统客户端访问WebAPI的方法，适用于C#程序调用。由于它应用于异构系统客户端，所以此组装件需要拷贝到异构系统客户端环境中。非C#程序调用可以不用拷贝。WebAPIWebAPI架构架构P10标准的WebAPI接口：WebAPIWebAPI接口描述接口描述序号名称说明1Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser登录2Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View查看3Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save保存4Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave批量保存5Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit提交6Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit审核7Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit反审核8Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete删除9Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExecuteBillQuery表单数据查询P11WebAPIWebAPI在线测试平台在线测试平台P12WebAPIWebAPI在线测试平台在线测试平台P13WebAPIWebAPI在线测试平台在线测试平台P14WebAPIWebAPI在线测试平台在线测试平台P15如何应用如何应用WebApiWebApi接口接口SDK辅助类，引用Kingdee.BOS.WebAPI.Client.dll•添加引用usingKingdee.BOS.WebAPI.Client;•代码调用stringsJson="{\"CreateOrgId\":0,\"Numbers\":[\"PRE002\",\"PRE006\"]}";varresult=client.Execute("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete",newobject[]{"BD_Currency",sJson});P16如何应用如何应用WebApiWebApi接口接口无引用组件（不引用金蝶的组件）P17练习练习在线测试平台，测试接口：查看、保存、删除以采购订单为例。如何在代码调用如何在代码调用WebapiWebapi接口，实现采购订单的查看，保存，接口，实现采购订单的查看，保存，删除。删除。P18自定义自定义WebAPIWebAPI接口接口标准WebAPI接口的局限性：1.数据操作接口仅支持以基础资料编码、单据编号或直接以表单主键去操作数据；2.支持对某一具体单据的数据查询，但不支持多单关联查询。自定义WebAPI接口：无所不能P19如何自定义接口如何自定义接口需要引用的组件Kingdee.BOS.dll、Kingdee.BOS.ServiceFacade.KDServiceFx.dll、Kingdee.BOS.WebApi.ServicesStub.dllP20服务地址（无需引用组件）服务地址（无需引用组件）一般服务地址http://ServerIp/K3Cloud/接口命名空间.接口实现类名.方法,组件名.common.kdsvc例如：http://192.168.66.60/k3cloud/ApiServiceTest.AAA.CustomBusinessService.ExecuteService,ApiServiceTest.AAA.common.kdsvc与标准接口的地址一致：二开自定义的webapi接口命名空间必须以.ServicesStub结尾http://ServerIp/K3Cloud/接口命名空间.接口实现类名.方法.common.kdsvc例如：http://192.168.66.60/k3cloud/Kingdee.K3Erp.WebAPI.ServiceExtend.ServicesStub.CustomBusinessServiceExecuteService.common.kdsvcP21练习练习构建自己的WebAPI接口：1.HelloWord2.查询所有物料的编码，名称3.查询指定物料的编码，名称P22Cloud集成的应用WebAPI架构标准的WebAPI接口WebAPI在线测试平台自定义的WebAPI接口案例小结
