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>";
	}
}
?>