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

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 "Ошибка добавления типа цены";
?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Валерий Чеванин
Также можно одним из полей в $arFields поставить BASE:
Код
$arFields["BASE"] = "Y";

тогда добавляемый тип цен будет базовым (если в системе еще нет базового типа).
Использовал это поле при написании своего мастера установки интернет-магазина, полезно.
Подозреваю, что что-то подобное может Update, но не проверял.

Цитата
Замечание к комментарию от разработчика:
1. если в системе Базовый тип есть, с него признак "базовости" будет снят
2. Update - то же самое.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх