tasks.task.list
Описание
Возвращает массив задач, каждая из которых содержит массив полей. В отличие от task.item.list параметры в запросе tasks.task.list можно указывать в любом порядке, а также можно не указывать ненужные параметры.
Для получения данных по всем задачам пользователь должен обладать админскими правами. Руководитель подразделения получит доступ только к задачам в своей ветке иерархии.
Также можно получить задачи в "Избранном", установив фильтрацию по параметру $filter[::SUBFILTER-PARAMS][FAVORITE]=Y.
Внимание! Необходимо указать поля в select, т.к. поля по умолчанию могут быть изменены в будущем.
Параметры
| Параметр | Описание |
|---|---|
| order | Массив для сортировки результата. Массив вида {"поле_сортировки": 'направление сортировки' [, ...]}.
Поле для сортировки может принимать значения:
Примечание: В коробочной версии этот список полей для сортировки можно вернуть методом CTasks::getAvailableOrderFields().
Направление сортировки может принимать значения:
|
| filter | Массив вида {"фильтруемое_поле": "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения:
"значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются. |
| select | Массив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы.
Поле сортировки может принимать значения:
По умолчанию будут возвращены все невычисляемые поля основной таблицы запроса. Список полей можно уточнить, отправив запрос tasks.task.getFields. |
| limit | Число записей. Параметр указывается, если нужно получить число записей более значения по умолчанию (50). |
Примеры
- Вывод всех задач с названием "task for test", отбор по полям
ID,TITLE,STATUS, сортировка по полюID(сортировка по возрастанию):BX24.callMethod( 'tasks.task.list', {filter:{TITLE:'task for test'}, select: ['ID','TITLE','STATUS'], order:{ID:'asc'}}, function(res){console.log(res.answer.result);} );Результат:
- Вывод всех неповторяющихся задач, добавленных в "Избранное", у которых статус больше 2:
BX24.callMethod( 'tasks.task.list', {filter:{'>STATUS':2, REPLICATE:'N', '::SUBFILTER-PARAMS':{FAVORITE:'Y'}}}, function(res){console.log(res.answer.result);} );Результат:
result: { tasks: [ { id: "117", parentId: null, title: "123", description: "Opisanie. Ghhhhh", mark: null, priority: "0", status: "6", multitask: "N", notViewed: "N", replicate: "N", groupId: "0", stageId: "0", createdBy: "1", createdDate: "2019-03-15T15:41:27+02:00", responsibleId: "1", changedBy: "1", changedDate: "2019-03-18T14:06:18+02:00", statusChangedBy: "1", statusChangedDate: "2019-03-18T14:05:54+02:00", closedBy: null, closedDate: null, dateStart: null, deadline: null, startDatePlan: null, endDatePlan: null, guid: "{aef54f9d-8157-464b-9069-6ded9745e26d}", xmlId: null, commentsCount: null, taskControl: "Y", addInReport: "N", forkedByTemplateId: null, timeEstimate: "0", timeSpentInLogs: null, matchWorkTime: "N", forumTopicId: null, forumId: null, siteId: "s1", subordinate: "Y", favorite: "Y", exchangeModified: null, exchangeId: null, outlookVersion: "7", viewedDate: "2019-03-18T14:07:08+02:00", sorting: "2564.0000000", durationPlan: "0", durationFact: null, durationType: "days", descriptionInBbcode: "Y", ufCrmTask: [ ], ufTaskWebdavFiles: [ 22 ], ufAuto915658270214: null, ufAuto244510721805: null, ufAuto637823431651: "0", ufMailMessage: null, ufAuto226929532613: "", ufAuto187628303463: null, auditors: [ ], accomplices: [ ], newCommentsCount: 0, subStatus: "6", creator: { id: "1", name: "Гречушников Максим", link: "/company/personal/user/1/", icon: "/upload/resize_cache/main/9b0/58_58_2/p2dVDwA46Nw.png", }, responsible: { id: "1", name: "Гречушников Максим", link: "/company/personal/user/1/", icon: "/upload/resize_cache/main/9b0/58_58_2/p2dVDwA46Nw.png", }, } ] },
Сообщение непромодерировано, возможны ошибки и неточности.
| ||||
|
Как достать просроченные задачи?
в PHP
 | ||||
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
|
вот что мне ответила техподдержка по поводу лимита
| ||
|
Сообщение непромодерировано, возможны ошибки и неточности.
| ||||
Надо получить все порции, вот пример на JS:
| ||||
|
Сообщение непромодерировано, возможны ошибки и неточности.
|
|
Как получить больше 50?
все перепробовал 50 и все $method = 'tasks.task.list'; $queryUrl = 'https://'.$_REQUEST['DOMAIN'].'/rest/'.$method.'.json'; $params = [ 'select' => ['ID', 'TITLE'], ]; как реализовать вывод больше 50 |
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
"filter" => array('>=CREATED_DATE' => '01.09.2019') ); $appRequestUrl = '?' . http_build_query($appParams); print(urldecode($appRequestUrl)); | ||
|
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
|
Подскажите, пожалуйста: как в вебхуке в GET-запросе указать фильтрацию по дате?
При "Дата больше ..." что-то типа такого:
| ||
|
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
Вопрос к разработчикам: верно ли я понимаю, что при использовании limit можем отказаться от batch? | ||
|
Сообщение непромодерировано, возможны ошибки и неточности.
|
|
Метод пока не работает корректно. Отображаются только задачи в которых участвует админ.
По заявлением тех. поддержки, пока в разработке. 0cb32598-fb8d-4af6-9324-b0445f58d37e.png (75.44 КБ) |
|
Сообщение непромодерировано, возможны ошибки и неточности.
|
|
limit не работает. REST игнорирует его присутствие. Сколько бы не указывалось, отдается 50
|
© «Битрикс»,
2001-2020,
«1С-Битрикс», 2020
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.