K/3Cloud WebAPI 调用任意操作实现方案【分享】
金蝶云社区-天冥异
天冥异
6人赞赏了该文章 2261次浏览 未经作者许可,禁止转载编辑于2018年07月19日 20:38:39

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

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

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

K/3 Cloud WebAPI接口说明文档
https://vip.kingdee.com/article/285118203204853739
我们知道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系统集成实现下推单据转换调用【分享】
https://vip.kingdee.com/article/152662



回到最初的问题,

你已经知道了吧?!
为了进一步增加确定性,
我还是要揭晓答案:
作废: 直接调用提供的标准StatusConvert 状态转换服务接口或 ExcuteOperation指定编码“Cancel”。
整单关闭:通过调用ExcuteOperation指定编码“YLBillClose”
反关闭:
通过调用ExcuteOperation指定编码“YLUnBillClose”

一句话总结:单据操作的通用接口请求地址即:
http://[IP]/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation.common.kdsvc,传入不同的操作编码即可。


赞 6