Свойства корзины

Добавление

// $basket – объект класса \Bitrix\Sale\Basket
foreach ($basket as $basketItem)
{
	$collection = $basketItem->getPropertyCollection();
	$item = $collection->createItem();
	$item->setFields(
		[
			'NAME' => 'Новое свойство',
			'CODE' => 'XXX',
			'VALUE' => 'Значение',
		]
	);
}

Получение

• Работа с коллекцией

  $collection = $basketItem->getPropertyCollection();
  foreach ($collection as $item)
  {
  	// $item – объект класса \Bitrix\Sale\BasketPropertyItem
  }

• Работа с массивом

  Помимо объектов есть возможность напрямую обращаться к базе через метод \Bitrix\Sale\BasketPropertiesCollection::getList($parameters).

  Метод всегда возвращает объект Bitrix\Main\DB\Result, из которого можно получить данные с помощью метода fetch().

  Параметр	Описание	С версии
  $parameters	Массив, структура которого полностью соответствует структуре ORM'ного getList.

  // получение списка свойств для товара с кодом 123
  $dbRes = \Bitrix\Sale\BasketPropertiesCollection::getList(
  	[
  		'select' => ['*'],
  		'filter' => [
  			'=BASKET_ID' => 123, 
  		]
  	]
  );
  
  while ($item = $dbRes->fetch())
  {
  	var_dump($item);
  }

Обновление

// $basketItem – объект класса \Bitrix\Sale\BasketItem
$collection = $basketItem->getPropertyCollection();
$property = $collection->getItemById(123);
$property->setField('VALUE', 'Новое значение');

'NAME', // название свойства
'VALUE', // значение свойства
'CODE', // код свойства
'SORT', // сортировка
'XML_ID' // внешний код

Удаление

// $basketItem – объект класса \Bitrix\Sale\Basket
$collection = $basketItem->getPropertyCollection();
$property = $collection->getItemById(123);
$property->delete();

Получение конкретного свойства

$collection = $baketItem->getPropertyCollection();

• по ID

  $property = $collection->getItemById($id);

• по внутреннему индексу

  $property = $collection->getItemByIndex($index);

Перезапись всех имеющихся свойств

Метод \Bitrix\Sale\BasketPropertiesCollection::redefine работает следующим образом:

• если свойство есть в коллекции, но отсутствует во входных данных, то свойство будет удалено
• если свойство есть в коллекции, а так же присутствует во входных данных, то свойство обновится
• если свойства нет в коллекции, но присутствует во входных данных, то свойство добавится

// $basket – объект класса \Bitrix\Sale\BasketBase
foreach ($basket as $basketItem)
{
	$collection = $basketItem->getPropertyCollection();
	$collection->redefine(
		[
			[
				'NAME' => 'Новое свойство',
				'CODE' => 'XXX',
				'VALUE' => 'Значение',
			]
		]
	);
}