Поля задачи
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Запись и изменение полей производится согласно бизнес-логике и с учетом прав пользователя. То есть зависит от роли пользователя, настроек прав на группу, иерархии, статуса задачи и некоторых флагов в задаче, например, allowChangeDeadline.
|
Название |
Описание |
|
|
id |
Идентификатор задачи |
|
|
parentId |
Идентификатор родительской задачи. Имеет значение |
|
|
title |
Название задачи |
|
|
description |
Описание задачи |
|
|
chatId |
Идентификатор чата для новой карточки задачи |
|
|
mark |
Оценка задачи. Возможные значения: |
|
|
priority |
Приоритет задачи. Возможные значения:
|
|
|
multitask |
Признак «базовая задача с подзадачами». Возможные значения:
|
|
|
notViewed |
Признак «не просмотрено». Возможные значения:
|
|
|
replicate |
Признак «повторять задачу». Возможные значения:
|
|
|
stageId |
Идентификатор стадии |
|
|
sprintId |
Идентификатор спринта |
|
|
backlogId |
Идентификатор бэклога |
|
|
createdBy |
Идентификатор постановщика |
|
|
createdDate |
Дата создания в формате |
|
|
responsibleId |
Идентификатор ответственного |
|
|
changedBy |
Идентификатор пользователя, изменившего задачу |
|
|
changedDate |
Дата изменения в формате |
|
|
statusChangedBy |
Идентификатор пользователя, изменившего статус задачи |
|
|
closedBy |
Идентификатор пользователя, завершившего задачу. Имеет значение |
|
|
closedDate |
Дата завершения в формате |
|
|
activityDate |
Дата последней активности в формате |
|
|
dateStart |
Дата начала |
|
|
deadline |
Крайний срок |
|
|
startDatePlan |
Плановая дата начала. В методах создания и обновления задачи, вместе с |
|
|
endDatePlan |
Плановая дата окончания. В методах создания и обновления задачи, вместе с |
|
|
guid |
Идентификатор |
|
|
xmlId |
Внешний идентификатор |
|
|
commentsCount |
Количество комментариев |
|
|
serviceCommentsCount |
Количество системных комментариев |
|
|
allowChangeDeadline |
Разрешено менять крайний срок. Возможные значения:
|
|
|
allowTimeTracking |
Разрешено учитывать время. Возможные значения:
|
|
|
taskControl |
Контроль задачи включен. Возможные значения:
|
|
|
addInReport |
Добавлять в отчет. Возможные значения:
|
|
|
forkedByTemplateId |
Идентификатор шаблона, если задача создана из шаблона |
|
|
timeEstimate |
Оценка времени в секундах |
|
|
timeSpentInLogs |
Фактически затраченное время |
|
|
matchWorkTime |
Учитывать рабочее время. Возможные значения:
|
|
|
forumTopicId |
Идентификатор темы комментариев |
|
|
forumId |
Идентификатор форума |
|
|
siteId |
Идентификатор сайта |
|
|
subordinate |
Признак того, что задача я вляется подзадачей. Возможные значения:
|
|
|
exchangeModified |
Дата изменения синхронизацией в формате |
|
|
exchangeId |
Идентификатор синхронизации |
|
|
outlookVersion |
Версия |
|
|
viewedDate |
Дата просмотра задачи в формате |
|
|
sorting |
Значение сортировки |
|
|
durationFact |
Фактическая длительность |
|
|
isMuted |
Признак «без звука». Возможные значения:
|
|
|
isPinned |
Признак «закреплено». Возможные значения:
|
|
|
isPinnedInGroup |
Признак «закреплена в группе». Возможные значения:
|
|
|
flowId |
Идентификатор потока |
|
|
descriptionInBbcode |
Описание в формате BBCode. Возможные значения:
|
|
|
status |
Статус задачи. Возможные значения:
|
|
|
statusChangedDate |
Дата изменения статуса в формате |
|
|
durationPlan |
Плановая длительность |
|
|
durationType |
Единица плановой длительности. Возможные значения: |
|
|
favorite |
Признак «в избранном». Возможные значения:
|
|
|
groupId |
Идентификатор группы, к которой привязана задача |
|
|
auditors |
Список идентификаторов пользователей — наблюдателей за задачей |
|
|
accomplices |
Список идентификаторов пользователей — соисполнителей |
|
|
checklist |
Объект с пунктами чек-листа. Ключ — идентификатор пункта, значение — объект с описанием пункта |
|
|
group |
Объект с описанием группы |
|
|
creator |
Объект с описанием пользователя — постановщика задачи |
|
|
responsible |
Объект с описанием пользователя — ответственного за задачу |
|
|
accomplicesData |
Объект с описанием пользователей — соисполнителей. Ключ объекта — идентификатор пользователя, а значение — объект с описанием пользователя |
|
|
auditorsData |
Объект с описанием пользователей — наблюдателей за задачей. Ключ объекта — идентификатор пользователя, а значение — объект с описанием пользователя |
|
|
newCommentsCount |
Количество новых комментариев |
|
|
action |
Объект с описанием доступных действий над задачей |
|
|
checkListTree |
Объект с описанием дерева чек-листа |
|
|
checkListCanAdd |
Можно ли добавлять пункты чек-листа |
|
|
ufCrmTask |
Список привязок к элементам CRM в формате:
|
|
|
ufTaskWebdavFiles |
Список файлов с Диска |
|
|
ufMailMessage |
Письмо email |
|
|
UF_* |
Пользовательские поля. Подробнее в статье Пользовательские поля в задачах: обзор методов |
Чтобы получить пользовательские поля задачи, используйте методы выборки tasks.task.get и tasks.task.list. Укажите нужные поля в параметре SELECT.
Системные поля UF_CRM_TASK, UF_TASK_WEBDAV_FILES и UF_MAIL_MESSAGE не возвращаются по умолчанию. Укажите одно из этих полей в SELECT — вернутся все три. В ответе поля возвращаются в camelCase: ufCrmTask, ufTaskWebdavFiles, ufMailMessage.
Объект checklist.item
|
Название |
Описание |
|
id |
Идентификатор пункта |
|
taskId |
Идентификатор задачи |
|
createdBy |
Идентификатор автора пункта |
|
parentId |
Родительский пункт. Значение |
|
title |
Заголовок пункта |
|
sortIndex |
Индекс сортировки |
|
isComplete |
Признак завершенности. Возможные значения:
|
|
isImportant |
Признак важности. Возможные значения:
|
|
toggledBy |
Идентификатор пользователя, изменившего статус пункта |
|
toggledDate |
Дата изменения статуса пункта в формате |
|
ufChecklistFiles |
Признак наличия файлов в пункте |
|
members |
Список участников пункта |
|
attachments |
Список вложений пункта |
|
entityId |
Идентификатор задачи |
|
action |
Объект с описанием доступных действий над пунктом |
Объект checklist.item.action
|
Название |
Описание |
|
modify |
Доступно изменение пункта |
|
remove |
Доступно удаление пункта |
|
toggle |
Доступно переключение статуса пункта |
|
add |
Доступно добавление подпункта |
|
addAccomplice |
Доступно добавление соисполнителя в пункт |
Объект group
|
Название |
Описание |
|
id |
Идентификатор группы |
|
name |
Название группы |
|
opened |
Признак открытой группы |
|
membersCount |
Количество участников группы |
|
image |
URL изображения группы |
|
additionalData |
Дополнительные данные группы |
Объект с описанием пользователя
|
Название |
Описание |
|
id |
Идентификатор пользователя |
|
name |
Имя и фамилия пользователя |
|
link |
Ссылка на профиль пользователя |
|
icon |
URL аватара пользователя |
|
workPosition |
Должность пользователя |
Объект action
|
Название |
Описание |
|
accept |
Доступно принять задачу. Устаревшее поле, больше не используется |
|
decline |
Доступно отказаться от задачи. Устаревшее поле, больше не используется |
|
complete |
Доступно завершить задачу |
|
approve |
Доступно принять работу исполнителя по задаче при включенном контроле |
|
disapprove |
Доступно выбрать, что исполнителю нужно доделать работу по задаче при включенном контроле |
|
start |
Доступно начать выполнение |
|
pause |
Доступно приостановить выполнение |
|
delegate |
Доступно делегирование |
|
remove |
Доступно удаление задачи |
|
edit |
Доступно редактирование |
|
defer |
Доступно отложить задачу |
|
renew |
Доступно возобновление |
|
create |
Доступно создание связанных задач |
|
changeDeadline |
Доступно изменение крайнего срока |
|
checklistAddItems |
Доступно добавление пунктов чек-листа |
|
addFavorite |
Доступно добавление в избранное |
|
deleteFavorite |
Доступно удаление из избранного |
|
rate |
Доступно выставление оценки |
|
take |
Доступно взять задачу в работу |
|
edit.originator |
Доступно редактирование постановщика |
|
checklist.reorder |
Доступна смена порядка пунктов чек-листа |
|
elapsedtime.add |
Доступно добавление трудозатрат |
|
dayplan.timer.toggle |
Доступно управление таймером в плане на день |
|
edit.plan |
Доступно редактирование плановых параметров |
|
checklist.add |
Доступно добавление чек-листа |
|
favorite.add |
Доступно добавление в избранное |
|
favorite.delete |
Доступно удаление из избранного |
Объект checkListTree
|
Название |
Описание |
|
nodeId |
Идентификатор корневого узла дерева чек-листа |
|
fields |
Объект с описанием полей узла |
|
action |
Массив доступных действий для узла |
|
descendants |
Массив дочерних узлов |
Объект checkListTree.fields
|
Название |
Описание |
|
id |
Идентификатор пункта для корня |
|
copiedId |
Идентификатор источника при копировании |
|
entityId |
Идентификатор задачи |
|
userId |
Идентификатор пользователя, формирующего дерево |
|
createdBy |
Идентификатор автора пункта |
|
parentId |
Идентификатор родителя |
|
title |
Заголовок пункта |
|
sortIndex |
Индекс сортировки |
|
displaySortIndex |
Отображаемый индекс сортировки |
|
isComplete |
Признак завершенности пункта |
|
isImportant |
Признак важности пункта |
|
completedCount |
Количество завершенных подпунктов |
|
members |
Массив участников пункта |
|
attachments |
Массив вложений пункта |
|
nodeId |
Идентификатор узла |