Документация для разработчиков
Темная тема

tasks.task.get

Scope: task Права на выполнение: для всех

Описание и пример

Возвращает информацию о конкретной задаче.

Внимание! Необходимо указать поля в select, т.к. поля по умолчанию могут быть изменены в будущем.

Примеры

BX24.callMethod(
	'tasks.task.get', 
	{taskId:1, select:['ID','TITLE']}, 
	function(res){console.log(res.answer.result);}
);

Для получения тэгов конкретной задачи:

BX24.callMethod(
	'tasks.task.get',
	{taskId:1367, select:['TAGS']},
	function(res){console.log(res.answer.result);}
);

Синтаксис для выборки всех полей:

BX24.callMethod(
	'tasks.task.get',
	{taskId:1367, select:['*']},
	function(res){console.log(res.answer.result);}
)

Параметры

ПараметрОписание
taskIdИдентификатор задачи.
selectМассив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы.

Поле может принимать значения:
  • ID - идентификатор задачи;
  • PARENT_ID - идентификатор родительской задачи;
  • TITLE - название задачи;
  • DESCRIPTION - описание;
  • MARK - оценка;
  • PRIORITY - приоритет:
    • 0 - низкий;
    • 1 - средний;
    • 2 - высокий.
  • STATUS - статус;
  • MULTITASK - множественная задача;
  • NOT_VIEWED - непросмотренная задача;
  • REPLICATE - повторяемая задача;
  • GROUP_ID - рабочая группа. 
  • STAGE_ID - стадия;
  • CREATED_BY - постановщик;
  • CREATED_DATE - дата создания;
  • RESPONSIBLE_ID - исполнитель;
  • ACCOMPLICE - идентификатор соисполнителя;
  • AUDITOR - идентификатор наблюдателя
  • CHANGED_BY - кем изменена задача;
  • CHANGED_DATE - дата изменения;
  • STATUS_CHANGED_DATE - кто изменил статус;
  • CLOSED_BY - кто закрыл задачу;
  • CLOSED_DATE - дата закрытия задачи;
  • DATE_START - дата начала;
  • DEADLINE - крайний срок;
  • START_DATE_PLAN - плановое начало;
  • END_DATE_PLAN - плановое завершение;
  • GUID - GUID (статистически уникальный 128-битный идентификатор);
  • XML_ID - внешний код;
  • COMMENTS_COUNT - количество комментариев;
  • NEW_COMMENTS_COUNT - количество новых комментариев;
  • TASK_CONTROL - принять в работу;
  • ADD_IN_REPORT - добавить в отчет;
  • FORKED_BY_TEMPLATE_ID - создано автоматически из шаблона;
  • TIME_ESTIMATE - затраченное время;
  • TIME_SPENT_IN_LOGS - затраченное время из истории изменений;
  • MATCH_WORK_TIME - пропустить выходные дни;
  • FORUM_TOPIC_ID - идентификатор темы форума;
  • FORUM_ID - идентификатор форума;
  • SITE_ID - идентификатор сайта;
  • SUBORDINATE - задача подчиненного;
  • FAVORITE - Избранное;
  • VIEWED_DATE - дата последнего просмотра;
  • SORTING - индекс сортировки;
  • DURATION_PLAN - затрачено (план);
  • DURATION_FACT - затрачено (фактически);
  • DURATION_TYPE - Тип продолжительности:
    • 0 - секунды
    • 1 - минуты
    • 2 - часы
    • 3 - дни
    • 4 - недели
    • 5 - месяцы
    • 6 - года
  • UF_CRM_TASK - привязка к элементам CRM.

По умолчанию будут возвращены все невычисляемые поля основной таблицы запроса.

Для получения пользовательских полей и поля привязки к CRM сущностям (UF_CRM_TASK), их нужно будет напрямую указать в SELECT. Список полей можно уточнить, отправив запрос tasks.task.getFields.



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Тимур Шаехов
Сообщение не промодерировано, возможны ошибки и неточности.
Цитата
пишет:
Подскажите пожалуйста, какой идентификатор у параметра отвечает за связывание задач?  
тоже интересует ответ на данный вопрос
2
Дмитрий Семёнов
Сообщение не промодерировано, возможны ошибки и неточности.
Подскажите пожалуйста, какой идентификатор у параметра отвечает за связывание задач?  
1
Андрей Федин
Цитата
Александр Лякин пишет:
Скажите, пожалуйста, как используя новые методы API  вместо task.item.getdata Получить поле, например "TAGS" ?
В документации не нашёл...  
Для получения тэгов конкретной задачи необходимо передать параметр /rest/task.item.gettags.xml?TASK_ID=3&auth=18tci5kga6v12g8okzm5r26sv0n9is84. Запрос может быть как ID, так и TASK_ID. Принципиально, чтобы этот параметр был первым. В ответ вернётся {"result":["TAG1","TAG2","ETC..."]}
© «Битрикс», 2001-2024, «1С-Битрикс», 2024