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	Код обновляемого курса. Необязательный параметр.

Параметр

Описание

ACTION

Равно ADD или UPDATE с учетом регистра. Если значение в другом регистре или другое значение, то возвращает false без текста ошибки (exception). Если значение равно UPDATE, то проверяется ID. Если ID <= 0, то возвращается ошибка. В случае наличия в arFields ключа ID удалит его.

arFields

Значения ключей:

CURRENCY - не пустой код валюты, обрезается до 3 символов. Обязательно будет проверен, если присутствует в массиве (даже если это обновление).
DATE_RATE - дата курса БЕЗ ВРЕМЕНИ. Проверяется на валидность (должна быть в формате сайта/языка). Обязательно будет проверена, если присутствует в массиве (даже если обновление).
RATE_CNT - номинал. Может быть только целым числом > 0.
RATE - курс. Может быть только вещественным числом > 0.

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

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

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

В случае успеха возвращает 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 не является обязательным;