Update

Класс устарел. Рекомендуется использовать методы класса Bitrix\Sale\Location.

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

int
CSaleLocation::Update(
	int ID,
	array arFields
);

Метод обновляет параметры местоположения с кодом ID в соответствии с параметрами из массива arFields. Обновляются так же страна и город этого местоположения. Нестатический метод.

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

Параметр	Описание
ID	Код местоположения.
arFields	Ассоциативный массив параметров местоположения с ключами: SORT - индекс сортировки; COUNTRY_ID - код страны (если такая страна уже есть, иначе код должен быть нулем, и должен быть заполнен ключ COUNTRY); COUNTRY - массив с параметрами страны (должен быть заполнен, если не установлен ключ COUNTRY_ID или если ключ CHANGE_COUNTRY установлен в значение Y); CHANGE_COUNTRY - флаг (Y/N), изменять ли параметры страны (долны быть установлены ключи COUNTRY_ID и COUNTRY); WITHOUT_CITY - флаг (Y/N), означающий, что это местоположение без города (только страна) (если значением с этим ключем является N, то необходимо заполнить ключ CITY); CITY_ID - код города (если такой город уже есть, иначе код должен быть нулем, и должен быть заполнен ключ CITY); CITY - массив с параметрами города (если установлен флаг WITHOUT_CITY в значение Y, то этот ключ заполнять не нужно); Массив с параметрами страны должен содержать ключи: NAME - название страны (не зависящее от языка); SHORT_NAME - сокращенное название страны - абревиатура (не зависящее от языка); <код языка> - ключем является код языка, а значением ассоциативный массив вида array( "LID" => "код языка", "NAME" => "название страны на этом языке", "SHORT_NAME" => "сокращенное название страны (аббревиатура) на этом языке" ) Эта пара ключ-значение должна присутствовать для каждого языка системы. Массив с параметрами города должен содержать ключи: NAME - название города (не зависящее от языка); SHORT_NAME - сокращенное название города - абревиатура (не зависящее от языка); <код языка> - ключем является код языка, а значением ассоциативный массив вида array( "LID" => "код языка", "NAME" => "название города на этом языке", "SHORT_NAME" => "сокращенное название города (аббревиатура) на этом языке" ) Эта пара ключ-значение должна присутствовать для каждого языка системы.

Параметр

Описание

Код местоположения.

arFields

Ассоциативный массив параметров местоположения с ключами:

SORT - индекс сортировки;
COUNTRY_ID - код страны (если такая страна уже есть, иначе код должен быть нулем, и должен быть заполнен ключ COUNTRY);
COUNTRY - массив с параметрами страны (должен быть заполнен, если не установлен ключ COUNTRY_ID или если ключ CHANGE_COUNTRY установлен в значение Y);
CHANGE_COUNTRY - флаг (Y/N), изменять ли параметры страны (долны быть установлены ключи COUNTRY_ID и COUNTRY);
WITHOUT_CITY - флаг (Y/N), означающий, что это местоположение без города (только страна) (если значением с этим ключем является N, то необходимо заполнить ключ CITY);
CITY_ID - код города (если такой город уже есть, иначе код должен быть нулем, и должен быть заполнен ключ CITY);
CITY - массив с параметрами города (если установлен флаг WITHOUT_CITY в значение Y, то этот ключ заполнять не нужно);

Массив с параметрами страны должен содержать ключи:

NAME - название страны (не зависящее от языка);
SHORT_NAME - сокращенное название страны - абревиатура (не зависящее от языка);
<код языка> - ключем является код языка, а значением ассоциативный массив вида
```
array(
	"LID" => "код языка",
	"NAME" => "название страны на этом языке",
	"SHORT_NAME" => "сокращенное название страны (аббревиатура) на этом языке"
)
```
Эта пара ключ-значение должна присутствовать для каждого языка системы.

Массив с параметрами города должен содержать ключи:

NAME - название города (не зависящее от языка);
SHORT_NAME - сокращенное название города - абревиатура (не зависящее от языка);
<код языка> - ключем является код языка, а значением ассоциативный массив вида
```
array(
	"LID" => "код языка",
	"NAME" => "название города на этом языке",
	"SHORT_NAME" => "сокращенное название города (аббревиатура) на этом языке"
)
```
Эта пара ключ-значение должна присутствовать для каждого языка системы.

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

Возвращается код измененного местоположения или false у случае ошибки.

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

<?
$arFields = array(
	"SORT" => 100,
	"COUNTRY_ID" => 8,
	"WITHOUT_CITY" => "N"
);

$arCity = array(
	"NAME" => "Kaliningrad",
	"SHORT_NAME" => "Kaliningrad",
	"ru" => array(
		"LID" => "ru",
		"NAME" => "Калининград",
		"SHORT_NAME" => "Калининград"
	),
	"en" => array(
		"LID" => "en",
		"NAME" => "Kaliningrad",
		"SHORT_NAME" => "Kaliningrad"
	)
);

$arFields["CITY"] = $arCity;

if (!CSaleLocation::Update(6, $arFields))
	echo "Ошибка изменения местоположения";
?>

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

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

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

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

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

Наверх