task.items.getlist
Scope: task Права на выполнение: для всех
Описание
Возвращает массив задач, каждая из которых содержит массив полей (аналогичен массиву, возвращаемому task.item.getdata).
Параметры
Параметр | Описание |
---|---|
ORDER | Массив для сортировки результата. Массив вида {"поле_сортировки": 'направление сортировки' [, ...]}.
Поле для сортировки может принимать значения:
Примечание. Допускается сортировка по пользовательским полям. |
FILTER | Массив вида {"фильтруемое_поле": "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения:
"значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются. |
TASKDATA | Массив возвращаемых полей задачи. |
NAV_PARAMS | Постраничная навигация. Доступны следующие опции:
|
Внимание! Соблюдение порядка следования параметров в запросе обязательно. При его нарушении запрос будет выполнен с ошибками.
Примеры
// Получим список всех задач (по умолчанию сработает ограничение — постраничка по 50 элементов) BX24.callMethod( 'task.items.getlist', [], function(result) { console.info(result.data()); console.log(result); } );
// Получим список задач с идентификаторами 1,2,3,4,5,6. Причем выберем только поля ID и TITLE. // Режим постранички — по 2 элемента на странице, 2-ая страница. // Сортировка по ID — по убыванию. BX24.callMethod( 'task.items.getlist', [ {ID : 'desc'}, // Сортировка по ID — по убыванию. {ID: [1,2,3,4,5,6]}, // Фильтр ['ID', 'TITLE'], // Выбираемые поля { NAV_PARAMS: { // постраничка iNumPage : 2 // страница номер 2 } } ], function(result) { console.info(result.data()); console.log(result); } );
Примечание: В целях ограничения нагрузки на постраничную навигацию наложено ограничение в 50 задач.
Alexey Andreev
|
||
PHP: поиск задачи по заголовку
| ||
Ян Швейковский
|
||
Примеры фильтра по TITLE с применением шаблона
| ||
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.