Если вы сталкивались с ситуациями когда вам одного свойства в строку мало и хотелось бы хранить сразу несколько свойств в одной строке, то этот модуль для вас!
Модуль позволяет создать необходимые свойства и затем просто объединить их все в одно составное свойство. Вы можете объединять несколько обычных свойств в одну строку или несколько множественных свойств в одно составное множественное свойство - таблицу.
Основные инструкции по использованию и настройке Составных свойств можно найти на вкладке Установка.
ВНИМАНИЕ: составное свойство в текущей версии не поддерживает экспорт/импорт (csv, xml), а также копирование элементов!
А если вам требуется сохранить данные инфоблоков от изменения или удаления, то рекомендуем вам модуль «SIMAI: Спасение данных», который может восстановить удаленные элементы инфоблоков или отдельные измененные свойства, в том числе файлы без необходимости восстановления всего бекапа.
Модуль позволяет создать необходимые свойства и затем просто объединить их все в одно составное свойство. Вы можете объединять несколько обычных свойств в одну строку или несколько множественных свойств в одно составное множественное свойство - таблицу.
Основные инструкции по использованию и настройке Составных свойств можно найти на вкладке Установка.
ВНИМАНИЕ: составное свойство в текущей версии не поддерживает экспорт/импорт (csv, xml), а также копирование элементов!
А если вам требуется сохранить данные инфоблоков от изменения или удаления, то рекомендуем вам модуль «SIMAI: Спасение данных», который может восстановить удаленные элементы инфоблоков или отдельные измененные свойства, в том числе файлы без необходимости восстановления всего бекапа.
Отзывы
Оставить отзыв
Загрузка отзывов...
ДОКУМЕНТАЦИЯУСТАНОВКА
После установки модуля simai.complexprop становится доступным новый тип свойства инфоблоков - "составное свойство", которое позволяет объединять значения обычных свойств.
Выбрать свойства, участвующие в составном свойстве ("подсвойства"), можно в настройке составного свойства.
Число подсвойств в данный момент ограничено: не более семи подсвойств.
Внимание: эти свойства должны быть уже созданы, чтобы их можно было выбрать, т.е. одновременно создать составное свойство и его подсвойства нельзя!
На данный момент из стандартных типов НЕЛЬЗЯ использовать как подсвойства: видео, карты Яндекс и Гугл, привязку к элементам по xml, cчетчик, SCU-привязку к товарам.
Перечисленные типы не будут предлагаться для выбора в качестве подсвойств, равно как и прочие составные свойства, если они есть (вложенность составных свойств невозможна).
Остальные стандартные типы (строка, дата, список, файл, привязка к пользователю, к элементу и к разделу, в т.ч. с автозаполнением, текст/html и т.д.) использовать можно.
Использование нестандартных типов в качестве подсвойств не запрещено, но их корректная работа не гарантируется, особенно если они используют в своей работе поле описания.
Среди выбранных подсвойств в настройках составного свойства можно отметить обязательные для заполнения. В этом случае нельзя будет создать или отредактировать значение составного свойства, не заполнив такие обязательные подствойства.
Использовать стандартный механизм обязательных свойств битрикса (в общем списке свойств) для подствойств тоже возможно, но категорически не рекомендуется, т.к. в этом случае нельзя будет полностью удалить значения составного свойства.
Аналогично, крайне не рекомендуется отмечать само составное свойство как обязательное.
Составное свойство может быть как одиночным, так и множественным. Множественность подсвойств должна соответствовать правилу: множественное составное - множественные подсвойства, одиночное составное - одиночные подсвойства.
Подсвойства, не удовлетворяющие этому правилу, не будут выведены среди полей редактирования значений составного свойства.
У множественного составного свойства значения добавляются с помощью кнопки "Добавить составное значение". Максимальное количество составных значений, добавляемых за раз, регулируется стандартным параметром "Количество полей для ввода новых множественных значений" в настройках составного свойства.
Удаляются значения множественного составного свойства с помощью галочки "Удалить это составное значение", присутствующей у каждого существующего значения.
Поля ввода подсвойств у каждого значения множественного составного свойства выглядят как поля одиночных свойств соответствующих типов.
Поля описания подствойств используются в служебных целях, поэтому внутри составного свойства не выводятся. Если необходимо поле, аналогичное описанию для значения составного свойства, то это решается простым добавлением строкового подсвойства.
Настоятельно рекомендуется скрывать вывод полей подсвойств в форме редактирования элемента с помощью настроек вида этой формы, чтобы избежать дублирования ввода.
В общем случае заполнение полей подсвойства внутри значений составного свойства имеет приоритет над заполнением полей этого же свойства вне составного свойства.
В одном инфоблоке может быть два и более составных свойств.
Использование одних и тех же подствойств разными составными свойствами не допускается! Для предупреждения этого при настройке составных свойств не предлагаются к выбору подсвойства, уже задействованные в других составных свойствах.
Структура значений составного свойства при использовании в компонентах публичной части выглядит таким образом:
ДЛЯ ОДИНОЧНОГО:
Массив VALUE:
DISPLAY_VALUE выводится в виде html-таблицы со значениями подствойств.
ДЛЯ МНОЖЕСТВЕННОГО:
VALUE:
DISPLAY_VALUE:
Следует отметить, что если у множественного составного свойства задано только одно значение, то массив DISPLAY_VALUE будет аналогичен таковому для одиночного составного свойства.
Работа через API
Начиная с версии 1.1.0 есть возможность устанавливать значения
составного свойства через API Битрикс, используя методы CIBlockElement::Add и CIBlockElement::Update.
Для этого нужно в массиве PROPERTY_VALUES указывать значения составного свойства -- обязательно в виде массива значений.
Для каждого значения должен быть задан подмассив SUBPROP_VALUES, где должны быть указаны значения подсвойств, относящихся к данному значению составного свойства.
При этом можно использовать как числовые иды свойств, так и их мнемонические коды.
Пример:
Для метода CIBlockElement::Update массив PROPERTY_VALUES выглядит точно так же.
Что нужно знать касательно работы через API:
После установки модуля simai.complexprop становится доступным новый тип свойства инфоблоков - "составное свойство", которое позволяет объединять значения обычных свойств.
Выбрать свойства, участвующие в составном свойстве ("подсвойства"), можно в настройке составного свойства.
Число подсвойств в данный момент ограничено: не более семи подсвойств.
Внимание: эти свойства должны быть уже созданы, чтобы их можно было выбрать, т.е. одновременно создать составное свойство и его подсвойства нельзя!
На данный момент из стандартных типов НЕЛЬЗЯ использовать как подсвойства: видео, карты Яндекс и Гугл, привязку к элементам по xml, cчетчик, SCU-привязку к товарам.
Перечисленные типы не будут предлагаться для выбора в качестве подсвойств, равно как и прочие составные свойства, если они есть (вложенность составных свойств невозможна).
Остальные стандартные типы (строка, дата, список, файл, привязка к пользователю, к элементу и к разделу, в т.ч. с автозаполнением, текст/html и т.д.) использовать можно.
Использование нестандартных типов в качестве подсвойств не запрещено, но их корректная работа не гарантируется, особенно если они используют в своей работе поле описания.
Среди выбранных подсвойств в настройках составного свойства можно отметить обязательные для заполнения. В этом случае нельзя будет создать или отредактировать значение составного свойства, не заполнив такие обязательные подствойства.
Использовать стандартный механизм обязательных свойств битрикса (в общем списке свойств) для подствойств тоже возможно, но категорически не рекомендуется, т.к. в этом случае нельзя будет полностью удалить значения составного свойства.
Аналогично, крайне не рекомендуется отмечать само составное свойство как обязательное.
Составное свойство может быть как одиночным, так и множественным. Множественность подсвойств должна соответствовать правилу: множественное составное - множественные подсвойства, одиночное составное - одиночные подсвойства.
Подсвойства, не удовлетворяющие этому правилу, не будут выведены среди полей редактирования значений составного свойства.
У множественного составного свойства значения добавляются с помощью кнопки "Добавить составное значение". Максимальное количество составных значений, добавляемых за раз, регулируется стандартным параметром "Количество полей для ввода новых множественных значений" в настройках составного свойства.
Удаляются значения множественного составного свойства с помощью галочки "Удалить это составное значение", присутствующей у каждого существующего значения.
Поля ввода подсвойств у каждого значения множественного составного свойства выглядят как поля одиночных свойств соответствующих типов.
Поля описания подствойств используются в служебных целях, поэтому внутри составного свойства не выводятся. Если необходимо поле, аналогичное описанию для значения составного свойства, то это решается простым добавлением строкового подсвойства.
Настоятельно рекомендуется скрывать вывод полей подсвойств в форме редактирования элемента с помощью настроек вида этой формы, чтобы избежать дублирования ввода.
В общем случае заполнение полей подсвойства внутри значений составного свойства имеет приоритет над заполнением полей этого же свойства вне составного свойства.
В одном инфоблоке может быть два и более составных свойств.
Использование одних и тех же подствойств разными составными свойствами не допускается! Для предупреждения этого при настройке составных свойств не предлагаются к выбору подсвойства, уже задействованные в других составных свойствах.
Структура значений составного свойства при использовании в компонентах публичной части выглядит таким образом:
ДЛЯ ОДИНОЧНОГО:
Массив VALUE:
Array ( [ELEMENT] => {id элемента инфоблока} [SUB_VAL_IDS] => Array ( [{id подствойства}] => {id значения подсвойства, файла или привязки для служебных целей}, ............. ) [SUB_VALUES] => Array ( [{символьный или числовой код подствойства}] => {массив значения подсвойства, аналогичный массиву VALUE у одиночного свойства того же типа}, ............. ) ) |
DISPLAY_VALUE выводится в виде html-таблицы со значениями подствойств.
ДЛЯ МНОЖЕСТВЕННОГО:
VALUE:
| Array ( [0] => {массив аналогичный VALUE одиночного составного свойства для первого значения}, [1] => {массив аналогичный VALUE одиночного составного свойства для второго значения}, ......... ) |
DISPLAY_VALUE:
| Array ( [0] => html-таблица со значениями подствойств, [1] => html-таблица со значениями подствойств, ......... ) |
Следует отметить, что если у множественного составного свойства задано только одно значение, то массив DISPLAY_VALUE будет аналогичен таковому для одиночного составного свойства.
Работа через API
Начиная с версии 1.1.0 есть возможность устанавливать значения
составного свойства через API Битрикс, используя методы CIBlockElement::Add и CIBlockElement::Update.
Для этого нужно в массиве PROPERTY_VALUES указывать значения составного свойства -- обязательно в виде массива значений.
Для каждого значения должен быть задан подмассив SUBPROP_VALUES, где должны быть указаны значения подсвойств, относящихся к данному значению составного свойства.
При этом можно использовать как числовые иды свойств, так и их мнемонические коды.
Пример:
CModule::IncludeModule("iblock");
$el = new CIBlockElement;
$arFields = Array(
"IBLOCK_ID" => 12,
"NAME" => "Элемент",
"PROPERTY_VALUES" => array(
"TEST_COMPLEX_PROP" => array(
"0" => array(
"SUBPROP_VALUES" => array(
"FIO" => "Иванов Иван",
"PHOTO" => array_merge(CFile::MakeFileArray($_SERVER["DOCUMENT_ROOT"]."/upload/abc.jpg"), array("module_id" => "iblock"))
)
),
"1" => array(
"SUBPROP_VALUES" => array(
"FIO" => "Петров Петр",
)
),
),
)
);
if($EL_ID = $el->add($arFields))
echo "New ID: ".$EL_ID;
else
echo "Error: ".$el->LAST_ERROR;
|
Что нужно знать касательно работы через API:
- При задании составных значений через API обязательность заполнения подствойств по встроенному механизму составного свойства автоматически НЕ проверяется.
Проверка корректности заполнения подствойств в этом случае - задача самого разработчика. - Значения подсвойств следует задавать только через
SUBPROP_VALUES составных значений, задавать их как отдельные свойства в PROPERTY_VALUES не следует. - При задании значений подсвойств и самого составного свойства не нужно задавать значения поле описания -- описание в составном свойстве используется в служебных целях.
- Такие методы битрикс, как CIBlockElement::SetPropertyValues и CIBlockElement::SetPropertyValueCode для работы с составным свойством использоваться НЕ ДОЛЖНЫ.
ТЕХНИЧЕСКАЯ ПОДДЕРЖКА
- Техническая поддержка решения осуществляется через специальный раздел по адресу https://support.simai.ru/
- Вы можете проконсультироваться по приобретению решения по телефону 8-800-2000-865, email: sale@simai.ru и через сайт http://simai.ru/about/contact.php
Код модуля
simai.complexprop
Название компании-партнера
Подходящие редакции 1С-Битрикс
Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес, Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес, Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт, Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт, Программа для ЭВМ "1С-Битрикс24". Лицензия Корпоративный портал - 50 (12 мес.), Программа для ЭВМ "1С-Битрикс24". Лицензия Энтерпрайз (12 мес.)
Число установок
Более 1000 раз
Последняя версия
1.5.0
Дата публикации
08.09.2016
Дата обновления
19.05.2024
Модуль бесплатный
Наличие демо-режима
Наличие
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Новости
