GetList

Описание и параметры

CDBResult
CCertification::GetList(
	array arOrder = Array("ID"=>"DESC"),
	array arFilter = Array()
);

Возвращает список сертификатов по фильтру arFilter, отсортированный в порядке arOrder. Учитываются права доступа текущего пользователя. Метод статический.

Параметры метода

Параметр	Описание
arOrder	Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]). Поле для сортировки может принимать значения: ID - идентификатор сертификата; STUDENT_ID - идентификатор студента ; COURSE_ID - идентификатор курса; SUMMARY - cумма баллов, набранных за прохождение всех тестов курса; MAX_SUMMARY - максимально возможная сумма баллов за прохождение всех тестов курса; SORT - индекс сортировки; ACTIVE - фильтр по активности (Y\|N); FROM_ONLINE - сертификат получен через online-обучение (Y/N); PUBLIC_PROFILE - публиковать сертификат в профиле (Y/N); DATE_CREATE - дата создания сертификата; TIMESTAMP_X - дата изменения студента. Направление сортировки может принимать значения: asc - по возрастанию; desc - по убыванию; Необязательный. По умолчанию фильтруется по убыванию идентификатора сертификата.
arFilter	Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения: ID - идентификатор сертификата; STUDENT_ID - идентификатор студента ; COURSE_ID - идентификатор курса; SUMMARY - cумма баллов, набранных за прохождение всех тестов курса; MAX_SUMMARY - максимально возможная сумма баллов за прохождение всех тестов курса; SORT - индекс сортировки; ACTIVE - фильтр по активности (Y\|N); FROM_ONLINE - сертификат получен через online-обучение (Y/N); PUBLIC_PROFILE - публиковать сертификат в профиле (Y/N); DATE_CREATE - дата создания сертификата; TIMESTAMP_X - дата изменения студента. USER - пользователь (возможны сложные условия по полям пользователя ID, LOGIN, NAME, LAST_NAME); MIN_PERMISSION - минимальный уровень доступа. По умолчанию "R". Список прав доступа см. в CCourse::SetPermission. CHECK_PERMISSIONS - проверять уровень доступа. Если установлено значение "N" - права доступа не проверяются. Перед названием фильтруемого поля можно указать тип фильтрации: "!" - не равно "<" - меньше "<=" - меньше либо равно ">" - больше ">=" - больше либо равно "значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются.

Параметр

Описание

arOrder

Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:

ID - идентификатор сертификата;
STUDENT_ID - идентификатор студента ;
COURSE_ID - идентификатор курса;
SUMMARY - cумма баллов, набранных за прохождение всех тестов курса;
MAX_SUMMARY - максимально возможная сумма баллов за прохождение всех тестов курса;
SORT - индекс сортировки;
ACTIVE - фильтр по активности (Y|N);
FROM_ONLINE - сертификат получен через online-обучение (Y/N);
PUBLIC_PROFILE - публиковать сертификат в профиле (Y/N);
DATE_CREATE - дата создания сертификата;
TIMESTAMP_X - дата изменения студента.

Направление сортировки может принимать значения:

asc - по возрастанию;
desc - по убыванию;

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

arFilter

Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:

ID - идентификатор сертификата;
STUDENT_ID - идентификатор студента ;
COURSE_ID - идентификатор курса;
SUMMARY - cумма баллов, набранных за прохождение всех тестов курса;
MAX_SUMMARY - максимально возможная сумма баллов за прохождение всех тестов курса;
SORT - индекс сортировки;
ACTIVE - фильтр по активности (Y|N);
FROM_ONLINE - сертификат получен через online-обучение (Y/N);
PUBLIC_PROFILE - публиковать сертификат в профиле (Y/N);
DATE_CREATE - дата создания сертификата;
TIMESTAMP_X - дата изменения студента.
USER - пользователь (возможны сложные условия по полям пользователя ID, LOGIN, NAME, LAST_NAME);
MIN_PERMISSION - минимальный уровень доступа. По умолчанию "R". Список прав доступа см. в CCourse::SetPermission.
CHECK_PERMISSIONS - проверять уровень доступа. Если установлено значение "N" - права доступа не проверяются.

Перед названием фильтруемого поля можно указать тип фильтрации:

"!" - не равно
"<" - меньше
"<=" - меньше либо равно
">" - больше
">=" - больше либо равно

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

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

Возвращаемое значение

Возвращается объект CDBResult.

Смотрите также

Примеры использования

<?
if (CModule::IncludeModule("learning"))
{
	$COURSE_ID = 100;
	$res = CCertification::GetList(
		Array("SUMMARY" => "DESC", "SORT"=>"ASC"), 
		Array("ACTIVE" => "Y", "COURSE_ID" => $COURSE_ID)
	);
	while ($arCertification = $res->GetNext())
	{
		echo "User:".$arCertification["USER_NAME"].
			"; Course name: ".$arCertification["COURSE_NAME"]."<br>";
	}
}
?>

<?
if (CModule::IncludeModule("learning"))
{
	$COURSE_ID = 100;
	$res = CCertification::GetList(
		Array("SUMMARY" => "DESC", "SORT"=>"ASC"), 
		Array("ACTIVE" => "Y", "CHECK_PERMISSIONS" => "N")
	);
	while ($arCertification = $res->GetNext())
	{
		echo "User:".$arCertification["USER_NAME"].
		"; Course name: ".$arCertification["COURSE_NAME"]."<br>";
	}
}
?>

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

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

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

Наверх