В комментариях задачи участники задают вопросы, обсуждают задачу и следят за выполнением. Здесь можно оставлять важные заметки и фиксировать результаты.
Быстрый переход: все методы и события
Пользовательская документация: как работать с задачами
Задача. Комментарии привязаны к задаче по идентификатору TASKID. Получить его можно методом создания новой задачи или методом получения списка задач.
Пользователь. Комментарий имеет привязку к пользователю по числовому идентификатору в параметре AUTHOR_ID. Получить идентификатор пользователя можно с помощью метода user.get.
{% note tip "Пользовательская документация" %}
{% endnote %}
К комментарию задачи можно прикрепить файлы Диска. В параметре UF_FORUM_MESSAGE_DOC передайте массив с идентификаторами файлов Диска. Перед каждым идентификатором укажите префикс n, например: "UF_FORUM_MESSAGE_DOC": ["n428", "n345"]. Получить идентификаторы файлов можно двумя способами.
Использовать один из методов загрузки файла:
Использовать один из методов получения списка файлов:
{% note tip "Частые кейсы и сценарии" %}
{% endnote %}
Чтобы добавить, изменить или удалить комментарий, нужны права доступа к задаче и комментарию. Проверить права можно методом task.commentitem.isactionallowed.
Узнать актуальную информацию о методах работы с комментариями задачи вы можете с помощью метода task.commentitem.getmanifest. Рекомендуем использовать его только в качестве справочника, так как структуру ответа метода разработчик может изменить в любой момент.
Комментарий можно закрепить как результат выполнения задачи. Управляйте результатами задачи группой методов tasks.task.result.*.
Метод task.commentitem.delete удалит комментарий с результатом.
Scope:
taskКто может выполнять метод: зависит от метода
{% list tabs %}
-
Методы
#| || Метод | Описание || || task.commentitem.add | Добавить комментарий к задаче || || task.commentitem.update | Обновить комментарий || || task.commentitem.get | Получить комментарий задачи по
id|| || task.commentitem.getlist | Получить список комментариев к задаче || || task.commentitem.delete | Удалить комментарий || || task.commentitem.isactionallowed | Проверить, разрешено ли действие с комментарием || || task.commentitem.getmanifest | Получить список методов работы с комментариями и их описание || |# -
События
#| || Событие | Вызывается || || OnTaskCommentAdd | При добавлении комментария к задаче || || OnTaskCommentUpdate | При обновления комментария в задаче || || OnTaskCommentDelete | При удалении комментария из задачи || |#
{% endlist %}