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

Add

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

int
CCatalogGroup::Add(
	array arFields
);

Метод добавляет новый тип цен. При этом сохраняются как языкозависимые параметры типа, так и параметры, которые не зависят от языка. Так же есть возможность указать группы пользователей, члены которых могут просматривать и покупать товары по ценам этого типа. Нестатический метод.

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

ПараметрОписание
arFields Ассоциативный массив параметров типа цены, ключами которого являются названия параметров, а значениями - новые значения.
Допустимые параметры:
  • BASE - флаг (Y/N) является ли тип базовым (если для добавляемого типа цен указано Y и в системе уже есть некоторый базовый тип цен, то флаг с существующего типа будет снят);
  • NAME - внутреннее название типа цены;
  • SORT - индекс сортировки;
  • XML_ID - внешний код;
  • CREATED_BY - ID создателя типа цен;
  • MODIFIED_BY - ID последнего изменившего тип цен;
  • USER_GROUP - массив кодов групп пользователей, члены которых могут видеть цены этого типа;
  • USER_GROUP_BUY - массив кодов групп пользователей, члены которых могут покупать товары по ценам этого типа;
  • USER_LANG - ассоциативный массив языкозависимых параметров типа цены, ключами которого являются коды языков, а значениями - названия этого типа цены на соответствующем языке.

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

Возвращает код добавленного типа цены или false в случае ошибки

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

<?
$arFields = array(
	"NAME" => "retail",
	"SORT" => 100,
	"USER_GROUP" => array(2, 4),   // видят цены члены групп 2 и 4
	"USER_GROUP_BUY" => array(2),  // покупают по этой цене
		// только члены группы 2
	"USER_LANG" => array(
		"ru" => "Розничная",
		"en" => "Retail"
	)
);

$ID = CCatalogGroup::Add($arFields);
if ($ID<=0)
	echo "Ошибка добавления типа цены";
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024