GetList
Описание и параметры
CDBResult CTasks::GetList( array arOrder = array(), array arFilter = array(), array arSelect = array(), array arParams = array() );
Возвращает список задач по фильтру arFilter, отсортированный в порядке arOrder.
Примечание: Метод принимает массив конфигурационных параметров и генерирует скрипты, необходимые для показа файлового диалога. Метод статический.
Параметры метода
Параметр | Описание | С версии |
---|---|---|
arOrder | Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:
Примечание. Допускается сортировка по пользовательским полям.
| |
arFilter | Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:
"значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются. | |
arSelect | Массив возвращаемых полей задачи. | |
arParams | Массив дополнительных параметров. Необязательный. | 12.5.0 |
Возвращаемое значение
Возвращается объект CDBResult.
Примеры использования
<? // Выбираем все задачи пользователя с ID = 2 if (CModule::IncludeModule("tasks")) { $res = CTasks::GetList( Array("TITLE" => "ASC"), Array("RESPONSIBLE_ID" => "2") ); while ($arTask = $res->GetNext()) { echo "Task name: ".$arTask["TITLE"]."
"; } } ?>
<? // Выбираем задачи, для которых пользователь является исполнителем или соисполнителем $arFilter = array( '::LOGIC' => 'AND', 'CHECK_PERMISSIONS' => 'Y', 'ONLY_ROOT_TASKS' => 'Y', 'SAME_GROUP_PARENT' => 'Y', '::SUBFILTER-1' => array( '::LOGIC' => 'OR', '::SUBFILTER-1' => array( 'ACCOMPLICE' => array($USER->GetID()), 'REAL_STATUS' => array(CTasks::STATE_NEW, CTasks::STATE_PENDING, CTasks::STATE_IN_PROGRESS), ), '::SUBFILTER-2' => array( 'RESPONSIBLE_ID' => $USER->GetID(), 'REAL_STATUS' => array(CTasks::STATE_NEW, CTasks::STATE_PENDING, CTasks::STATE_IN_PROGRESS), ), ), ); ?>
Иван Шум
|
||
Один из возможных параметров массива arParams - это USER_ID. Если параметр не задан, система подставит ID текущего пользователя.
Но если код выполняется агентом, то ID текущего пользователя не будет. В таком случае корректно отработает следующий код:
| ||
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.