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). Все записи одним запросом вернуть нет возможности, это ограничение всех методов REST API. Вы можете несколькими запросами по 50 записей в ответе получить все лиды. Для этого просто передавайте параметр start со значением, кратным 50. Пример:
start=0 start=50 start=100 |
Примеры
- Вывод всех задач с названием "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", }, } ] },
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
| ||
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
Если нужно выбрать все задачи компании (7658 - ID компании) | ||
|
Сообщение непромодерировано, возможны ошибки и неточности.
| ||||
|
Как достать просроченные задачи?
в PHP
 | ||||
|
Сообщение непромодерировано, возможны ошибки и неточности.
| ||||
Надо получить все порции, вот пример на JS:
| ||||
Сообщение непромодерировано, возможны ошибки и неточности.
| ||
"filter" => array('>=CREATED_DATE' => '01.09.2019') ); $appRequestUrl = '?' . http_build_query($appParams); print(urldecode($appRequestUrl)); | ||
© «Битрикс»,
2001-2021,
«1С-Битрикс», 2021
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.