K/3Cloud WebAPI 调用任意操作实现方案

问题提出:如何实现【销售订单】
的作废、整单关闭、反关闭?

用过WebAPI调用的小伙伴,从提供的文档说明中

K/3
Cloud WebAPI接口说明文档

http://club.kisdee.com/forum.php?mod=viewthread&tid=714662

我们知道Web API有标准接口有:

WebAPI 说明中提供的标准调用接口,

我们可以看出,除了“用户验证”接口外。

其他的都是配置在单据上的操作列表调用。

这时当单据上,当关联有配置较多的业务操作,我们该如何实现呢?

如下图:

【销售订单】上有 作废,整单关闭,反关闭。

该如何实现通过Web API调用实现呢?

上图看到的只是菜单,对于BOS IDE熟悉的小伙伴,是知道这里是有一层做隔离的(即菜单绑定到操作列表的配置实现)。

当调用为系统的标准操作,会走到服务端的统一的入口,即按内码进行调用(一般情况标准操作每个单据上只会绑定一个)。

当我们以xml方式打开一个BOS IDE的界面时,会发现,每一个操作都是有个配置描述节(会包含操作内码及操作编码的)。

如截图中的界面xml配置片段,

“保存”操作对应到了Operation = Save,OperationId = 8,

“查看” 操作Operation 为View,OperationId是 10 等。

WebAPI的服务端解析逻辑,Save通过传入指定的操作内码 8,即调到了服务端的操作内码为8的,也就是一般单据上只有一个的“保存”操作。

有人看到这里 也许会问?

这里按内码指定,假如配置的操作列表里面有多个“保存”操作,是会调用到哪一个呢?

答案:是第一个。

如文档中提供的“状态转换” 真正调用的操作编码为 38,也就是第一个内码为38的操作,一般会是“作废”操作。

至此 我们已经知道,通过WebAPI,如果我们想调用服务端的操作是按内码的,并且会找到第一个内码标识的操作进行调用。

这时,当你急切的打开了【销售订单】的配置

(要打开界面xml配置,点箭头所指,注意:还要关闭已打开的界面展现,否则xml是打不开的)

找到了【销售订单】上的,作废、整单关闭、反关闭的相关操作的xml配置节信息。

这时你可能会发现,哦……,居然都是相同的操作内码,我该怎么办 怎么办?

别忘了,除了操作内码,别忘了,上文中截图我们还看到的,每个操作配置节还有一个操作编码(这个编码是配置操作时指定的,并且单据上是唯一的)。

我们完全可以通过指定编码方式去调用。

也就是下图的第一调用接口:

对于“保存”操作我们完全可以这样去调用:

到此,相信BOS IDE中配置的任意操作,你都会知道如何进行调用了。

附上:“保存”操作相关代码:

  1. object[] saveInfo = new object[]
  2. {
  3. sFormId,
  4. sJson
  5. };
  6. //调用保存接口
  7. var retSave = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save", saveInfo);
  8. //可以修改为
  9. object[] invokeInfo = new object[]
  10. {
  11. sFormId,
  12. "Save",
  13. /*
  14. 保存服务接口 Save 8,
  15. 查看取数服务接口 View 10,
  16. 审核服务接口 Audit 1,
  17. 删除服务接口 Delete 3,
  18. 提交服务接口 Submit 9,
  19. 反审核服务接口 UnAudit 26,
  20. 状态转换服务接口 StatusConvert 38
  21. */
  22. sJson
  23. };
  24. //通过通用的接口,按编码调用调用
  25. var retInvoke = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation", invokeInfo);

复制代码

其实,论坛已有类似实现的帖子的。

K3Cloud系统集成实现下推单据转换调用【分享】

http://club.kisdee.com/forum.php?mod=viewthread&tid=763172

回到最初的问题,

你已经知道了吧?!

为了进一步增加确定性,

我还是要揭晓答案:

作废:
直接调用提供的标准StatusConvert 状态转换服务接口或 ExcuteOperation指定编码“Cancel”。

整单关闭:通过调用ExcuteOperation指定编码“YLBillClose”

反关闭:通过调用ExcuteOperation指定编码“YLUnBillClose”

一句话总结:单据操作的通用接口请求地址即:

http://[IP]/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation.common.kdsvc,传入不同的操作编码即可。

时间: 2024-12-29 04:02:43

K/3Cloud WebAPI 调用任意操作实现方案的相关文章

HttpContext在多线程异步调用中的使用方案

1.在线程调用中,有时候会碰到操作文件之类的功能.对于开发人员来说,他们并不知道网站会被部署在服务器的那个角落里面,因此根本无法确定真实的物理路径(当然可以使用配置文件来配置物理路径),他们唯一知道的就是文件在项目中的相对路径,为了定位文件路径,一般都会调用HttpContext.Current.Request.MapPath或者HttpContext.Current.Server.MapPath,但是在多线程调用中,HttpContext肯定为null,这时候还调用MapPath结果就是报错.

在.NET中调用DataWindow操作数据库

Sybase在2004/1/19日推出了Pb 10 beta1版本,其中包含DataWindow.NET 1.0,这真是一个另人兴奋的消息! 在PB市场日益萎缩的今天,在.NET大行其道的今天Sybase公司终于推出了DataWindow.NET,它支持DataWindow绝大部份原有事件和属性,PB技术终于可以重新又派上用场了!! 下过来安装程序,便急不可待的在VS.NET2003下面做了一个简单的例子,发现真的很好用!源代码.界面如下: using System; using System.

WCF 客户端调用服务操作的两种方法

本节的主要内容:1.通过代理类的方式调用服务操作.2.通过通道的方式调用服务操作.3.代码下载 一.通过代理类的方式调用服务操作(两种方式添加代理类) 1.手动编写代理类,如下: 客户端契约: using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.ServiceModel; namespace y.WcfFirst.Client.Proxys { [Se

maven聚合项目以及使用dubbo远程服务调用debug操作。

1.maven聚合项目以及使用dubbo远程服务调用debug操作. 然后操作如下所示: 然后如下所示: 启动断点所在的包的服务.以debug的形式启动. 断点进来的效果如下所示: 接下来请继续你的表演. 待续...... 原文地址:https://www.cnblogs.com/biehongli/p/11442278.html

图解微信小程序---调用API操作步骤

图解微信小程序---调用API操作步骤 什么是API API(Application Programming Interface,应用程序编程接口:是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节. 通俗的讲API就是接口,就是通道,负责一个程序和其他软件的沟通,本质是预先定义的函数. API通常是以Http的形式提供,它隐藏的含义就是,只要你符合我定义的标准,你就可以来使用我. 注册账号 填写注册信息 登陆 管

可任意操作nf_conntrack的nf_sockopt_ops

内核与用户态通信的接口简直太多了,有时候如果非要将它们分个三六九等也是不合适的,比如臭名昭著的ioctl,一旦臭起来就抽到底了,没人说它得好.有时候它并非想象中的那么坏,绝大多数是因为人们误用了它们,然后哪位大师说了一句它不好,从此以后人们就随大师而去了...对于ioctl,对应到socket类型文件描述符上,就是get/setsockopt两个接口函数,其实我不明白从函数名称上区分操作类型和从命令类型上区分有什么不同,一个对于UNIX文件描述符统一的ioctl为何会在socket上衍生出两个函

JAVA调用.NET WebService终极方案(包含对SoapHeader的处理)

一.前言: 今日部门的产品需要用到短信功能,需要走公司统一的接口,而该短信接口是由.net开发的,利用两天时间彻底搞定了用java来调用.net 的web service,包括对soap header的处理. 二.解决方案 查询了下java中对soap的支持,有几种方案,有axis和xfire等,我这里先选择的是axis的1.4版本,随即开始开发,这里面有个大坑啊.就是java对类的属性中的getXXXX方法解析后生成的xml文件的属性首字母是小写的,与.NET的生成的xml对不上,光这个问题耗

C# 调用存储过程操作 OUTPUT参数和Return返回值

本文转载:http://www.cnblogs.com/libingql/archive/2010/05/02/1726104.html 存储过程是存放在数据库服务器上的预先编译好的sql语句.使用存储过程,可以直接在数据库中存储并运行功能强大的任务.存储过程在第一应用程序执行时进行语法检查和编译,编译好的版本保存在高速缓存中.在执行重复任务时,存储过程可以提高性能和一致性.由于存储过程可以将一系列对数据库的操作放在数据库服务器上执行,因而可以降低Web服务器的负载,提高整个系统的性能. 1.创

WebApi调用通用方法

WebApi传递基础参数的时候可能会有各种各样的问题,有的需要在服务端增加[FromBody]的特性,有的需要增加一层封装为实体,有的用动态类型,下面介绍一个方便的调用方法.通过WebClient类.代码如下,需要什么参数只需要在QueryString中添加即可. try { WebClient client = new WebClient(); //client.QueryString.Add("account", "冯宝宝"); //client.QuerySt