Стандартные и пользовательские свойства в 1С-Битриксе

Моя цель - предложение широкого ассортимента товаров и услуг на постоянно высоком качестве обслуживания по самым выгодным ценам.

В 1С-Битрикс: Управление сайтом (как и в Битрикс24) десятки, если не сотни настраиваемых типов данных (или сущностей): инфоблоки, пользователи, заказы, склады, форумы, блоги и т.д. Структура большинства сущностей расширяема за счет служебной сущности «Свойства».

В этой статье мы собрали воедино всю информацию о свойствах в Битриксе. Где их создавать в панели управления, как ими управлять через API, какими событиями можно изменить их поведение и как создавать свои собственные типы свойств.

Справочник свойств в Битрикс

Сущность

Расположение страницы

Что является свойством

Заказы интернет-магазина

Рабочий стол > Магазин > Настройки > Свойства заказа > Список свойств

Свойства заказа

Элементы инфоблока

Рабочий стол > Контент > Инфоблоки > Типы инфоблоков > [Название инфоблока] > Свойства

Свойства элементов инфоблока

Товары каталога

Товары в корзине


Свойства товара, добавленного в корзину

Товары в заказе

Параметры компонентов


Файл .parameters.php

Параметры шаблонов компонентов

Свойства умного фильтра

Рабочий стол > Магазин > Каталоги товаров > [Название инфоблока] > Настройки каталога > Свойства элементов

Свойства элементов инфоблока

Страницы и разделы сайта

Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Управление структурой

Свойства

Пункты меню


Параметры

Интеграция с 1С

Рабочий стол > Магазин > Настройки > Интеграция с 1С > Профили обмена

Реквизиты

Внешние сервисы местоположений

Рабочий стол > Магазин > Настройки > Местоположения > Внешние сервисы

Внешние сервисы

Разделы инфоблоков


UF

HL-блоки

Рабочий стол > Контент > Highload-блоки > [Название HL-блока] > Добавление/редактирование записи

UF

Пользователи

Рабочий стол > Настройки > Пользователи > Список пользователей > [Пользователь] > Доп. поля

UF

Группы пользователей


Нет

Склады

Рабочий стол > Магазин > Складской учет > Склады > Добавление/редактирование записи

UF

Компании

Рабочий стол > Магазин > Настройки > Компании > Добавление/редактирование компании > Пользовательские поля

UF

Обращения в ТП

Рабочий стол > Сервисы > Техподдержка > Обращения > Добавление/редактирование обращения

UF

Блоги

Рабочий стол > Сервисы > Блоги > Блоги > Добавление/редактирование блога > Доп. поля

UF

Обучение

Курсы

Уроки

Вопрос

Рабочий стол > Сервисы > Обучение > Курсы > Добавление/редактирование > Доп. поля

UF

Учебные группы

Рабочий стол > Сервисы > Обучение > Учебные группы > Учебные группы > Добавление/редактирование > Доп. поля

UF

Рассмотрим для каждой сущности свойства поподробнее: как можно ими управлять, как создать кастомный тип свойства, какие события связаны с изменением свойств и какие возможности оставили нам разработчики Битрикс.

Заказы интернет-магазина

Как создать новое свойство

Свойства заказов располагаются по пути: Рабочий стол > Магазин > Настройки > Свойства заказов > Список свойств

Доступные типы

В системе «из коробки» есть типы:

  • Строка (STRING)

  • Число (NUMBER)

  • Да/Нет (Y/N)

  • Перечисление (ENUM)

  • Файл (FILE)

  • Дата (DATE)

  • Местоположение (LOCATION)

Как добавить свой тип

Типы свойств заказа расширяемы. О том, как создавать кастомные типы свойства заказа рассказывается в курсе Разработчик Bitrix Framework .

API для работы со значениями

Рассмотрим на примере использование API ядра D7 для работы со значениями свойств заказа:

$order = \Bitrix\Sale\Order::load($orderId);

/**

* получить коллекцию свойств заказа

* @var Bitrix\Sale\PropertyValue $propertyCollection

*/

$propertyCollection = $order->getPropertyCollection();

// получить свойства в виде массива

$arProperties = $propertyCollection->getArray();

// получить свойство по ID

$propValue = $propertyCollection->getItemByOrderPropertyId($propertyId);

/**

* получить значение свойства

* @var Bitrix\Sale\PropertyValue $value

*/

$value = $propValue->getValue();

// установить значение свойства

$propValue->setValue("value");

// чтобы сохранить изменения
$order->save();

Для работы со значениями свойств заказа также можно использовать устаревший класс CSaleOrderPropsValue со следующим набором функций:

  • CSaleOrderPropsValue::GetList

  • CSaleOrderPropsValue::GetByID

  • CSaleOrderPropsValue::Update

  • CSaleOrderPropsValue::Add

  • CSaleOrderPropsValue::GetOrderProps

Пример работы со значениями свойств заказа функциями устаревшего класса:

// прочитать значение

$rsProp = CSaleOrderProps::GetList(

array(

    "SORT" => "ASC",

    ),

array(

    "PERSON_TYPE_ID" => $arOrder["PERSON_TYPE_ID"],

    "CODE" => "PHONE",

 )

);

// обновить значение

CSaleOrderPropsValue::Update(

 $arVals['ID'],

array(

    "ORDER_ID" => $arVals['ORDER_ID'],

    "VALUE" => "140",

 )

);

События изменения значений

События, связанные с изменением свойств заказов:

  • \Bitrix\Sale\Order::onPropertyValueCollectionModify (для D7 методов изменение значений свойств)

  • OnBeforeSalePropertyValueSetField (перед изменением поля)

  • OnSalePropertyValueSetField (непосредственно перед изменением поля)

  • OnSaleComponentOrderProperties (после формирования списка свойств)

Есть и другие события заказа , на которых можно работать со свойствами.

Интеграция с 1С

Для обмена данными с 1С на сайте используются профили обмена, в которых настраивается соответствие полей.

Как добавить реквизит

На странице настройки интеграции 1С по пути Рабочий стол > Магазин > Настройки > Интеграция с 1С > Профили обмена есть возможность настроить параметры для выгрузки данных из 1С на сайт.

Если появилась необходимость помимо стандартных параметров добавить собственные, на этой же странице, ниже расположен раздел «1С: Дополнительные параметры», где задаются дополнительные параметры.

Доступные типы

При помощи типов параметров можно определить какие данные ожидается получить и в какое свойство.

Доступны следующие типы:

  • Значение

  • Пользователь

  • Заказ

  • Свойство заказа

  • Оплата

  • Отгрузка

  • Компания

Как добавить свой тип

Нет возможности расширения.

API для работы со значениями

Так как все значения прилетают из 1C, то API для работы с этими параметрами не предусмотрено.

События изменения значений

Событий изменения значений не предусмотрено.

Элементы инфоблоков

Инфоблоки — основная сущность для хранения произвольной информации в Битриксе. Именно инфоблоки используются для создания каталогов интернет-магазина. Таким образом, всё сказанное про свойства элементов в этом разделе справедливо и для свойств товаров.

Как создать новое свойство

Свойства элементов инфоблока добавляются в настройках инфоблока: Рабочий стол > Контент > Инфоблоки > Типы инфоблоков > [Название типа] > [Название инфоблока] > вкладка «Свойства». Можно добавить неограниченное количество свойств (только для Инфоблоков 1.0).

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

Доступные типы

При добавлении свойств доступен список базовых и пользовательских типов данных:

Свойство

Базовое?

Код

Строка

Да

S

Число

Да

N

Список

Да

L

Файл

Да

F

Привязка к элементам ИБ

Да

E

Привязка к разделам ИБ

Да

G

HTML/текст

Нет

S:HTML

Видео

Нет

S:video

Дата

Нет

S:Date

Дата/Время

Нет

S:DateTime

Деньги

Нет

S:Money

Привязка к Яндекс.Карте

Нет

S:map_yandex

Привязка к карте Google Maps

Нет

S:map_google

Привязка к пользователю

Нет

S:UserID

Привязка к разделам с автозаполнением

Нет

G:SectionAuto

Привязка к теме форума

Нет

S:TopicID

Привязка к товарам (SKU)

Нет

E:SKU

Привязка к файлу (на сервере)

Нет

S:FileMan

Привязка к элементам в виде списка

Нет

E:EList

Привязка к элементам по XML_ID

Нет

S:ElementXmlID

Привязка к элементам с автозаполнением

Нет

E:EAutocomplete

Справочник

Нет

S:directory

Счетчик

Нет

N:Sequence


Если вам потребуется создать boolean-свойство, например, «Да/Нет», то для этого нужно создать кастомное свойство в виде checkbox (флажок), унаследованное от свойства number (число). И задать логику, например, если флажок установлен возвращает число «1», соответственно, если не задано — вернет пустое значение.

Как добавить свой тип

Стандартных свойств довольно много, но если мощности Битрикса не хватает, можно создать собственное свойство с произвольным поведением.

Например, можно создать свойство «Видео», которое позволяет хранить видеофайлы или ссылку на youtube-видео, предварительно загружая обложку.

Создается кастомный тип свойства на обработчике события OnIBlockPropertyBuildList модуля iblock.

Пример создания кастомного свойства:

AddEventHandler("iblock", "OnIBlockPropertyBuildList", array("IblockCustom", "GetUserTypeDescription"));

class IblockCustom

{

  public static function GetUserTypeDescription()

  {

      return array(

          "PROPERTY_TYPE" => "S",

          "USER_TYPE" => "stringDate",

          "DESCRIPTION" => "Дата (custom)",

          "GetPublicViewHTML" => array(__CLASS__,"GetPublicViewHTML"),

          "GetPublicEditHTML" => array(__CLASS__,"GetPublicEditHTML"),

          "GetAdminListViewHTML" => array(__CLASS__,"GetAdminListViewHTML"),

          "GetPropertyFieldHtml" => array(__CLASS__,"GetPropertyFieldHtml"),

          "CheckFields" => array(__CLASS__,"CheckFields"),

          "ConvertToDB" => array(__CLASS__,"ConvertToDB"),

          "ConvertFromDB" => array(__CLASS__,"ConvertFromDB"),

          "GetSettingsHTML" => array(__CLASS__,"GetSettingsHTML"),

          "GetAdminFilterHTML" => array(__CLASS__,"GetAdminFilterHTML"),

          "GetPublicFilterHTML" => array(__CLASS__,"GetPublicFilterHTML"),

          "AddFilterFields" => array(__CLASS__,"AddFilterFields"),

      );

  }

}


Также существует возможность изменить отображение созданного типа свойства. Указанный параметр "PROPERTY_TYPE" => "S" говорит о том, что новый тип свойства будет унаследован от строки, то есть отображаться он будет как строка. При желании изменить отображение, например, в панели администратора, понадобится переопределить в созданном классе следующие функции:

// Отображение в списке элементов

function GetPublicViewHTML($arProperty, $value, $strHTMLControlName)

{

  return Loc::GetMessage($value['VALUE'] ? 'IBLOCK_PROP_CHECKBOX_YES' : 'IBLOCK_PROP_CHECKBOX_NO');

}


// Отображение при редактировании элемента

function GetPropertyFieldHtml($arProperty, $value, $strHTMLControlName)

{

  return '<input type="hidden" name="' . $strHTMLControlName['VALUE'] . '" value="" /><input type="checkbox" name="'

    . $strHTMLControlName['VALUE'] . '" value="1" ' . (intval($value['VALUE']) ? 'checked="checked"' : '').'/>';

}


Важнее всего здесь объявить метод GetUserTypeDescription .

API для работы со значениями

При необходимости изменения и получения значений свойств используются следующие функции класса CIBlockElement :

  • CIBlockElement::GetProperty

  • CIBlockElement::SetPropertyValues

  • CIBlockElement::SetPropertyValuesEx

  • CIBlockElement::SetPropertyValueCode

  • CIBlockElement::Add

  • CIBlockElement::Update

SetPropertyValuesEx и SetPropertyValues легко перепутать. Хороший программист знает в чём разница. Оба метода обновляют свойства, которые им передали. Но пропущенные свойства SetPropertyValues обнуляет, а SetPropertyValuesEx не трогает.

Методы SetProperty* не сбрасывают кеш инфоблока, в отличие от Add и Update. Если необходимо, кэш нужно сбросить вручную:

// обновить значение

\CIBlockElement::SetPropertyValuesEx($arElement["ID"], $arElement["IBLOCK_ID"], array("NEWS_ID" => $propValue));

// сбросить кеш

$CACHE_MANAGER->ClearByTag("iblock_id_" . $iblockId);

События изменения значений

При использовании этих функций запускаются следующие обработчики события, на которых можно изменить значение:

  • OnIBlockElementSetPropertyValues

  • OnIBlockElementSetPropertyValuesEx

  • OnBeforeIBlockElementAdd

  • OnStartIBlockElementUpdate

Остальные обработчики события модуля iblock представлены в документации Bitrix .

Товары в корзине и заказе

Как создать новое свойство

При добавлении товара в корзину есть возможность передавать его свойства: размер, цвет, производитель, длина, ширина и т.п. Свойства можно взять как из самого товара или SKU, так и создать «на лету».

Если используется стандартный шаблон каталога, такие свойства передаются при настройке параметров компонента.

Характеристики товара, добавляемые в корзину — это свойства товара, которые попадут в корзину вместе с товаром. Свойства предложений, добавляемые в корзину — это свойства торговых предложений, которые попадут в корзину при добавлении торгового предложения.

Типы свойств

Все значения свойств хранятся в типе данных «строка».

Как добавить свой тип

Возможности создать свой тип свойств нет. Но, так как данные хранятся в виде строки, обычно это не является проблемой.

API для работы со значениями

Значения задаются при добавлении товара в корзину —  \Bitrix\Catalog\Product\Basket::addProduct ( Add2BasketByProductID в старом ядре).

\Bitrix\Catalog\Product\Basket::addProduct и Add2BasketByProductID качестве третьего аргумента принимают массив, содержащий перечень свойств товара, добавленного в корзину. Для каждого свойства задается код, название и значение.

// новый метод ядра D7

\Bitrix\Catalog\Product\Basket::addProduct(array(

 'PRODUCT_ID' => $productId,

 'QUANTITY' => 1,

 'PROPS' => array(

    array(

       "NAME" => "Цвет",

       "CODE" => "COLOR",

       "VALUE" => "Черный",

    ),

    array(

       "NAME" => "Размер",

       "CODE" => "SIZE",

       "VALUE" => "41",

    ),

 )

));

// устаревший метод

Add2BasketByProductID($productId, 1,

  array(

      array(

          "NAME" => "Цвет",

          "CODE" => "COLOR",

          "VALUE" => "Черный",

      ),

      array(

          "NAME" => "Размер",

          "CODE" => "SIZE",

          "VALUE" => "41",

      ),

  )

);


Тогда в административном интерфейсе Магазин > Покупатели > Корзины можно посмотреть какие товары и с какими свойствами были добавлены.

В документации Bitrix дана более подробная инструкция по использованию функций Add2BasketByProductID и \Bitrix\Catalog\Product\Basket::addProduct .

Получить или изменить свойства и их значения можно с помощью следующих функций класса CSaleBasket :

  • CSaleBasket::GetPropsList

  • CSaleBasket::Update

Пример использования функции Update:

CSaleBasket::Update($id, array(

 "PROPS" => array(

    "NAME" => "Новый товар",

    "CODE" => "IS_NEW",

    "VALUE" => $value,

 ),

));

События изменения значений

Для изменения значений свойств можно воспользоваться следующими обработчиками событий

  • OnBeforeBasketAdd

  • OnBeforeBasketUpdate

В документации Bitrix также можно найти другие обработчики события , которые вам помогут в реализации решений.

Компоненты

Как добавить параметр

Для добавления параметров в окно настройки компонента используется файл .parameters.php. В нём разработчик компонента/шаблона компонента должен описать массив параметров.

Доступные типы параметров

В настройках параметров компонентов для отображения параметров доступны следующие типы:

  1. список (LIST);

  2. строка (STRING);

  3. флажок (CHECKBOX);

  4. палитра (COLORPICKER).

Параметр компонента типа COLORPICKER

Как добавить свой тип

Для создания собственных типов указывается TYPE=CUSTOM и три параметра JS_FILE, JS_EVENT и JS_DATA.

$arComponentParameters = array(

 "PARAMETERS" => array(

    'PATH_TO_FILE' => array(

       'NAME' => 'Путь до файла',

       'TYPE' => 'CUSTOM',

       'JS_FILE' => '/local/components/intervolga.test/supercomponent/settings/settings.js',

       'JS_EVENT' => 'OnSettingEdit',

       'JS_DATA' => '',

       'PARENT' => 'BASE',

    ),

 )

);


JS_FILE - указывается путь до JS файла, который отвечает за отображение параметра

JS_EVENT - указывается callback-функция, которая будет вызвана после подключения JS_FILE

JS_DATA - указываются параметры, которые будут переданы в callback-функцию

Пример собственного типа параметра компонента:

API для работы со значениями

API для работы со значениями не предусмотрено.

События изменения значений

Событий изменения значений не предусмотрено.

Умный фильтр

Как добавить новое свойство

Настройка свойств, которые отображаются в умном фильтре производится в настройках свойств инфоблока или в свойствах товаров (Рабочий стол > Магазин > [Название инфоблока] > Свойства товаров).

В параметрах конкретного свойства можно включить свойство в умный фильтр и настроить в каком виде он будет отображаться.

Если свойств в инфоблоке каталога много, то проще это сделать на странице административного интерфейса Рабочий стол > Магазин > [Название инфоблока] > Настройки каталога

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

Есть возможность настроить разные свойства в разных разделах каталога (Рабочий стол > Магазин > [Название инфоблока] > Разделы)

Доступные типы

Умный фильтр предлагает разные варианты отображения в зависимости от типа свойства товара:

  • «Справочник» может отображаться как флажки, радио кнопки и выпадающий список (интересный вариант — список с картинками):

  • «Число» отображается в виде двух полей «от-до»:

  • Остальные типы отображаются как флажки, радио кнопки и выпадающий список:

Как добавить свой тип

Добавить свой вариант отображения в настройки умного фильтра нельзя. Если какое-то поле требует особого отображения, то дорабатывается шаблон компонента «Умный фильтр».

API для работы со свойствами в умном фильтре

Настроить вывод свойства в умном фильтре (во всех разделах или в каком-то конкретном) позволяет класс \Bitrix\Iblock\SectionPropertyTable :

  • \Bitrix\Iblock\SectionPropertyTable::add

  • \Bitrix\Iblock\SectionPropertyTable::getList

  • \Bitrix\Iblock\SectionPropertyTable::update

  • \Bitrix\Iblock\SectionPropertyTable::delete

Пример использования функций:

// вывод свойств раздела инфоблока

$sectionProperties = \Bitrix\Iblock\SectionPropertyTable::getList(

 array(

    'filter' => array(

       'SECTION_ID' => $sectionId,

       'IBLOCK_ID' => $iblockId,

    ),

 )

);


// включение свойства в умный фильтр раздела

$data = array(

 'fields' => array(

    'SECTION_ID' => $sectionId,

    'IBLOCK_ID' => $iblockId,

    'PROPERTY_ID' => $property['ID'],

    'DISPLAY_TYPE' => $property['PROPERTY_TYPE'],

 ),

);

\Bitrix\Iblock\SectionPropertyTable::add($data);


При добавлении свойства в умный фильтр нужно указать ID раздела каталога, в котором оно должно отображаться. Если раздел не задать, свойство появится в умном фильтре всех разделов каталога.

События изменения значений

  • \Bitrix\Iblock\SectionProperty::onBeforeAdd

  • \Bitrix\Iblock\SectionProperty::onAdd

  • \Bitrix\Iblock\SectionProperty::onAfterAdd

  • \Bitrix\Iblock\SectionProperty::onBeforeUpdate

  • \Bitrix\Iblock\SectionProperty::onUpdate

  • \Bitrix\Iblock\SectionProperty::onAfterUpdate

  • \Bitrix\Iblock\SectionProperty::onBeforeDelete

  • \Bitrix\Iblock\SectionProperty::onDelete

  • \Bitrix\Iblock\SectionProperty::onAfterDelete

Страницы и разделы сайта

Свойства есть даже на обычных страницах и разделах сайта. Два из них созданы по умолчанию и используются для поисковиков: description и keywords. Свойства страниц и разделов расширяемы, но их значения хранятся в виде строки.

Как создать новое свойство

Если свойство должно работать на всех страницах сайта и разделах сайта, добавить его можно в настройках Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Управление структурой

Свойство для раздела или страницы можно задать с публичной части сайта:

Типы свойств

Все свойства имеют тип данных «строка».

Как добавить свой тип

Такой возможности нет.

API для работы со значениями

Для работы со свойствами страниц/разделов используется класс CMain . Вот некоторые из часто применяемых функции:

  • CMain::ShowProperty (отображение свойств с помощью технологии отложенных функций)

  • CMain::GetProperty (возвращает значение свойства)

  • CMain::SetPageProperty (устанавливает свойство страницы)

  • CMain::SetDirProperty (устанавливает свойство раздела)

Пример использования функций GetProperty и SetPageProperty:

// установить значение свойства страницы

$APPLICATION->SetPageProperty("keywords", "свойства, bitrix");

// получить значение свойства страницы

$APPLICATION->GetProperty("keywords");

// вывести значение свойства страницы

<title><?$APPLICATION->ShowProperty("keywords")?></title>


При использовании функции GetProperty программисту важно понимать как работают отложенные функции.

События изменения значений

Событий изменения значений не предусмотрено.

Пункты меню

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

Как добавить и изменить параметр

Параметры меню можно задать через административный интерфейс. Для этого по пути Рабочий стол > Контент > Структура сайта > Файлы и папки нужно отыскать файл меню и перейти в режим редактирования меню в расширенном режиме.

Доступные типы

Все свойства имеют тип данных «строка».

Как добавить свой тип

Такой возможности нет.

Как получить значение

Получить значение параметра  можно через массив PARAMS шаблона компонента «меню».

События изменения значений

Событий изменения значений не предусмотрено.

Универсальное решение — пользовательские поля (UF)

Расширение полей в Битриксе помимо стандартных свойств делается также с помощью UF полей.

Как создать новое свойство

Все UF свойства в Битриксе отображаются на странице «Пользовательские поля» административного интерфейса по пути Рабочий стол > Настройки > Настройки продукта > Пользовательские поля.

Пользовательские поля можно создать для любой записи в Битрикс, если у неё есть числовой ID. Визуальный интерфейс же есть лишь для немногих сущностей: пользователи, разделы ИБ, склады, блоги, форумы.

Для управления порядком отображения UF-свойств при редактировании конкретного свойства есть возможность установить порядок сортировки. Величина сортировки влияет на порядок вывода свойств в различных административных и публичных формах сайта.

Доступные типы

При добавлении UF свойства на выбор доступны следующие типы:

Свойство

Код

Письмо (email)

mail_message

Деньги

money

Видео

video

Привязка к элементам highload-блоков

hlblock

Строка

string

Целое число

integer

Число

double

Дата со временем

datetime

Дата

date

Да/Нет

boolean

Адрес

address

Ссылка

url

Файл

file

Список

enumeration

Привязка к разделам инф. блоков

iblock_section

Привязка к элементам инф. блоков

iblock_element

Шаблон

string_formatted

Опрос

vote

Содержимое ссылки

url_preview


Важное отличие от прочих свойств: после создания нельзя менять «множественность».

Как добавить свой тип

Чтобы добавить свой тип свойства, необходимо создать обработчик события OnUserTypeBuildList и объявить класс, наследуемый от класса базового свойства. В унаследованном классе переопределить функцию GetUserDescription. Переопределите остальные методы, если это требуется.

AddEventHandler("main", "OnUserTypeBuildList", array("UserTypeMediaLibrary", "GetUserTypeDescription"));

class UserTypeMediaLibrary extends \CUserTypeEnum

{

  function GetUserTypeDescription()

  {

      return array(

          "USER_TYPE_ID" => "cmedia",

          "CLASS_NAME" => "UserTypeMediaLibrary",

          "DESCRIPTION" => "Привязка к коллекции медиабиблиотеки",

          "BASE_TYPE" => "enum",

      );

  }

}


После этого, в списке доступных типов появится новое свойство.

API для работы со значениями

Добавление, чтение и обновление значений свойств происходит с помощью функций класса CUserTypeManager:

  • CUserTypeManager::Update

  • CUserTypeManager::Add

  • CUserTypeManager::GetUserFields

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

global $USER_FIELD_MANAGER;

// получить все значения объекта

$arFields = $USER_FIELD_MANAGER->GetUserFields("USER");

// обновить значение UF свойства

$USER_FIELD_MANAGER->Update('USER', $arUser['ID'], array(

 'UF_FAVORITE'  => $value

));


События изменения значений

События изменения значений UF свойств:

  • OnBeforeUserTypeAdd

  • OnAfterUserTypeAdd

  • OnBeforeUserTypeUpdate

  • OnAfterUserTypeUpdate

  • OnBeforeUserTypeDelete

  • OnAfterUserTypeDelete

  • OnUserTypeRightsCheck

Внешние сервисы местоположений

У местоположений Битрикса также есть поля, которые можно использовать как свойства, они называются «Внешние сервисы».

Как создать новое свойство

Внешние сервисы настраиваются на странице по пути: Рабочий стол > Магазин > Настройки > Местоположения > Внешние сервисы

Доступные типы

Все свойства имеют тип данных «строка».

Как добавить свой тип

Такой возможности нет.

API для работы со значениями

Для того, чтобы работать со значениями внешних сервисов местоположении пользуйтесь следующими методами класса \Bitrix\Sale\Location\LocationTable :

  • \Bitrix\Sale\Location\LocationTable::getList

  • \Bitrix\Sale\Location\LocationTable::getByCode

  • \Bitrix\Sale\Location\LocationTable::add

  • \Bitrix\Sale\Location\LocationTable::update

  • \Bitrix\Sale\Location\LocationTable::delete

События изменения значений

События, связанные с изменениями:

  • \Bitrix\Sale\Location\Location::OnBeforeAdd

  • \Bitrix\Sale\Location\Location::OnAdd

  • \Bitrix\Sale\Location\Location::OnAfterAdd

  • \Bitrix\Sale\Location\Location::OnBeforeUpdate

  • \Bitrix\Sale\Location\Location::OnUpdate

  • \Bitrix\Sale\Location\Location::OnAfterUpdate

  • \Bitrix\Sale\Location\Location::OnBeforeDelete

  • \Bitrix\Sale\Location\Location::OnDelete

Заключение

Наиболее универсальные сущности в Битриксе: ИБ, HL-блоки. Для них можно добавить собственный тип свойства, менять его внешний вид. Вторые по удобству сущности: пользователи, задачи Б24, склады и т.п. У таких сущностей уже есть предназначение и мы можем их только дополнять UF-полями. Наименее гибкие сущности: пункты меню, страницы и разделы сайта. Свойств можно создать сколько угодно, но хранить в них можно только строки.


Интересные статьи

Интересные статьи

SWAP (своп) — это механизм виртуальной памяти, при котором часть данных из оперативной памяти (ОЗУ) перемещается на хранение на HDD (жёсткий диск), SSD (твёрдотельный накоп...
Среди советов по улучшению юзабилити интернет-магазина, которые можно встретить в инете, один из явных лидеров — совет «сообщайте посетителю стоимость доставки как можно раньше».
Реализация ORM в ядре D7 — очередная интересная, перспективная, но как обычно плохо документированная разработка от 1с-Битрикс :) Призвана она абстрагировать разработчика от механики работы с табл...
Как обновить ядро 1С-Битрикс без единой секунды простоя и с гарантией работоспособности платформы? Если вы не можете закрыть сайт на техобслуживание, и не хотите экстренно разворачивать сайт из бэкапа...
Мы публикуем видео с прошедшего мероприятия. Приятного просмотра.