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 "Ошибка изменения местоположения";
?>