task.elapseditem.getlist
Scope: task Права на выполнение: для всех
Описание
Возвращает список записей о затраченном времени по задаче.
Параметры
Параметр | Описание |
---|---|
TASKID | Идентификатор задачи. Необязательный параметр. |
ORDER | Массив для сортировки результата. Поле для сортировки может принимать значения:
|
FILTER | Массив вида {"фильтруемое_поле": "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения:
Необязательный. По умолчанию записи не фильтруются. |
SELECT | Массив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы. Если в массиве присутствует значение "*" , то будут возвращены все доступные поля. Значение по умолчанию - пустой массив array() - означает, что будут возвращены все поля основной таблицы запроса. |
PARAMS | Массив для опций вызова. Элементом является массив NAV_PARAMS вида {"опция вызова": 'значение' [, ...]}, хранящий следующие опции:
|
Внимание! Соблюдение порядка следования параметров в запросе обязательно. При его нарушении запрос будет выполнен с ошибками.
Особенности ручного добавления информации о времени работы, которая было фактически выполнена несколько дней назад. В этом случае меняется значение некоторых полей:
- CREATED_DATE - дата начала;
- DATE_START - дата создания записи;
- DATE_STOP - дата создания записи;
Примеры
// Получить все записи о затраченном времени с сортировкой по ID в нисходящем порядке. // Будут отфильтрованы только те записи, ID которых имеет значение меньше 50. BX24.callMethod( 'task.elapseditem.getlist', [1, {'ID': 'desc'}, {'<ID': 50}], function(result){ console.info(result.data()); console.log(result); } );
Получение выборки по затраченному времени на основании общий условий фильтрации. Например, выбрать данные о трудозатратах с указанной даты:
BX24.callMethod( 'task.elapseditem.getlist', [{'ID': 'desc'}, {>=CREATED_DATE': '2018-02-16'}], function(result){ console.info(result.data()); console.log(result); } );
Пример для работы с php:
// Пример для работы с php // Получение GET-запроса на выборку данных. $appParams = array( "auth" => '92006f4ae0c55d400f1e6e09428af64a', "ORDER" => array("ID" => "DESC"), // Сортировка по ID - по убыванию "FILTER" => array(">ID" => 1), // Фильтр "SELECT" => array('ID', 'TASK_ID'), // Выборка - только ID записи и задачи "PARAMS" => array('NAV_PARAMS' => array( // Постраничка "nPageSize" => 2, // по 2 элемента на странице 'iNumPage' => 2 // страница номер 2 )), ); $appRequestUrl = 'http://test-domain.ru/rest/task.elapseditem.getlist.xml?'.http_build_query($appParams); print(urldecode($appRequestUrl));;
Сообщение не промодерировано, возможны ошибки и неточности.
|
Фильтр по датам для 1С
order[ID]=ASC&filter[>ID]=0&filter[USER_ID]=220&filter[>CREATED_DATE]=" + ПериодНачала + "&filter[<CREATED_DATE]=" + ПериодОкончания |
Сообщение не промодерировано, возможны ошибки и неточности.
|
Хочется плакать навзрыд. Чтобы выгрузить порциями данные, надо делать так:
task.elapseditem.getlist?order[ID]=ASC&filter[>ID]=0&select[]=*&PARAMS[NAV_PARAMS][nPageSize]=50&PARAMS[NAV_PARAMS][iNumPage]=2. Без других параметров оно не работает, кроме того, порядок параметров важен. Боюсь представить, какие стажеры писали код этого "REST API". |
AndrewTishkin
|
||||||
Один из эндпойнтов, за реализацию которого нужно слать лютые лучи поноса приложившим руку (или ногу, хз), потому что кроме очередного отсутствия единства в наименованиях, регистрах полей (большими или маленькими буквами) всплывают откровенные нежданчики по логике работы.
Он прекрасно отрабатывает на
Но не хочет работать при
Работа с битрикс-API - это задумываться НА КАЖДОМ ШАГУ о том, какую буковку написать, чтобы не получить мало помогающую ошибку, вместо того, чтобы как при работе с нормальными апишками - просто писать код, выучив базовые принципы | ||||||
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.