一、宜搭

版本介绍

使用场景

在宜搭的应用中，通过以下几类页面来配合完成完整的业务场景需求的解决：

我们的关注点在流程表单的使用场景。

关于高级流程：

不仅能满足普通设计器的几乎所有功能，还在此基础上增强了部分功能，例如增加了分支、聚合等组件；同时也对组件功能及设置进行了增强，区分基础和高级设置；执行人规则的重新制定、以及完成策略的设置；流程版本快捷上线和切换；规则设置的可视化。

服务回调 0.1 服务注册

服务注册是使用服务回调功能的前置步骤，即将需要使用到的第三方服务的接口注册到宜搭平台上来，主要的功能在于设置接口的出入参信息、验权加密信息、权限控制、接口描述信息等，以便在使用时可以快速引用。

1.1 单据服务校验/服务执行

主要可用于单据使用过程中的可能使用到服务回调的场景，从使用方式上来说可以细分为服务校验和服务执行

1.2 流程服务校验/服务执行 1.3 流程节点动态获取审批人

通过宜搭侧提供的流程节点动态获取审批人的方式，通过调用客户侧提供的服务接口，来动态的获取流程所需的审批人。并且由于流程在执行过程中，中间的审批人可以修改表单内变量的值，后续的节点可以根据更正后的表单数据动态的获取流程审批人，来满足一些动态的、复杂的业务场景的需求。

1.4 流程发起/查看权限动态验证

该使用场景主要针对宜搭平台侧提供的提供的静态的权限组人员配置（包括：部门、个人、角色）都无法满足，但是企业服务中可以提供相关的根据人员id判断指定流程是否有用发起和查询权限接口，以便将宜搭的流程权限配置以企业既有的统一权限系统进行打通，那么就可以使用该方式完成消流程实例的发起人以及流程实例查看人的动态配置。

1.5 消息通知服务动态选择接收人

该使用场景主要针对宜搭平台侧提供的既有人员通知类型（包括：按参与人通知、按角色通知、按指定人员通知、按表单页面内的人员变量通知、指定邮箱、指定钉钉群）都无法满足时，但是企业服务中可以提供相关的人员查询接口，那么就可以使用该方式完成消息通知服务动态选择接收人的配置。

总结： 除了在节点操作可以提供回调，提供了更为丰富的权限验证，消息通知。

1.6外部对接API

外部对接宜搭API

2.1 支持字段

1.表单字段
2.流程和表单内置字段

二、钉钉OA审批

企业使用的web系统需要在钉钉上实现智能工作流处理，可以选择复用钉钉官方工作流方案。企业内部开发者只需要专注于业务实现，将工作流处理流程托管到钉钉。

添加权限（前置操作）

添加应用工作流权限

回调数据

实例开始、结束

{
    "EventType": "bpms_instance_change",
    "processInstanceId": "ad253df6-e175caf-xxxxxxxxxxxx",
    "corpId": "corpidxxxxxxxxxxxxx",
    "createTime": 1495592259000,
    "title": "自测-1016",
    "type": "start",
    "staffId": "er5875",
    "url": "https://aflow.dingtalk.com/dingtalk/mobile/homepage.htm",
    "processCode":"Pro-xxx"
  }

任务开始

{
    "EventType": "bpms_task_change",
    "processInstanceId": "ce133dd0-5b22-9516-xxxxxxxxxxxx",
    "corpId": "corpidxxxxxxxxxxxxx",
    "createTime": 1495593189000,
    "title": "自测-1016",
    "type": "start",
    "staffId": "manager75",
    "processCode":"Pro-xxx"
  } 

任务结束

{
    "EventType": "bpms_task_change",
    "processInstanceId": "ce133dd0-5b22-9516-xxxxxxxxxxxx",
    "corpId": "corpidxxxxxxxxxxxxx",
    "createTime": 1495593189000,
    "title": "自测-1016",
    "type": "start",
    "staffId": "manager75",
    "processCode":"Pro-xxx"
  }

开放接口 名称类型示例值描述

,

审批人列表，最大列表长度20。多个审批人用逗号分隔，按传入的顺序依次审批。

存在的问题：

1.无法得知具体审批节点   
2.参与人设置更依赖钉钉本身，无法灵活的动态设置参与人

三、具体使用

    在具体的日常使用中，我们可能更多是在下面两种场景下使用：
    一是在钉钉上直接自建流程表单，在钉钉上发起、审批、流转、结束，必要时可能还会借助他们提供的回调或者来通知外部应用。
    二是在钉钉上自建流程表单，在外部应用上发起，然后将数据通过提供的外部调用接口发起审批流程实例，主要使用他们的流程引擎，在数据流转过程中通过外部调用接口实时的进行数据交互。
    对于以上两种场景，钉钉OA工作流在第二点上功能比较单一，他的应用回调通过事件订阅来实现，只提供了两种订阅事件；同时对于数据的动态获取上，更依赖钉钉本身的通讯录。相比钉钉OA工作流，宜搭在这些功能上更加灵活和全面。

四、使用举例（以宜搭为例） 1.直接在宜搭上使用 在宜搭上搭建流程表单

基本数据设计完成以后，我们可以通过回调接口来设置数据校验和表单内容变更通知。

服务校验: 用于在表单提交时，调用业务服务接口校验数据的合法性，主要用于从业务侧判断用户提交参数的合法性，例如判断持有某个手机号的用户在本市主城区范围内是否拥有第二套住房，同步调用

服务执行: 用于在单据提交/编辑/删除成功后，执行第三方服务调用，主要用于实时同步用户提交的数据到第三方，多用于二次处理或者数据归档的场景，异步调用。

基本流程转换以后，我们可以通过回调接口来动态获取审批人。通过调用外部服务提供的服务接口，来动态的获取流程所需的审批人。并且由于流程在执行过程中，中间的审批人可以修改表单内变量的值，后续的节点可以根据更正后的表单数据动态的获取流程审批人，来满足一些动态的、复杂的业务场景的需求。

在宜搭中，找到对应的流程，进行发起审批等功能的使用。

2.外部发起流程实例

外部发起流程实例在前期的流程构建上基本和内部应用一致。

当我们在外部应用上完成发起后，后续流程的流转交由宜搭来实现，在具体的流转过程中，可以通过回调外部应用实时的数据完成权限校验，同时将审批结果同步到外部应用中。