Новая карточка задач: обзор изменений

Новая карточка задач перевела комментарии в чат. Старые методы задач продолжают работать, кроме операций с комментариями. Изменения доступны с версии модуля tasks 25.700.0.

Что осталось без измененийЧто осталось без изменений

• task.* методы для создания и обновления задач, файлов, чек-листов работают как раньше.
• Добавление комментария через task.commentitem.add работает.

Что изменилось в комментарияхЧто изменилось в комментариях

• Обновление и удаление комментариев методами task.commentitem.update и task.commentitem.delete больше не работает. Используйте методы Чата:
  • im.message.update для изменения текста,
  • im.message.delete для удаления сообщения.
• Получение списка комментариев через task.commentitem.getlist не работает. Получайте сообщения чата задачи через im.dialog.messages.get.
• Используйте метод im.disk.file.commit для отправки файлов в чат задачи.
• Чат, связанный с задачей, возвращается в ответе tasks.task.get. Используйте его идентификатор для запросов в методах чатов.

Как получить ID чата задачи через tasks.task.getКак получить ID чата задачи через tasks.task.get

Старая версия apiСтарая версия api

POST https://{адрес_установки}/rest/{id_пользователя}/{пароль_rest-приложения}/tasks.task.get
        {
            "taskId": 51,
            "select": ["CHAT_ID"]
        }
        

Пример ответа:

{
            "result": {
                "task": {
                    "id": "3835",
                    "chatId": 2537,
                    "favorite": "N",
                    "group": [],
                    "action": {
                        ...
                    }
                }
            }
        }    
        

Новая версия apiНовая версия api

Запросите у задачи поля chat.id, chat.entityId, chat.entityType:

POST https://{адрес_установки}/rest/api/{id_пользователя}/{пароль_rest-приложения}/tasks.task.get
        {
            "id": 51,
            "select": ["id", "chat.id", "chat.entityId", "chat.entityType"]
        }
        

Пример ответа:

{
            "result": {
                "item": {
                    "id": 51,
                    "chat": {
                        "id": 58,
                        "entityId": 51,
                        "entityType": "TASKS_TASK"
                    }
                }
            }
        }
        

Как отправлять сообщения в задачуКак отправлять сообщения в задачу

• Старый метод task.commentitem.add.
• Новый метод tasks.task.chat.message.send. Чтобы отправить файл в чат задачи, используйте метод im.disk.file.commit.

СобытияСобытия

• Событие OnTaskCommentAdd работает. При работе с новой карточкой задачи в обработчик будут приходить параметры:

  • MESSAGE_ID с идентификатором сообщения в чате задачи,
  • TASK_ID с идентификатором задачи,
  • 'ID' => 0 идентификатор комментария будет равен нулю.

• События OnTaskCommentUpdate и OnTaskCommentDelete не работают в новой карточке.

Результат задачиРезультат задачи

• Метод tasks.task.result.list работает. При работе с новой карточкой задачи все результаты задачи будут возвращаться с параметром commentId: 0.

• Методы tasks.task.result.addFromComment и tasks.task.result.deleteFromComment не работают в новой карточке.

ВстройкиВстройки

Расположение мест встроек TASK_VIEW_SIDEBAR, TASK_VIEW_TOP_PANEL, TASK_VIEW_TAB не актуально в новой карточке задач. В новой карточке все встройки выводятся в едином блоке «Приложения».

Все ранее зарегистрированные встройки продолжают работать. Можно регистрировать новые встройки, они также будут показаны в блоке «Приложения».