1 业务背景

苍穹OpenAPI已经提供了业务对象的操作API，如保存、提交、审核。在许多业务场景中，希望保存后自动提交、审核，完成整个业务流程，并且在中间任一环境出现错误时，自动回滚上一步的数据，降低客户端调用的复杂度。

2 解决方案

为降低客户端调用的复杂度，需要将多个接口进行合并处理，可以采用集成服务云的服务编排实现，以仓库bd_warehouse为例，演示具体操作步骤如下：

• 根据业务对象，同步集成对象

  依次新建连接配置-数据源-集成对象，输入全名bd_warehouse，保存后点击同步。连接配置、数据源等的创建，请参考

  https://vip.kingdee.com/knowledge/specialDetail/184698074009519872?category=190497631598890752&id=6575&productLineId=29&lang=zh-CN

         

• 建立服务流程

  服务流程引入对应的流程变量和集成对象作为资源，如下图所示，其中流程变量中，需要将warehouse设为输入参数，便于后续从外部接口传递过来。

  

• 配置流程节点

  配置保存节点，选择“保存（新增+修改）”操作，并在候选键页签选择编码number作为异构系统间的唯一标识。注意：候选键可以选择单个或者多个，如果有分录，也要选择分录字段的候选键。

  
  

  

  

  同理，提交和审核的配置和保存类似，差别在于操作列表的类型不一样，此处不再赘述。
  

• 配置错误转移路线

  根据业务需求，在提交失败后，需要回滚删除业务数据，为此，需要在提交时，配置错误转移线，当失败时调用删除操作，如下图所示。

  

  
  

  

  同理，审核失败时，也需要配置反审核操作，再调用删除操作，此处不再赘述。

• 发布流程API

  将服务流程发布之后，在【API集成】-【服务流程转API界面】可以发布对应的服务流程转API

  

  点击启用，则自动往开放平台发布一条API

  

  点击测试，输入数据

  
  

  

• 6、运行效果

  （1）各个操作正常执行场景

  

  此时，仓库列表新增了一条数据。

  

  （2）提交或审核出现异常的场景

  

  此时，仓库列表不存在数据

  

  
  

3 方案的可推广价值

通过这个案例，可以了解到如何通过服务流程将多个OpenAPI的操作组合编排起来。后续类似场景可以参照这个方案配置。

4. 参考资料

集成服务流程操作指南：https://club.kdcloud.com/article/98890752746688768 

服务流程API使用说明：https://developer.kingdee.com/school/detail/121558918710471168