Работа с модулем
После установки модуля simai.complexprop становится доступным новый тип свойства инфоблоков - "составное свойство", которое позволяет объединять значения обычных свойств.
Выбрать свойства, участвующие в составном свойстве ("подсвойства"), можно в настройке составного свойства.
Число подсвойств в данный момент ограничено: не более семи подсвойств.
Внимание: эти свойства должны быть уже созданы, чтобы их можно было выбрать, т.е. одновременно создать составное свойство и его подсвойства нельзя!
На данный момент из стандартных типов НЕЛЬЗЯ использовать как подсвойства: видео, карты Яндекс и Гугл, привязку к элементам по xml, cчетчик, SCU-привязку к товарам.
Перечисленные типы не будут предлагаться для выбора в качестве подсвойств, равно как и прочие составные свойства, если они есть (вложенность составных свойств невозможна).
Остальные стандартные типы (строка, дата, список, файл, привязка к пользователю, к элементу и к разделу, в т.ч. с автозаполнением, текст/html и т.д.) использовать можно.
Использование нестандартных типов в качестве подсвойств не запрещено, но их корректная работа не гарантируется, особенно если они используют в своей работе поле описания.
Среди выбранных подсвойств в настройках составного свойства можно отметить обязательные для заполнения. В этом случае нельзя будет создать или отредактировать значение составного свойства, не заполнив такие обязательные подствойства.
Использовать стандартный механизм обязательных свойств битрикса (в общем списке свойств) для подствойств тоже возможно, но категорически не рекомендуется, т.к. в этом случае нельзя будет полностью удалить значения составного свойства.
Аналогично, крайне не рекомендуется отмечать само составное свойство как обязательное.
Составное свойство может быть как одиночным, так и множественным. Множественность подсвойств должна соответствовать правилу: множественное составное - множественные подсвойства, одиночное составное - одиночные подсвойства.
Подсвойства, не удовлетворяющие этому правилу, не будут выведены среди полей редактирования значений составного свойства.
У множественного составного свойства значения добавляются с помощью кнопки "Добавить составное значение". Максимальное количество составных значений, добавляемых за раз, регулируется стандартным параметром "Количество полей для ввода новых множественных значений" в настройках составного свойства.
Удаляются значения множественного составного свойства с помощью галочки "Удалить это составное значение", присутствующей у каждого существующего значения.
Поля ввода подсвойств у каждого значения множественного составного свойства выглядят как поля одиночных свойств соответствующих типов.
Поля описания подствойств используются в служебных целях, поэтому внутри составного свойства не выводятся. Если необходимо поле, аналогичное описанию для значения составного свойства, то это решается простым добавлением строкового подсвойства.
Настоятельно рекомендуется скрывать вывод полей подсвойств в форме редактирования элемента с помощью настроек вида этой формы, чтобы избежать дублирования ввода.
В общем случае заполнение полей подсвойства внутри значений составного свойства имеет приоритет над заполнением полей этого же свойства вне составного свойства.
В одном инфоблоке может быть два и более составных свойств.
Использование одних и тех же подствойств разными составными свойствами не допускается! Для предупреждения этого при настройке составных свойств не предлагаются к выбору подсвойства, уже задействованные в других составных свойствах.
Структура значений составного свойства при использовании в компонентах публичной части выглядит таким образом:
ДЛЯ ОДИНОЧНОГО:
Массив VALUE:
Массив DISPLAY_VALUE (только если составное свойства выбрано в параметрах данного компонента):
ДЛЯ МНОЖЕСТВЕННОГО:
VALUE:
DISPLAY_VALUE:
Следует отметить, что если у множественного составного свойства задано только одно значение, то массив DISPLAY_VALUE будет аналогичен таковому для одиночного составного свойства.
Выбрать свойства, участвующие в составном свойстве ("подсвойства"), можно в настройке составного свойства.
Число подсвойств в данный момент ограничено: не более семи подсвойств.
Внимание: эти свойства должны быть уже созданы, чтобы их можно было выбрать, т.е. одновременно создать составное свойство и его подсвойства нельзя!
На данный момент из стандартных типов НЕЛЬЗЯ использовать как подсвойства: видео, карты Яндекс и Гугл, привязку к элементам по xml, cчетчик, SCU-привязку к товарам.
Перечисленные типы не будут предлагаться для выбора в качестве подсвойств, равно как и прочие составные свойства, если они есть (вложенность составных свойств невозможна).
Остальные стандартные типы (строка, дата, список, файл, привязка к пользователю, к элементу и к разделу, в т.ч. с автозаполнением, текст/html и т.д.) использовать можно.
Использование нестандартных типов в качестве подсвойств не запрещено, но их корректная работа не гарантируется, особенно если они используют в своей работе поле описания.
Среди выбранных подсвойств в настройках составного свойства можно отметить обязательные для заполнения. В этом случае нельзя будет создать или отредактировать значение составного свойства, не заполнив такие обязательные подствойства.
Использовать стандартный механизм обязательных свойств битрикса (в общем списке свойств) для подствойств тоже возможно, но категорически не рекомендуется, т.к. в этом случае нельзя будет полностью удалить значения составного свойства.
Аналогично, крайне не рекомендуется отмечать само составное свойство как обязательное.
Составное свойство может быть как одиночным, так и множественным. Множественность подсвойств должна соответствовать правилу: множественное составное - множественные подсвойства, одиночное составное - одиночные подсвойства.
Подсвойства, не удовлетворяющие этому правилу, не будут выведены среди полей редактирования значений составного свойства.
У множественного составного свойства значения добавляются с помощью кнопки "Добавить составное значение". Максимальное количество составных значений, добавляемых за раз, регулируется стандартным параметром "Количество полей для ввода новых множественных значений" в настройках составного свойства.
Удаляются значения множественного составного свойства с помощью галочки "Удалить это составное значение", присутствующей у каждого существующего значения.
Поля ввода подсвойств у каждого значения множественного составного свойства выглядят как поля одиночных свойств соответствующих типов.
Поля описания подствойств используются в служебных целях, поэтому внутри составного свойства не выводятся. Если необходимо поле, аналогичное описанию для значения составного свойства, то это решается простым добавлением строкового подсвойства.
Настоятельно рекомендуется скрывать вывод полей подсвойств в форме редактирования элемента с помощью настроек вида этой формы, чтобы избежать дублирования ввода.
В общем случае заполнение полей подсвойства внутри значений составного свойства имеет приоритет над заполнением полей этого же свойства вне составного свойства.
В одном инфоблоке может быть два и более составных свойств.
Использование одних и тех же подствойств разными составными свойствами не допускается! Для предупреждения этого при настройке составных свойств не предлагаются к выбору подсвойства, уже задействованные в других составных свойствах.
Структура значений составного свойства при использовании в компонентах публичной части выглядит таким образом:
ДЛЯ ОДИНОЧНОГО:
Массив VALUE:
Array
(
[ELEMENT] => {id элемента инфоблока}
[SUB_VAL_IDS] => Array
(
[{id подствойства}] => {id значения подсвойства, файла или привязки для служебных целей},
.............
)
[SUB_VALUES] => Array
(
[{символьный или числовой код подствойства}] => {массив значения подсвойства, аналогичный массиву VALUE у одиночного свойства того же типа},
.............
)
)
Массив DISPLAY_VALUE (только если составное свойства выбрано в параметрах данного компонента):
Array
(
[ELEMENT] => {id элемента инфоблока}
[SUB_VALUES] => Array
(
[{символьный или числовой код подствойства}] => {массив обработанного значения подсвойства, аналогичный массиву DISPLAY_VALUE у одиночного свойства того же типа},
.............
)
)
ДЛЯ МНОЖЕСТВЕННОГО:
VALUE:
Array
(
[0] => {массив аналогичный VALUE одиночного составного свойства для первого значения},
[1] => {массив аналогичный VALUE одиночного составного свойства для второго значения},
.........
)
DISPLAY_VALUE:
Array
(
[0] => {массив аналогичный DISPLAY_VALUE одиночного составного свойства для первого значения},
[1] => {массив аналогичный DISPLAY_VALUE одиночного составного свойства для второго значения},
.........
)
Следует отметить, что если у множественного составного свойства задано только одно значение, то массив DISPLAY_VALUE будет аналогичен таковому для одиночного составного свойства.