推送任务数据

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

解释说明

任务中心名称定义和关系

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

请求示例


curl -X 'POST' \
  'https://api.tongji.edu.cn/v1/infra/task_center/push_task' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer e447e4b4b8e23973b42c44b8d324242' \
  -d '{
  "instData": [
    {
      "instId": 1,
      "appId": 1,
      "creator": "******",
      "created": "2023-09-17 10:00:00",
      "finished": "",
      "percent": 10,
      "status": 0,
      "nodeId": [1],
      "nodeName": ["部门待审核"],
      "name": "测试申请",
      "formUrlView": "https://txd.tongji.edu.cn/v2/matter/launch",
      "formMobileUrlView": "https://txd.tongji.edu.cn/v2/matter/launch",
      "processPicUrl": ""
    }
  ],
  "taskData": [
    {
      "appId": 1,
      "instId": 1,
      "taskId": 1,
      "nodeId": 1,
      "status": 0,
      "created": "2023-09-17 10:00:00",
      "finished": "",
      "formUrl": "https://txd.tongji.edu.cn/v2/matter/launch",
      "formUrlView": "",
      "formMobileUrl": "https://txd.tongji.edu.cn/v2/matter/launch",
      "formMobileUrlView": "",
      "processPicUrl": "",
      "nodeName": "待审核",
      "userIds": [
        "******"
      ],
      "sendMsg": 0
    }
  ]
}'

返回示例


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