Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Поля задачи», проанализируем лучшие практики и покажем, как правильно использовать поля задачи в реальных задачах.

Поля задачи

Написать статью, в ней должно быть написано какие поля можно модифицировать, какие только читать. Упомянуть, что системные поля модифицируются только с админскими правами и почему. Отдельно указать, как реализуется связь с CRM

Тут может не хватать некоторых данных — дополним в ближайшее время

Запись и изменение полей производится согласно бизнес-логике и с учетом прав пользователя. То есть зависит от роли пользователя, настроек прав на группу, иерархии, статуса задачи и некоторых флагов в задаче, например, allowChangeDeadline.

Название `тип`	Описание
id `string`	Идентификатор задачи
parentId `string`	Идентификатор родительской задачи. Имеет значение `null`, если родительской задачи нет
title `string`	Название задачи
description `string`	Описание задачи
chatId `integer`	Идентификатор чата для новой карточки задачи
mark `string`	Оценка задачи. Возможные значения: `N` — отрицательная `P` — положительная `null` — без оценки
priority `string`	Приоритет задачи. Возможные значения: — `2` — высокий — `1` — средний — `0` — низкий
multitask `string`	Признак «базовая задача с подзадачами». Возможные значения: — `Y` — да — `N` — нет
notViewed `string`	Признак «не просмотрено». Возможные значения: — `Y` — не просмотрено — `N` — просмотрено
replicate `string`	Признак «повторять задачу». Возможные значения: — `Y` — да, сделать задачу регулярной — `N` — не повторять
stageId `string`	Идентификатор стадии
sprintId `string`	Идентификатор спринта
backlogId `string`	Идентификатор бэклога
createdBy `string`	Идентификатор постановщика
createdDate `string`	Дата создания в формате `ISO 8601`
responsibleId `string`	Идентификатор ответственного
changedBy `string`	Идентификатор пользователя, изменившего задачу
changedDate `string`	Дата изменения в формате `ISO 8601`
statusChangedBy `string`	Идентификатор пользователя, изменившего статус задачи
closedBy `string`	Идентификатор пользователя, завершившего задачу. Имеет значение `0`, если задача не завершена
closedDate `string`	Дата завершения в формате `ISO 8601`. Имеет значение `null`, если задача не завершена
activityDate `string`	Дата последней активности в формате `ISO 8601`
dateStart `string`	Дата начала
deadline `string`	Крайний срок
startDatePlan `string`	Плановая дата начала
endDatePlan `string`	Плановая дата окончания
guid `string`	Идентификатор `GUID` задачи
xmlId `string`	Внешний идентификатор
commentsCount `string`	Количество комментариев
serviceCommentsCount `string`	Количество системных комментариев
allowChangeDeadline `string`	Разрешено менять крайний срок. Возможные значения: — `Y` — разрешено — `N` — не разрешено
allowTimeTracking `string`	Разрешено учитывать время. Возможные значения: — `Y` — разрешено — `N` — не разрешено
taskControl `string`	Контроль задачи включен. Возможные значения: — `Y` — включен — `N` — отключен
addInReport `string`	Добавлять в отчет. Возможные значения: — `Y` — добавлять — `N` — не добавлять
forkedByTemplateId `string`	Идентификатор шаблона, если задача создана из шаблона
timeEstimate `string`	Оценка времени в секундах
timeSpentInLogs `string`	Фактически затраченное время
matchWorkTime `string`	Учитывать рабочее время. Возможные значения: — `Y` — да — `N` — нет
forumTopicId `string`	Идентификатор темы комментариев
forumId `string`	Идентификатор форума
siteId `string`	Идентификатор сайта
subordinate `string`	Признак того, что задача я вляется подзадачей. Возможные значения: — `Y` — да — `N` — нет
exchangeModified `string`	Дата изменения синхронизацией в формате `ISO 8601`
exchangeId `string`	Идентификатор синхронизации
outlookVersion `string`	Версия
viewedDate `string`	Дата просмотра задачи в формате `ISO 8601`
sorting `string`	Значение сортировки
durationFact `string`	Фактическая длительность
isMuted `string`	Признак «без звука». Возможные значения: — `Y` — включен — `N` — выключен
isPinned `string`	Признак «закреплено». Возможные значения: — `Y` — включен — `N` — выключен
isPinnedInGroup `string`	Признак «закреплена в группе». Возможные значения: — `Y` — закреплена — `N` — не закреплена
flowId `string`	Идентификатор потока
descriptionInBbcode `string`	Описание в формате BBCode. Возможные значения: — `Y` — включено — `N` — выключено
status `string`	Статус задачи. Возможные значения: — `2` — ждет выполнения — `3` — выполняется — `4` — ожидает контроля — `5` — завершена — `6` — отложена
statusChangedDate `string`	Дата изменения статуса в формате `ISO 8601`
durationPlan `string`	Плановая длительность
durationType `string`	Единица плановой длительности. Возможные значения: `secs`, `mins`, `hours`, `days`, `weeks`, `monts`, `years`
favorite `string`	Признак «в избранном». Возможные значения: — `Y` — добавлено в избранное — `N` — не добавлено в избранное
groupId `string`	Идентификатор группы, к которой привязана задача
auditors `array`	Список идентификаторов пользователей — наблюдателей за задачей
accomplices `array`	Список идентификаторов пользователей — соисполнителей
checklist `object`	Объект с пунктами чек-листа. Ключ — идентификатор пункта, значение — объект с описанием пункта
group `object`	Объект с описанием группы
creator `object`	Объект с описанием пользователя — постановщика задачи
responsible `object`	Объект с описанием пользователя — ответственного за задачу
accomplicesData `array`	Объект с описанием пользователей — соисполнителей. Ключ объекта — идентификатор пользователя, а значение — объект с описанием пользователя
auditorsData `object`	Объект с описанием пользователей — наблюдателей за задачей. Ключ объекта — идентификатор пользователя, а значение — объект с описанием пользователя
newCommentsCount `integer`	Количество новых комментариев
action `object`	Объект с описанием доступных действий над задачей
checkListTree `object`	Объект с описанием дерева чек-листа
checkListCanAdd `boolean`	Можно ли добавлять пункты чек-листа
UF_CRM_TASK `array`	Список привязок к элементам CRM в формате: — `L_XX` — лид, — `D_XX` — сделка — `C_XX` — контакт — `CO_XX` — компания — `SI_XX` — счет — `TXX_XX` — смарт-процесс
UF_TASK_WEBDAV_FILES `array`	Список файлов с Диска
UF_MAIL_MESSAGE `string`	Письмо email
UF_\ `any`	Пользовательские поля. Подробнее в статье [](./user-field/index)

Чтобы получить пользовательские поля задачи, используйте методы выборки tasks.task.get и tasks.task.list. Укажите нужные поля в параметре SELECT. Таким же образом можно получить системные пользовательские поля: UF_CRM_TASK, UF_TASK_WEBDAV_FILES, UF_MAIL_MESSAGE.

Объект checklist.item {#checklist-item}

Название `тип`	Описание
id `string`	Идентификатор пункта
taskId `string`	Идентификатор задачи
createdBy `string`	Идентификатор автора пункта
parentId `string`	Родительский пункт. Значение `0` означает корневой пункт
title `string`	Заголовок пункта
sortIndex `string`	Индекс сортировки
isComplete `string`	Признак завершенности. Возможные значения: — `Y` — пункт выполнен — `N` — пункт не выполнен
isImportant `string`	Признак важности. Возможные значения: — `Y` — важный — `N` — не важный
toggledBy `string`	Идентификатор пользователя, изменившего статус пункта
toggledDate `string`	Дата изменения статуса пункта в формате `ISO 8601`
ufChecklistFiles `boolean`	Признак наличия файлов в пункте
members `array`	Список участников пункта
attachments `array`	Список вложений пункта
entityId `string`	Идентификатор задачи
action `object`	Объект с описанием доступных действий над пунктом

Объект checklist.item.action {#checklist-item-action}

Название `тип`	Описание
modify `boolean`	Доступно изменение пункта
remove `boolean`	Доступно удаление пункта
toggle `boolean`	Доступно переключение статуса пункта
add `boolean`	Доступно добавление подпункта
addAccomplice `boolean`	Доступно добавление соисполнителя в пункт

Объект group {#group}

Название `тип`	Описание
id `string`	Идентификатор группы
name `string`	Название группы
opened `boolean`	Признак открытой группы
membersCount `integer`	Количество участников группы
image `string`	URL изображения группы
additionalData `array`	Дополнительные данные группы

Объект с описанием пользователя {#user}

Название `тип`	Описание
id `string`	Идентификатор пользователя
name `string`	Имя и фамилия пользователя
link `string`	Ссылка на профиль пользователя
icon `string`	URL аватара пользователя
workPosition `string`	Должность пользователя

Объект action {#action}

Название `тип`	Описание
accept `boolean`	Доступно принять задачу. Устаревшее поле, больше не используется
decline `boolean`	Доступно отказаться от задачи. Устаревшее поле, больше не используется
complete `boolean`	Доступно завершить задачу
approve `boolean`	Доступно принять работу исполнителя по задаче при включенном контроле `taskControl`
disapprove `boolean`	Доступно выбрать, что исполнителю нужно доделать работу по задаче при включенном контроле `taskControl`
start `boolean`	Доступно начать выполнение
pause `boolean`	Доступно приостановить выполнение
delegate `boolean`	Доступно делегирование
remove `boolean`	Доступно удаление задачи
edit `boolean`	Доступно редактирование
defer `boolean`	Доступно отложить задачу
renew `boolean`	Доступно возобновление
create `boolean`	Доступно создание связанных задач
changeDeadline `boolean`	Доступно изменение крайнего срока
checklistAddItems `boolean`	Доступно добавление пунктов чек-листа
addFavorite `boolean`	Доступно добавление в избранное
deleteFavorite `boolean`	Доступно удаление из избранного
rate `boolean`	Доступно выставление оценки
take `boolean`	Доступно взять задачу в работу
edit.originator `boolean`	Доступно редактирование постановщика
checklist.reorder `boolean`	Доступна смена порядка пунктов чек-листа
elapsedtime.add `boolean`	Доступно добавление трудозатрат
dayplan.timer.toggle `boolean`	Доступно управление таймером в плане на день
edit.plan `boolean`	Доступно редактирование плановых параметров
checklist.add `boolean`	Доступно добавление чек-листа
favorite.add `boolean`	Доступно добавление в избранное
favorite.delete `boolean`	Доступно удаление из избранного

Объект checkListTree {#checklisttree}

Название `тип`	Описание
nodeId `integer`	Идентификатор корневого узла дерева чек-листа
fields `object`	Объект с описанием полей узла
action `array`	Массив доступных действий для узла
descendants `array`	Массив дочерних узлов

Объект checkListTree.fields {#checklisttree-fields}

Название `тип`	Описание
id `string`	Идентификатор пункта для корня
copiedId `string`	Идентификатор источника при копировании
entityId `string`	Идентификатор задачи
userId `integer`	Идентификатор пользователя, формирующего дерево
createdBy `string`	Идентификатор автора пункта
parentId `string`	Идентификатор родителя
title `string`	Заголовок пункта
sortIndex `string`	Индекс сортировки
displaySortIndex `string`	Отображаемый индекс сортировки
isComplete `boolean`	Признак завершенности пункта
isImportant `boolean`	Признак важности пункта
completedCount `integer`	Количество завершенных подпунктов
members `array`	Массив участников пункта
attachments `array`	Массив вложений пункта
nodeId `string`	Идентификатор узла

Поле / Тип	Описание	Значение
ID `integer`	Идентификатор задачи.
PARENT_ID `integer`	ID родительской задачи.	По умолчанию — 0
TITLE^^ `string`	Название. Длина поля TITLE не должна превышать 460 символов. В противном случае название задачи без предупреждения будет обрезано с конца.
DESCRIPTION `string`	Описание.
MARK `enum`	Оценка.	N — Отрицательная, P — Положительная. По умолчанию — null
PRIORITY `enum`	Приоритет.	2 — Высокий, 1 — Средний, 0 — Низкий. По умолчанию — 1
STATUS `enum`	Статус.	2 — Ждет выполнения, 3 — Выполняется, 4 — Ожидает контроля, 5 — Завершена, 6 — Отложена. По умолчанию — 2
MULTITASK `enum`	Множественная задача.	Y — Да, N — Нет. По умолчанию — Нет.
NOT_VIEWED `enum`	NOT_VIEWED	Y — Да, N — Нет. По умолчанию — Нет.
REPLICATE `enum`	Повторяемая задача.	Y — Да, N — Нет. По умолчанию — Нет.
GROUP_ID `integer`	Группа или проект	По умолчанию — 0
FLOW_ID `integer`	Поток	null
STAGE_ID `integer`	Стадия.	По умолчанию — 0
CREATED_BY^^ `integer`	Постановщик.
CREATED_DATE `datetime`	Дата создания.
RESPONSIBLE_ID^^ `integer`	Исполнитель.
ACCOMPLICES `array`	Соисполнители.
AUDITORS `array`	Наблюдатели.
CHANGED_BY `integer`	Изменил.
CHANGED_DATE `integer`	Дата изменения.
STATUS_CHANGED_BY `integer`	Изменил статус.
CLOSED_BY `integer`	Закрыл задачу.
CLOSED_DATE `datetime`	Дата закрытия.
DATE_START `datetime`	Дата начала.	null
DEADLINE `datetime`	Крайний срок.	null
START_DATE_PLAN `datetime`	Плановое начало.	null
END_DATE_PLAN `datetime`	Плановое завершение.	null
GUID `string`	GUID	null
XML_ID `string`	XML_ID	null
COMMENTS_COUNT `integer`	Кол-во комментариев
NEW_COMMENTS_COUNT `integer`	Кол-во новых комментариев.
ALLOW_CHANGE_DEADLINE `enum`	Разрешить менять сроки.	Y — Да, N — Нет. По умолчанию — Нет.
ALLOW_TIME_TRACKING `enum`	Разрешить учет времени для задачи	Y — Да, N — Нет. По умолчанию — Нет.
TASK_CONTROL `enum`	Принять работу.	Y — Да, N — Нет. По умолчанию — Нет.
ADD_IN_REPORT `enum`	Добавить в отчёт.	Y — Да, N — Нет. По умолчанию — Нет.
FORKED_BY_TEMPLATE_ID `enum`	Создано из шаблона.	Y — Да, N — Нет. По умолчанию — Нет.
TIME_ESTIMATE `integer`	Время, выделенное на задачу.
TIME_SPENT_IN_LOGS `integer`	Затраченное время из истории изменений.
MATCH_WORK_TIME `integer`	Пропустить выходные дни.
FORUM_TOPIC_ID `integer`	Идентификатор темы форума.
FORUM_ID `integer`	Идентификатор форума.
SITE_ID `string`	Идентификатор сайта.
SUBORDINATE `enum`	Задача подчиненного.	Y — Да, N — Нет. По умолчанию — Нет.
FAVORITE `enum`	Добавлен в Избранное.
EXCHANGE_MODIFIED `datetime`	EXCHANGE_MODIFIED	null
EXCHANGE_ID `integer`	EXCHANGE_ID	null
OUTLOOK_VERSION `integer`	OUTLOOK_VERSION	null
VIEWED_DATE `datetime`	Дата последнего просмотра.
SORTING `double`	Индекс сортировки.
DURATION_PLAN `integer`	Затрачено (план).
DURATION_FACT `integer`	Затрачено (фактически).
CHECKLIST `array`	Чеклист.
DURATION_TYPE `enum`	DURATION_TYPE.	\[0\] => secs \[1\] => mins \[2\] => hours \[3\] => days \[4\] => weeks \[5\] => monts \[6\] => years. По умолчанию — 3
UF_CRM_TASK `crm`	Привязка к элементам CRM L_XX — lead, C_XX — contact , D_XX — deal
UF_TASK_WEBDAV_FILES `disk_file`	Файл (Диск).
UF_MAIL_MESSAGE `mail_message`	Письмо (email).
IS_MUTED `enum`	Уведомления.	Y — Да, N — Нет. По умолчанию — Нет.
IS_PINNED `enum`	Закреплён.	Y — Да, N — Нет. По умолчанию — Нет.
IS_PINNED_IN_GROUP `enum`	Закреплён в группе.	Y — Да, N — Нет. По умолчанию — Нет.
SERVICE_COMMENTS_COUNT `integer`	SERVICE_COMMENTS_COUNT

Поля даты/времени, которые читаются/записываются в формате ISO 8601:**

DEADLINE
START_DATE_PLAN
END_DATE_PLAN
DATE_START
CREATED_DATE
CLOSED_DATE
CHANGED_DATE
STATUS_CHANGED_DATE
VIEWED_DATE

💡 Экспертное мнение и рекомендации

Практические рекомендации:

При написании кастомных компонентов для «Поля задачи» всегда разделяйте бизнес-логику и представление (шаблон).
Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Написать во ВКонтакте

или на почту: gorandvas@yandex.ru

Поля задачи

Поля задачи

Объект checklist.item {#checklist-item}

Объект checklist.item.action {#checklist-item-action}

Объект group {#group}

Объект с описанием пользователя {#user}

Объект action {#action}

Объект checkListTree {#checklisttree}

Объект checkListTree.fields {#checklisttree-fields}

💡 Экспертное мнение и рекомендации

Практические рекомендации:

Помогу автоматизировать процессы и внедрить ИИ

Related Post

Отраслевые CRMОтраслевые CRM

Перевести задачу в статус «не выполняется» task.item.renewПеревести задачу в статус «не выполняется» task.item.renew

Как использовать метод SDK voximplant.line.get в Битрикс24Как использовать метод SDK voximplant.line.get в Битрикс24