Метод «Создать новую задачу из шаблон໶
Endpoint: POST {hostname}/dh-tasks-service/api/v3/tasks/by-template
Метод позволяет создать новую задачу из существующего шаблона, с возможностью переопределить некоторые поля шаблона задачи.
Более подробное описание метода находится в yaml файле «tasks_service», который расположен в папке с документацией.
Маппинг параметров запроса
| Входящие параметры | Способ передачи параметров | Требования к заполнению |
|---|---|---|
| X-Correlation-ID | Header | Опциональный ключ корреляции для операции |
| Idempotency-Key | Header | Ключ уникальности запроса |
| templateId | Body | Идентификатор шаблона задачи. Обязателен, если не передан templateCode. Если передан и идентификатор и код шаблона, идентификатор имеет приоритет |
| templateCode | Body | Код шаблона задачи. Обязателен, если не передан идентификатор шаблона |
| classCode | Body | Создаваемый класс задачи |
| completionType | Body | Тип завершения задачи. Доступные значения: · SIMPLE; · WITH_REPORT; · CONTROLLED |
| reportCheck | Body | Вариант проверки отчета. Доступные значения: · NO_CHECK; · TEXT; · TEXT_ONLY; · FILE; · FILE_AND_TEXT |
| enabledReportClassCode | Body | Разрешенный класс отчета (опционально). Если задан, то отчет можно задать только указанного типа |
| name | Body | Наименование задачи |
| body | Body | Текст задачи |
| dueDate | Body | Требуемая дата выполнения задачи |
| followUpDate | Body | Время напоминания о задаче |
| assignee | Body | Текущий исполнитель задачи |
| candidateGroups | Body | Список групп, в который входят кандидаты для исполнителей |
| candidateUsers | Body | Список кандидатов для исполнителей |
| reportReceivers | Body | Список получателей отчета (логины пользователей) |
| reportReceiversGroups | Body | Список получателей отчета (список групп пользователей) |
| data: · additionalProp1 · additionalProp2 · additionalProp3 |
Body | Дополнительные поля задачи |
| replyTo | Body | Имя очереди, куда необходимо отправить сообщение о выполнении задачи |
| correlationKey | Body | Ключ корреляции, который необходимо включить в сообщение о выполнении задачи |
| initiator | Body | Логин пользователя, являющегося поручителем по задаче |
| reopenDisabled | Body | Признак, указывающий на возможность возобновления задачи после ее отмены |
Пример запроса:
curl --location 'https://docshouse-dev.k8s.lan.lanit.ru/dh-tasks-service/api/v3/tasks/by-template' \
-header 'accept: application/json' \
-header 'X-Correlation-ID: 162b2bdb-c360-4891-a066-364091600526' \
-header 'Content-Type: application/json' \
-data '{
"templateId": "9ab7488e-b684-4278-8cea-ba215ba230b4",
"templateCode": "simpleTemplate",
"classCode": "test01",
"completionType": "SIMPLE",
"reportCheck": "NO_CHECK",
"enabledReportClassCode": "string",
"name": "testTask",
"body": "text",
"dueDate": "2025-03-30T08:58:25.756Z",
"followUpDate": "2025-03-30T08:58:25.756Z",
"assignee": "ivanovp",
"candidateGroups": [
"testGroup"
],
"candidateUsers": [
"usertest"
],
"reportReceivers": [
"usertest2"
],
"reportReceiversGroups": [
"testGroup3"
],
"data": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"replyTo": "string",
"correlationKey": "string",
"initiator": "borisov",
"reopenDisabled": false
}'