Документация для разработчиков

CheckFields

boolean function
CCurrencyRates::CheckFields(
 ACTION,
 arFields
 ID = 0
);

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

Параметры вызова

Параметр Описание
ACTION Равно ADD или UPDATE с учетом регистра. Если значение в другом регистре или другое значение, то возвращает false без текста ошибки (exception). Если значение равно UPDATE, то проверяется ID. Если ID <= 0, то возвращается ошибка. В случае наличия в arFields ключа ID удалит его.
arFields Значения ключей:
  • CURRENCY - не пустой код валюты, обрезается до 3 символов. Обязательно будет проверен, если присутствует в массиве (даже если это обновление).
  • DATE_RATE - дата курса БЕЗ ВРЕМЕНИ. Проверяется на валидность (должна быть в формате сайта/языка). Обязательно будет проверена, если присутствует в массиве (даже если обновление).
  • RATE_CNT - номинал. Может быть только целым числом > 0.
  • RATE - курс. Может быть только вещественным числом > 0.

При добавлении обязательны все. При обновлении - RATE_CNT и RATE могут отсутсвовать.

ID Код обновляемого курса. Необязательный параметр.

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

В случае успеха возвращает true. В случае ошибки - false. Текст ошибки можно получить через $APPLICATION->GetException().

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

$ID = 7;
	$arFields = array(
		'CURRENCY' => 'RUB',
		'DATE_RATE' => '21.02.2012',
		'RATE_CNT' => 7
	);
	
	$mxRes = CCurrencyRates::CheckFields('ADD', $arFields); // вернет ошибку, т.к. нет курса (RATE)
	$mxRes = CCurrencyRates::CheckFields('UPDATE', $arFields, $ID); // ошибки не будет, т.к. при обновлении RATE не является обязательным;


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх