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

tasks.task.get

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

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

Параметры

ПараметрОписание
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.

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

Список полей можно уточнить, отправив запрос tasks.task.getFields.

Примеры

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

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

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

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

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

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