[关闭]
@15311494814 2018-08-20T09:14:22.000000Z 字数 8046 阅读 521

任务成员、任务相关接口

matrix

一、任务成员

1,更新任务成员

  1. [post] /taskmember
  2. body:
  3. {
  4.     "taskId":"688a242ef92246a7bcc943b89383f24d", //task或者projectPlanID
  5.     "excuterId":"0986468d8d2547d88b84833622e55d7f", //执行者id，只能一个
  6.     "participantIds":"1292cab80e7740b88a72d0d7fc799bce,18b4969b49d745d3b76b455dc458214d" 
  7.     //参与者id，最多15个，逗号隔开
  8. }
  9. note: excuterId 不填则不更新执行者 participantIds不填则不更新参与者，更新方式为全覆盖
  11. result:
  12. {
  13.     "statusCode": "000000",
  14.     "result": "ok",
  15.     "error": ""
  16. }

2,查询任务的成员

  1. [get] /taskmember/all/{taskId}
  2. result:
  3. {
  4.     "statusCode": "000000",
  5.     "result": [
  6.         {
  7.             "id": "bd24c143a82a44b8ac4817970676dc98",
  8.             "taskId": "688a242ef92246a7bcc943b89383f24d",
  9.             "taskSource": 1,
  10.             "employeeId": "0986468d8d2547d88b84833622e55d7f",
  11.             "relationship": "executor",
  12.             "pageSize": null,
  13.             "startIndex": null,
  14.             "employeeName": "孟凡志"
  15.         },
  16.         {
  17.             "id": "061bc855f7cb4d89ade845169393435b",
  18.             "taskId": "688a242ef92246a7bcc943b89383f24d",
  19.             "taskSource": 1,
  20.             "employeeId": "1292cab80e7740b88a72d0d7fc799bce",
  21.             "relationship": "participant",
  22.             "pageSize": null,
  23.             "startIndex": null,
  24.             "employeeName": "王阔"
  25.         },
  26.         {
  27.             "id": "a30aa11ae14c4c28a0db70b196357176",
  28.             "taskId": "688a242ef92246a7bcc943b89383f24d",
  29.             "taskSource": 1,
  30.             "employeeId": "18b4969b49d745d3b76b455dc458214d",
  31.             "relationship": "participant",
  32.             "pageSize": null,
  33.             "startIndex": null,
  34.             "employeeName": "刘天保"
  35.         }
  36.     ],
  37.     "error": ""
  38. }
  40. note:第一位永远是执行者，后面是参与者

3 ,根据taskId查询执行者

  1. [get] /taskmember/executor/{taskId}
  2. result:
  3. {
  4.     "statusCode": "000000",
  5.     "result": {
  6.         "id": "bd24c143a82a44b8ac4817970676dc98",
  7.         "taskId": "688a242ef92246a7bcc943b89383f24d",
  8.         "taskSource": 1,
  9.         "employeeId": "0986468d8d2547d88b84833622e55d7f",
  10.         "relationship": "executor",
  11.         "pageSize": null,
  12.         "startIndex": null,
  13.         "employeeName": "孟凡志"
  14.     },
  15.     "error": ""
  16. }

二、任务

1,查询我的任务或者我参与的任务按项目或者按截止日期的分组信息

  1. [post] /task/listgroup
  2. body:
  3. {
  4.     "employeeId":"789c1b90039147499ee8bbbb278b12ae",
  5.     "relationship":"executor",
  6.     "orderby":"endTime"
  7. }
  8. //note:  relationship:任务类型(executor:我的任务,participant:我参与的任务)
  9. //orderby:排序关键词(project:按项目,endTIme:按截止时间)
  10. result(按项目):
  11. {
  12.     "statusCode": "000000",
  13.     "result": [
  14.         {
  15.             "name": "无项目所属",
  16.             "id": "noProject"
  17.         },
  18.         {
  19.             "name": "实时估值产品化项目",
  20.             "id": "98b4b1a0fa3a4749a30d83dcea6b75ac"
  21.         }
  22.     ],
  23.     "error": ""
  24. }
  26. result2(按截止日期):
  27. {
  28.     "statusCode": "000000",
  29.     "result": [
  30.         {
  31.             "name": "今天",
  32.             "id": "today"
  33.         },
  34.         {
  35.             "name": "已延期",
  36.             "id": "delay"
  37.         },
  38.         {
  39.             "name": "本周",
  40.             "id": "thisWeek"
  41.         },
  42.         {
  43.             "name": "其他",
  44.             "id": "other"
  45.         }
  46.     ],
  47.     "error": ""
  48. }
  49. //note : 返回结果中的id为下面接口的groupId,项目的groupId为projectId，其中无所属项目任务的组id为noProject

2,查询我的任务列表中某一个分组的详细任务列表信息，带分页

  1. [post[ /task/groupTasks
  2. body : {
  3.     "employeeId":"789c1b90039147499ee8bbbb278b12ae", //员工id
  4.     "groupId":"98b4b1a0fa3a4749a30d83dcea6b75ac", //组id,具体见note
  5.     "relationship":"participant", //(executor:我的任务,participant:我参与的任务)
  6.     "startIndex":"", //分页起始下标,默认为0
  7.     "pageSize":"" //分页每页条数,默认为10
  8. }
  10. //note:该接口只会返回按照截止时间和项目分组的分页信息,groupId可以为projectId,或者
  11. //截止时间分组的id,其中项目中的无所属项目的任务传groupId为noProject
  13. result:
  14. {
  15.     "statusCode": "000000",
  16.     "result": {
  17.         "data": [
  18.             {
  19.                 "task_name": "分析",
  20.                 "except_timecount": 0,
  21.                 "task_status": 0,
  22.                 "actual_timecount": 0,
  23.                 "create_time": "2018-08-06 14:09:58",
  24.                 "gantt_id": "5",
  25.                 "modify_time": "2018-08-07 15:25:21",
  26.                 "end_time": "2019-06-13",
  27.                 "gantt_pid": "3",
  28.                 "task_desc": "",
  29.                 "priority": "4",
  30.                 "duration_unit": "d",
  31.                 "duration": 3,
  32.                 "start_time": "2018-04-12",
  33.                 "project_id": "98b4b1a0fa3a4749a30d83dcea6b75ac",
  34.                 "gantt_unique_id": "232",
  35.                 "gantt_resource": "王威",
  36.                 "prex_gantt_ids": "4",
  37.                 "progress": 0,
  38.                 "gantt_predecessors": "4:231:FS:0.0d",
  39.                 "id": "33ee313ede854984bbc8c181330258e6",
  40.                 "task_type": "1"
  41.             }
  42.         ],
  43.         "startIndex": 0,
  44.         "pageSize": 10,
  45.         "totalCount": 2,
  46.         "currentPage": 1,
  47.         "pageCount": 1,
  48.         "example": null
  49.     },
  50.     "error": ""
  51. }

3,查询我的任务列表中按优先级、更新时间，完成时间，全部任务的列表信息，带分页

  1. [post] /task/listTasks
  2. body:
  3. {
  4.     "employeeId":"789c1b90039147499ee8bbbb278b12ae",
  5.     "orderby":"priority", //priority|modifyTime|finishTime|status
  6.     "relationship":"participant",
  7.     "startIndex":"",
  8.     "pageSize":""
  9. }
  11. result:
  12. {
  13.     "statusCode": "000000",
  14.     "result": {
  15.         "data": [
  16.             {
  17.                 "task_name": "分析",
  18.                 "except_timecount": 0,
  19.                 "task_status": 0,
  20.                 "pr": 3,
  21.                 "actual_timecount": 0,
  22.                 "create_time": "2018-08-06 14:09:58",
  23.                 "gantt_id": "5",
  24.                 "modify_time": "2018-08-07 15:25:21",
  25.                 "end_time": "2019-06-13",
  26.                 "gantt_pid": "3",
  27.                 "task_desc": "",
  28.                 "priority": "高",
  29.                 "duration_unit": "d",
  30.                 "duration": 3,
  31.                 "start_time": "2018-04-12",
  32.                 "project_id": "98b4b1a0fa3a4749a30d83dcea6b75ac",
  33.                 "gantt_unique_id": "232",
  34.                 "gantt_resource": "王威",
  35.                 "prex_gantt_ids": "4",
  36.                 "progress": 0,
  37.                 "gantt_predecessors": "4:231:FS:0.0d",
  38.                 "id": "33ee313ede854984bbc8c181330258e6",
  39.                 "task_type": "1"
  40.             },
  41.             {
  42.                 "task_name": "测试任务二",
  43.                 "task_status": 0,
  44.                 "pr": 2,
  45.                 "create_time": "2018-08-01 12:00:10",
  46.                 "gantt_id": "",
  47.                 "modify_time": "2018-08-01 12:00:10",
  48.                 "participant_id": "1b9bbca28a9d495aac28ae1750a621c1,2b020862b9a74b6f837486bbd9b3fb43",
  49.                 "end_time": "2018-09-08",
  50.                 "gantt_pid": "",
  51.                 "task_desc": "这是第二个任务",
  52.                 "priority": "中",
  53.                 "principal_id": "789c1b90039147499ee8bbbb278b12ae",
  54.                 "duration_unit": "",
  55.                 "finish_time": "",
  56.                 "start_time": "2018-08-09",
  57.                 "project_id": "98b4b1a0fa3a4749a30d83dcea6b75ac",
  58.                 "gantt_unique_id": "",
  59.                 "gantt_resource": "",
  60.                 "prex_gantt_ids": "",
  61.                 "gantt_predecessors": "",
  62.                 "id": "ab11a972b7de40b99104de38f24129e7",
  63.                 "task_type": ""
  64.             }
  65.         ],
  66.         "startIndex": 0,
  67.         "pageSize": 10,
  68.         "totalCount": 2,
  69.         "currentPage": 1,
  70.         "pageCount": 1,
  71.         "example": null
  72.     },
  73.     "error": ""
  74. }

4,gen'j根据taskId查询任务详情

  1. [get]/task/{taskId}
  2. result:
  3. {
  4.     "statusCode": "000000",
  5.     "result": {
  6.         "task_name": "UI设计",
  7.         "attachments": [
  8.             {
  9.                 "id": "300721ee7320489c983ba5cdf3b9e76e",
  10.                 "dependencyId": "11f5aa5f021447308984a0b0a58d9050",
  11.                 "fileName": "模板.mpp",
  12.                 "path": "D:/AoutyWorkspace/matrix0.6_dev/Matrix0.6/matrix/project_proposal/1532674552639模板.mpp",
  13.                 "createTime": "2018-07-27 14:55:52",
  14.                 "employeeId": "789c1b90039147499ee8bbbb278b12ae",
  15.                 "attachmentType": "project_proposal",
  16.                 "fileSize": "873.00KB",
  17.                 "pageSize": null,
  18.                 "startIndex": null
  19.             }
  20.         ],
  21.         "gantt_id": "52",
  22.         "modify_time": "",
  23.         "participant_id": "1cf8277add09449897576e1e015bc082,26675a352dac447f8027db1780a96bbb",
  24.         "task_desc": "这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述",
  25.         "project_name": "实时估值产品化项目",
  26.         "principal_id": "03b7601889a44153847e5f46ca5c73c5",
  27.         "duration": 40,
  28.         "project_id": "98b4b1a0fa3a4749a30d83dcea6b75ac",
  29.         "gantt_predecessors": "",
  30.         "preTasks": [
  31.             {
  32.                 "id": "33ab9c04f1df48f0ad2deeb1b694bbb4",
  33.                 "projectId": "98b4b1a0fa3a4749a30d83dcea6b75ac",
  34.                 "taskName": "整体设计",
  35.                 "taskDesc": "这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述这是任务描述",
  36.                 "startTime": "2018-03-23",
  37.                 "endTime": "2018-07-10",
  38.                 "createTime": "2018-08-20 11:39:46",
  39.                 "modifyTime": "",
  40.                 "principalId": "03b7601889a44153847e5f46ca5c73c5",
  41.                 "priority": null,
  42.                 "taskType": "2",
  43.                 "ganttId": "30",
  44.                 "ganttPid": "0",
  45.                 "progress": 73,
  46.                 "duration": 78,
  47.                 "durationUnit": "d",
  48.                 "taskStatus": 0,
  49.                 "finishTime": "",
  50.                 "exceptTimecount": null,
  51.                 "actualTimecount": null,
  52.                 "participantId": "1cf8277add09449897576e1e015bc082,26675a352dac447f8027db1780a96bbb",
  53.                 "ganttUniqueId": "7",
  54.                 "ganttResource": "",
  55.                 "ganttPredecessors": "",
  56.                 "prexGanttIds": "",
  57.                 "orderby": 2,
  58.                 "pageSize": null,
  59.                 "startIndex": null,
  60.                 "attachmentNumber": 1,
  61.                 "principalProfilePicture": null
  62.             }
  63.         ],
  64.         "id": "11f5aa5f021447308984a0b0a58d9050",
  65.         "logs": [
  66.             {
  67.                 "createTime": "2018-07-20",
  68.                 "taskLogList": [
  69.                     {
  70.                         "taskLogContent": "修改任务实际工时为 44 d!修改任务实际工时为 44 !",
  71.                         "showTime": " 10:20",
  72.                         "id": "5244189a52c44243a08522c281788a78",
  73.                         "operatorId": "18660bfa66494090b1ecc51a070af1ee",
  74.                         "operatorName": "王秀清",
  75.                         "taskId": "11f5aa5f021447308984a0b0a58d9050"
  76.                     }
  77.                 ]
  78.             }
  79.         ],
  80.         "task_status": 0,
  81.         "create_time": "2018-08-20 11:39:46",
  82.         "participant_data": [
  83.             {
  84.                 "id": "1cf8277add09449897576e1e015bc082",
  85.                 "name": "朱丽娟"
  86.             },
  87.             {
  88.                 "id": "26675a352dac447f8027db1780a96bbb",
  89.                 "name": "黄凛凛"
  90.             }
  91.         ],
  92.         "end_time": "2018-07-10",
  93.         "gantt_pid": "30",
  94.         "orderby": 4,
  95.         "principal_data": {
  96.             "id": "03b7601889a44153847e5f46ca5c73c5",
  97.             "name": "黄旭"
  98.         },
  99.         "duration_unit": "d",
  100.         "finish_time": "",
  101.         "start_time": "2018-05-16",
  102.         "gantt_unique_id": "160",
  103.         "gantt_resource": "",
  104.         "prex_gantt_ids": "",
  105.         "progress": 62,
  106.         "task_type": "1"
  107.     },
  108.     "error": ""
  109. }

6,上传任务附件(不会替换，需要结合删除附件接口使用)

  1. [post] /task/attachment/upload
  2. body:
  3. {
  4.     "dependencyId":"",//任务id
  5.     "employeeId":""//员工id
  6. }
  7. result:
  8. {
  9.     "statusCode": "000000",
  10.     "result": "ok",
  11.     "error": ""
  12. }

7，删除任务附件

  1. [delete] /task/attachment/{attachmentId}
  2. result:
  3. {
  4.     "statusCode": "000000",
  5.     "result": "ok",
  6.     "error": ""
  7. }

8,修改任务

  1. [put] /task/{taskId}
  2. body:
  3. {
  4.     "taskName":"修改名字",
  5.     "taskDesc":"我是描述",
  6.     "startTime":"2019-01-01", //年月日
  7.     "endTime":"2019-01-03",//年月日
  8.     "principalId":"2ec483791a4e41bcabef3cd22e363aa3",//执行者，一个，uuid
  9.     "participantId":"0ed9e81e7e154bc28c8d59c2348a5125,26675a352dac447f8027db1780a96bbb", //参与者，多个
  10.     "priority":"中", //高中低
  11.     "progress":30, //进度，百分比，数字
  12.     "duration":19, //几个工作日，正整数
  13.     "taskStatus":0, //任务状态0,未完成，1已完成
  14.     "finishTime":"2019-02-02", //结束时间
  15.     "exceptTimecount":10, //期望工时，数字
  16.     "actualTimecount":11 //实际工时，数字
  17. }
  18. result:
  19. {
  20.     "statusCode": "000000",
  21.     "result": "ok",
  22.     "error": ""
  23. }

9,删除任务

  1. [delete] /task/{taskId} //该方法会删除任务，任务成员以及任务所有附件
  2. result:
  3. {
  4.     "statusCode": "000000",
  5.     "result": "ok",
  6.     "error": ""
  7. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注