метод REST scope: task Устаревший

task.item.list

Получить список задач

Устаревший метод. Развитие метода остановлено. Используйте tasks.task.list.

Кто может выполнять: любой пользователь

Описание

Метод task.item.list возвращает массив задач, каждая из которых содержит массив полей (аналогичен массиву, возвращаемому task.item.getdata).

Параметры

ORDER object необязательный

Массив вида {'поле_сортировки': 'направление сортировки' [, ...]} для сортировки результата. Поле для сортировки может принимать значения:
- TITLE — название задачи
- DATE_START — дата старта
- DEADLINE — крайний срок
- STATUS — статус
- PRIORITY — приоритет
- MARK — оценка
- CREATED_BY — постановщик
- RESPONSIBLE_ID — исполнитель
- GROUP_ID — рабочая группа

Направление сортировки может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

FILTER object необязательный

Массив вида {'фильтруемое_поле': 'значение фильтра' [, ...]}. Фильтруемое поле может принимать значения:
- ID — идентификатор задачи
- PARENT_ID — идентификатор родительской задачи
- GROUP_ID — идентификатор рабочей группы
- CREATED_BY — постановщик
- STATUS_CHANGED_BY — пользователь, последним изменивший статус задачи
- PRIORITY — приоритет
- FORUM_TOPIC_ID — идентификатор темы форума
- RESPONSIBLE_ID — исполнитель
- TITLE — название задачи (можно искать по шаблону [%_])
- TAG — тег
- REAL_STATUS — статус задачи. Константы, отражающие статусы задач:
- STATE_NEW = 1
- STATE_PENDING = 2
- STATE_IN_PROGRESS = 3
- STATE_SUPPOSEDLY_COMPLETED = 4
- STATE_COMPLETED = 5
- STATE_DEFERRED = 6
- STATE_DECLINED = 7
- STATUS — статус для сортировки. Аналогичен REAL_STATUS, но имеет дополнительно два мета-статуса:
- -2 — непросмотренная задача
- -1 — просроченная задача
- MARK — оценка
- SITE_ID — идентификатор сайта
- ADD_IN_REPORT — задача в отчете (Y|N)
- DATE_START — дата начала выполнения
- DEADLINE — крайний срок
- CREATED_DATE — дата создания
- CLOSED_DATE — дата завершения
- CHANGED_DATE — дата последнего изменения
- ACCOMPLICE — идентификатор соисполнителя
- AUDITOR — идентификатор аудитора
- DEPENDS_ON — идентификатор предыдущей задачи
- ONLY_ROOT_TASKS — только задачи, которые не являются подзадачами (корневые задачи), а также подзадачи родительской задачи, к которой текущий пользователь доступа не имеет (Y|N)

Перед названием фильтруемого поля может указать тип фильтрации:
- ! — не равно
- < — меньше
- <= — меньше либо равно
- > — больше
- >= — больше либо равно

Значения фильтра — одиночное значение или массив.

Необязательный параметр. По умолчанию записи не фильтруются.

Для метода task.item.list обязательно нужно указывать сортировку для фильтрации. Фильтрация без сортировки возвращает все задачи

PARAMS array необязательный

Массив для опций вызова. Элементом является массив NAV_PARAMS вида {'опция вызова': 'значение' [, ...]}, хранящий следующие опции:
- nPageSize — количество элементов на странице. В целях ограничения нагрузки на постраничную навигацию наложено ограничение в 50 задач
- iNumPage — номер страницы при постраничной навигации

SELECT array необязательный

Массив полей записей, которые будут возвращены методом. Если в массиве присутствует значение "*", то будут возвращены все доступные поля.

Значение по умолчанию (пустой массив array()) означает, что будут возвращены все поля основной таблицы запроса

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.item.list

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.