推送任务数据

最近更新时间: 2024年07月04日 02时55分27秒

能力接口

描述

推送：推送任务到同济大学任务中心，每次推送数据都包含实例数据和任务数据，实例数据会在任务中心”我的申请“中显示，任务数据会在”我的任务“中显示。
更新：同一个任务多次推送不会创建多个任务。会根据新的实例数据、任务数据对之前的进行覆盖；

注意事项

appId、instId、taskId、nodeId，最大9位数的int类型。
所有的url链接最大长度500，如果长度超出，对接方自行处理成短链接。
所有的url链接如果需要在小程序中打开，需要做域名验证，否则无法打开。
任务推送接口可能受网络等因素的影响造成推送失败，建议接入方对推送数据进行记录，并对推送失败的情况增加重试机制，以保证接入方和任务中心状态一致！

支持的模式

客户端模式,授权码模式

请求方法

POST

请求地址

https://api.tongji.edu.cn/v1/infra/task_center/push_task

数据来源

请求参数

参数名	是否必填	备注
instData	是	实例数据
instId	是	实例id，实例的唯一标识，即用户的一条申请id
appId	是	事项id
creator	是	实例发起者工号
created	是	实例创建时间，YYYY-MM-DD HH:ii:ss
finished	否	实例完成时间，YYYY-MM-DD HH:ii:ss，实例未结束时没有该数据
percent	否	进度 0-100，示例完成进度
status	是	实例状态，0 进行中，1 终止，2 完成，4 撤销
nodeId	否	实例所在的节点列表id，没有传递空数组
nodeName	否	实例所在的节点名称列表，没有传递空数组
name	是	实例名称
formUrlView	是	实例pc端查看地址，如需跳转查看则必须传递，否则传空字符串
formMobileUrlView	是	实例移动端查看地址，如需跳转查看则必须传递，否则传空字符串
processPicUrl	否	流程图查看地址，没有传空字符串
taskData	是	任务数据
appId	是	事项id
instId	是	实例id，实例的唯一标识，即用户的一条申请id
taskId	是	任务id，task的唯一标识（如果没有taskId的，可以自己传一个固定的，但是不能不传）
nodeId	否	任务节点id
status	是	任务状态，0 进行中，2 已驳回，3 完成，4 已撤销
created	是	任务创建时间，YYYY-MM-DD HH:ii:ss
finished	否	任务完成时间，YYYY-MM-DD HH:ii:ss，任务结束时必填
formUrl	是	任务进行中pc 端审批地址
formUrlView	否	任务已完成pc 端查看详情
formMobileUrl	是	任务进行中移动端审批地址
formMobileUrlView	否	任务已完成移动端查看详情
processPicUrl	否	流程图查看地址
nodeName	否	任务所在节点名称（将在消息推送中显示，如果未传递，则显示空）
userIds	是	任务拥有人工号列表
sendMsg	否	是否推送消息到同济信息化，1-是，0-否，不传参数默认为1 （该功能要多测试）

解释说明

任务中心名称定义和关系

我的申请：我的申请为接口中instData数据，一个申请是一个实例。
我的任务：我的任务是用户要处理的任务，根据处理状态分为（待办）和（已办），数据为接口中taskData。
我的申请和我的任务办关系：用户申请某个事项（创建事项接口），根据事项的流转产生不同的任务推送给不同的人审批。

请求示例


curl -X POST \
  'https://api.tongji.edu.cn/v1/infra/task_center/push_task' \
  -H 'instData: ' \
  -H 'instId: ' \
  -H 'appId: ' \
  -H 'creator: ' \
  -H 'created: ' \
  -H 'finished: ' \
  -H 'percent: ' \
  -H 'status: ' \
  -H 'nodeId: ' \
  -H 'nodeName: ' \
  -H 'name: ' \
  -H 'formUrlView: ' \
  -H 'formMobileUrlView: ' \
  -H 'processPicUrl: ' \
  -H 'taskData: ' \
  -H 'appId: ' \
  -H 'instId: ' \
  -H 'taskId: ' \
  -H 'nodeId: ' \
  -H 'status: ' \
  -H 'created: ' \
  -H 'finished: ' \
  -H 'formUrl: ' \
  -H 'formUrlView: ' \
  -H 'formMobileUrl: ' \
  -H 'formMobileUrlView: ' \
  -H 'processPicUrl: ' \
  -H 'nodeName: ' \
  -H 'userIds: ' \
  -H 'sendMsg: '

返回示例


{
  "code": "A00000",
  "msg": "操作成功",
  "data": null
}