集成中心

功能介绍

在通过宜搭的流程页面提交数据后，会在应用维度、组织维度的任务中心产生任务数据，按任务的状态分为「我创建的」、「待我处理」、「我已处理」、「抄送我的」，这些数据随着流程的流转在宜搭通过自身的服务进行存储、更新、查询。

宜搭专属版的企业/组织，可以通过集成中心的集成企业审批任务消息功能，的功能实现和企业/组织自己的任务中心或者待办系统做服务对接，当应用的流程产生任务、更新任务时将会调用企业/组织的服务进行数据推送。

连接器配置成功后，本组织内每个宜搭应用的审批的每个任务（所有任务），都将自动推送至下图中注册上来的服务地址，企业在对应的服务回调中，可自行决定对宜搭的审批相关事件进行选择性处理和消费。

如何使用

前置条件

企业/组织是宜搭专属版
自身具备服务系统，并且可以提供HTTP类型的服务供宜搭调用
需要满足宜搭的服务回调格式
网络可访问

接入过程

创建HTTP连接器

在需要的企业/组织内创建HTTP连接器，在连接器中配置要对接的服务，如下图所示：

可以为每个接口服务单独创建一个连接器，每个连接器配置一个动作，也可以在同一个连接器中创建多个动作，分别表示不同的接口服务。

配置5个连接动作，分别对应审批任务的创建、结束、取消、删除、抄送。类似与webhook，当这些事件触发时，宜搭系统会自动回调注册上来 www.yourCorpService.com/xx-interface

添加连接器动作

连接器动作的创建请查看：

https://docs.aliwork.com/docs/yida_support/wtwabe/zevvr1/_1/zbq17y

注意：在对专属任务中心回调服务调用时，接口本身已经具备验签功能，所以在创建连接器动作时可以选择“无身份认证”，如果仍要求连接器的身份验证，可按连接器文档操作。

以下内容主要描述专属任务中心需要的信息：

连接器动作：创建任务

请求方式：POST
请求入参：

task：任务详情，数据格式为JSON字符串，包括了应用appType，企业corpId，任务标题、任务ID、实例ID、创建人、审批人、审批地址等关键信息
sign: 参数签名，通过对入参按照一定的要求进行加密，供服务提供方验签，验签方式见下文
dateTime: 当前的会到时间戳字符串

请求结果：暂无具体要求

在我创建任务时，task任务详情返回的数据示例：
{
  "actionerId": null,
  "actionerName": null,
  "appType": "APP_RY60OCRF33Z7534***",
  "createTime": 1693462062502,
  "currentActivityInstances": null,
  "dataMap": {
    "cascadeDateField_l4sbkqco": null,
    "selectField_l523dlqi_value": null,
    "selectField_l523dlqi_value_en_us": null,
    "multiSelectField_l523dlqk": null,
    "numberField_l4s57vma": "1",
    "selectField_l523dlqi": null,
    "imageField_llyrklcy": "****",
    "textareaField_l4s57vmf": "",
    "textField_l4s57vm9": "",
    "tableField_l4s57vmb": "[{\"numberField_li9yr6gs\":\"\",\"textField_l4s57vmc\":\"\",\"textField_l4s57vmd\":\"\",\"textField_l51tzkqs\":\"\"}]"
  },
  "dataType": "pinst",
  "deep3": true,
  "finishTime": null,
  "formInstanceId": "65ab8549-aa06-486a-b5b7-8abe845303a5",
  "formUuid": "FORM-MT866EA1X3N9W79GDQM2HB400M413OS76A2GL51",
  "instValue": "***"
  "modifiedTime": 1693462062502,
  "modifyUserAvatar": "",
  "modifyUserDisplayName": "",
  "modifyUserId": "01690741902689",
  "openAvatar": "",
  "openId": "",
  "openNickname": "",
  "openSource": "",
  "originatorAvatar": "https://static.dingtalk.com/media/lALPDfJ6d8zhRL_NAbjNAbg_440_440.png",
  "originatorCorpId": "ding5d17e3add038d44535c2f4657eb6378f",
  "originatorCorpName": "",
  "originatorDisplayName": "张红",
  "originatorId": "01690741902689",
  "processApprovedResult": "",
  "processApprovedResultText": "",
  "processCode": "TPROC--9BC6687125N9XAJ8873I0864QY122BZ96A2GL1",
  "processId": 0,
  "processInstanceId": "",
  "processInstanceStatus": "",
  "processInstanceStatusText": "",
  "processName": "",
  "serialNo": "",
  "title": "**的1位访客申请",
  "version": 10
}

连接器动作：完成任务

请求方式：POST
请求入参：

appType：应用标识
corpId：企业标识
taskId：任务ID
actualWorkId：实际处理人
formInstId: 实例ID
sign: 参数签名，通过对入参按照一定的要求进行加密，供服务提供方验签，验签方式见下文
dateTime: 当前的会到时间戳字符串

请求结果：暂无具体要求

连接器动作：取消任务

请求方式：POST
请求入参：

appType：应用标识
corpId：企业标识
taskId：任务ID
actualWorkId：实际处理人
formInstId: 实例ID
sign: 参数签名，通过对入参按照一定的要求进行加密，供服务提供方验签，验签方式见下文
dateTime: 当前的会到时间戳字符串

请求结果：暂无具体要求

连接器动作：删除任务

注意：目前删除任务只会发生在实例删除，因此回调服务时会将实例ID作为入参

请求方式：POST
请求入参：

appType：应用标识
corpId：企业标识
formInstId: 实例ID
sign: 参数签名，通过对入参按照一定的要求进行加密，供服务提供方验签，验签方式见下文
dateTime: 当前的会到时间戳字符串

请求结果：暂无具体要求

签名过程

服务回调的接口签名采用对入参进行MD5的方式加密，加密结构通过sign参数传给服务提供方，加签过程中需要有宜搭应用的systemToken作为加签密钥

对所有入参的参数key通过String.CASE_INSENSITIVE_ORDER进行排序
按照key的排序将对应的参数值拼接成加密前的字符串
将systemToken拼接在第二步得到的字符串之后
通过MD5算法对第三步得到的字符串进行加密，加密时需要采用UTF-8字符集

配置同步策略

在集成中心中配置某个已创建的审批连接器

实现效果

举例，下图是某行业客户根据专属宜搭的集成开发能力，将审批任务汇总至自建的审批任务中心，解决了宜搭各类系统应用，企业自有业务系统、生产系统、行政系统等多平台BPM流程统一聚合。

本文档对您是否有帮助？

有用

没用

功能介绍​

如何使用​

前置条件​

接入过程​

创建HTTP连接器​

添加连接器动作​

连接器动作：创建任务​

连接器动作：完成任务​

连接器动作：取消任务​

连接器动作：删除任务​

签名过程​

配置同步策略​

实现效果​