Comments in Tasks: Overview of Methods

In task comments, participants ask questions, discuss the task, and track progress. Important notes can be left here, and results can be recorded.

Quick navigation: all methods and events

User documentation: Working with tasks

Connection of Comments with Other ObjectsConnection of Comments with Other Objects

Task. Comments are linked to the task by the identifier TASKID. You can obtain it using the create new task method or the get task list method.

User. A comment is associated with a user by the numeric identifier in the AUTHOR_ID parameter. You can get the user identifier using the user.get method.

Drive FilesDrive Files

You can attach Drive files to a task comment. In the UF_FORUM_MESSAGE_DOC parameter, pass an array with the identifiers of the Drive files. Prefix each identifier with n, for example: "UF_FORUM_MESSAGE_DOC": ["n428", "n345"]. You can obtain file identifiers in two ways.

Use one of the file upload methods:

• disk.storage.uploadfile
• disk.folder.uploadfile

Use one of the methods to get the list of files:

• disk.storage.getchildren
• disk.folder.getchildren

Task Execution ResultsTask Execution Results

A comment can be pinned as the result of task execution. Manage task results with the group of methods tasks.task.result.*.

The method task.commentitem.delete will delete the comment with the result.

Overview of Methods and EventsOverview of Methods and Events

Scope: task

Who can execute the method: depends on the method