GetList
Описание и параметры
CDBResult CCatalogDiscountCoupon::GetList( array $arOrder = array(), array $arFilter = array(), mixed $arGroupBy = false, mixed $arNavStartParams = false, array $arSelectFields = array() );
Метод выбирает купоны, соответствующие условиям. Нестатический метод.
Параметры вызова
Параметр | Описание |
---|---|
arOrder | Массив вида array(by1=>order1[, by2=>order2 [, ..]]), где by - поле для сортировки, может принимать значения:
|
arFilter | Массив параметров, по которым строится фильтр выборки. Имеет вид:
array( "[модификатор1][оператор1]название_поля1" => "значение1", "[модификатор2][оператор2]название_поля2" => "значение2", . . . )Удовлетворяющие фильтру записи возвращаются в результате, а записи, которые не удовлетворяют условиям фильтра, отбрасываются. Допустимыми являются следующие модификаторы:
Необязательное. По умолчанию купоны не фильтруются. |
arGroupBy | Массив полей для группировки купонов. имеет вид:
array("название_поля1", "название_поля2", . . .)В качестве "название_поляN" может стоять любое поле каталога. Если массив пустой, то метод вернет число записей, удовлетворяющих фильтру. Значение по умолчанию - false - означает, что результат группироваться не будет. |
arNavStartParams | Массив параметров выборки. Может содержать следующие ключи:
|
arSelectedFields | Массив полей записей, которые будут возвращены методом. Можно указать следующие поля ID, DISCOUNT_ID, ACTIVE, ONE_TIME, COUPON, DATE_APPLY, DISCOUNT_NAME и DESCRIPTION. Если в массиве присутствует значение "*", то будут возвращены все доступные поля. Необязательный. По умолчанию выводятся все поля. |
Возвращаемое значение
Метод возвращает объект класса CDBResult.
Смотрите также
Примеры использования
Пример проверки получения купона по "Коду купона":
if (CModule::IncludeModule("catalog")) { $arFilter = array('COUPON' => 'CP-R8RFW-5YGGPZJ'); $dbCoupon = CCatalogDiscountCoupon::GetList (array(), $arFilter); if($arCoupon = $dbCoupon->Fetch()) { echo "<pre>"; print_r($arCoupon); echo "</pre>"; } else { echo "купона нет"; } }
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.