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

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

Типы свойств

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

  1. Перейдите на страницу Контент > Инфоблоки > Типы инфоблоков > [Название_типа_инфоблоков].
  2. В колонке команд выбрать команду Свойства для нужного инфоблока. Откроется страница списка свойств для элементов инфоблока.
  3. На контекстной панели нажмите кнопку Добавить свойство или в меню действий конкретного свойства выберите команду Изменить.

либо:

  1. Перейдите на страницу Контент > Инфоблоки > Типы инфоблоков > [Название_типа_инфоблоков].
  2. В колонке команд выбрать команду Изменить.
  3. Перейдите на закладку Свойства.
  4. В строке с нужным свойством элемента нажмите на кнопку [...]. Откроется форма настройки свойств информационного блока.

Общие поля


ПолеОписание
IDИдентификатор свойства.
Свойство активно Признак активности свойства (если свойство активно, оно может быть выбрано для показа в публичной части сайта).
Порядок сортировкиЗадается "вес" свойства, определяющий его положение в общем списке свойств.
НазваниеНазвание свойства элементов инфоблока. (255 знаков)
Символьный код Мнемонический код свойства, состоящий из латинских символов и цифр.
Внешний код Символьный код, используемый для связи инфоблока с внешним источником данных. Поле отображается при включенной опции Показывать код загрузки из внешних источников в настройках модуля Информационные блоки.
МножественноеПризнак множественности свойства, т.е. наличия одновременно нескольких значений данного свойства.
Например, свойство элементов Цвет панели инфоблока Мобильные телефоны может одновременно иметь следующие значения: синий, красный, черный и т.д.

Примечание: начиная с версии 12.5.7 модуля Информационные блоки, свойство типа Привязка к товарам (SKU) не может быть множественным. Тип ранее созданных множественных свойств должен быть сменен на Привязка к элементами с автозаполнением.
ОбязательноеПризнак обязательности заполнения данного свойства при создании/редактировании элемента инфоблока.
Показывать на странице редактирования элементаПри отмеченной опции свойство будет отображаться в форме редактирования элемента.
Показывать в умном фильтреПри отмеченной опции свойство будет отображаться в умном фильтре. Недоступно для типов свойств Файл и Видео.
Вид в умном фильтреЗадается один из видов отображения (с учетом типа свойства) значений свойства в умном фильтре. Недоступно для типов свойств Файл и Видео
Показать развёрнутымПризнак отображения свойства в развернутом виде в умном фильтре. Недоступно для типов свойств Файл и Видео.
Подсказка в умном фильтре для посетителейУказывается текст подсказки, отображаемой посетителям в умном фильтре. Недоступно для типов свойств Файл и Видео.
ПодсказкаТекст, который будет выводится в тултипе рядом с полем в форме создания элемента.
Параметры свойства
Показывать на странице списка элементовПри отмеченной опции свойство будет отображено на странице со списком элементов. Параметр доступен для свойств всех товарных инфоблоков: простых инфоблоков с товарами, основных инфоблоков и инфоблоков торговых предложений.
Показывать на детальной странице элементаПри отмеченной опции свойство будет отображено на детальной странице элемента. Параметр также доступен для свойств всех товарных инфоблоков.
Значение добавляется в корзинуПри отмеченной опции свойство будет отображено в корзине и на странице оформления заказа. Параметр всегда доступен для свойств простых инфоблоков с товарами и инфоблоков торговых предложений. Для свойств основных инфоблоков параметр доступен в следующих случаях:
  • если свойство одиночное, то оно должно быть типа Список или Привязка к элементам;
  • если свойство множественное, то оно может быть любого типа, кроме типа Файл.
Используется для выбора торговых предложенийПараметр доступен только для инфоблоков торговых предложений, в свойствах типа Список, Справочник и Привязка к элементам (причём они не должны быть множественными). Свойство будет отображаться на странице товара как инструмент выбора предложений . Если свойство используется в блоке выбора, оно не будет отображено в блоке характеристик товара, даже при отмеченных опциях показа на детальной странице и странице списка элементов.


Строка, Число, Привязка к пользователю, Привязка к файлу (на сервере)

ПолеОписание
Значения свойств участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойствуОпределяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания значения данного свойства в форме создания/редактирования элементов информационного блока.

Данный параметр недоступен для свойств типа Привязка к пользователю.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).

Данный параметр недоступен для свойств типа Привязка к файлу (на сервере).
Размер поля для ввода значения (Строк х Столбцов)Определяется длина и ширина поля для ввода значения данного свойства в форме создания/редактирования элементов инфоблока. Длина и ширина поля задаются числом столбцов и строк соответственно.
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию.


Список

ПолеОписание
Внешний вид Форма представления списка доступных значений свойства:
  • список - значение свойства выбирается из списка;
  • флажки - значение свойства указывается с помощью флажка, устанавливаемого в поле рядом с нужным значением.
Количество строк (для внешнего вида "список")Высота поля со списком в строках (используется, если в предыдущем поле выбрано значение список).
Значения свойств участвуют в поиске Разрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.

Поле в фильтре будет иметь то же название и тип, что и данное свойство. Например, для свойства Год выпуска типа список данное поле в фильтре будет называться Год выпуска, а доступные значения поля будут представлены в виде списка.
Значения списка

Данное поле служит для создания списка доступных значений свойства.

ID XML_ID ЗначениеСорт.Умолч.
[1][2][3][4][5]
ПолеОписание
[1] ID Идентификатор значения свойства в списке (не задается).
[2] XML_ID Идентификатор значения свойства в списке. Задается символами латинского алфавита и цифрами (не должен начинаться с цифры).
[3] Значение (нет значения по умолчанию) Поле для создания возможного значения свойства.
[4] Сорт. Относительный "вес" возможного значения, определяющий положение значения в списке.
[5] Умолч. Признак того, что для новых элементов инфоблока по умолчанию настраиваемое свойство будет принимать данное значение.


Файл

ПолеОписание
Значения свойств участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания данного свойства в форме создания/редактирования элементов информационного блока.
Размер поля для ввода (столбцов)Длина поля для ввода значения свойства. Задается количеством столбцов.
Типы загружаемых файлов (расширения через запятую)Список расширений (через запятую) доступных для загрузки файлов.
Типы файлов можно указать вручную через запятую или выбрать из списка. Доступно несколько вариантов подборки типов:
  • (любые) - к загрузке доступны все нижеперечисленные типы файлов;
  • Изображения - jpg, gif, bmp, png, jpeg, webp;

    Поддержка формата изображений webp доступна с версии 20.5.0 модуля Информационные блоки.

  • Звуки - mp3, wav, midi, snd, au, wma;
  • Видео - mpg, avi, wmv, mpeg, mpe, flv;
  • Документы - doc, txt, rtf.


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

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


HTML/текст

ПолеОписание
Значения свойств участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания данного свойства в форме создания/редактирования элементов информационного блока.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию. Выводится в форме редактирования только при создании элемента.
Дополнительные настройки
Высота окна редактораВысота окна визуального редактора в пикселях.


Видео

ПолеОписание
Значения свойств участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания данного свойства в форме создания/редактирования элементов информационного блока.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Настраиваемые параметры плеера
Общие настройки
Размер буфера в секундахУказывается сколько секунд воспроизведения ролика сохранять в буфере обмена, прежде чем начать проигрывать.
Расположение панели управления Указывается расположение панели управления плеера:
  • Внизу - снизу окна просмотра;
  • Не показывать - панель управления будет скрыта.
Автоматически начать проигрыватьПри отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.
Уровень громкости в процентах от максимальногоУказывается уровень громкости звука в процентах от максимального заданного в системе.
Настройки Flash-плеера
СкинВыбирается скин Flash плеера.
Дополнительные переменные FlashvarsУказываются дополнительные переменные для плеера.
Режим окна (WMode)Указывается режим окна Flash плеера:
  • Обычный - медиафайл будет проигрываться на странице в собственном прямоугольном окне. Этот вариант дает наибольший выигрыш в скорости воспроизведения анимации;
  • Непрозрачный - медиафайл будет помещен на задний план страницы.
  • Прозрачный - фон страницы будет "проглядывать" через все прозрачные места медиафайла при проигрывании. Этот вариант может замедлить скорость воспроизведения анимации.
Настройки WMV-плеера
Цвет фона панели управленияУказывается код цвета для фона панели управления плеера.
Цвет элементов управленияУказывается код цвета для элементов управления плеера.
Цвет элементов управления при наведении указателя мышиУказывается код цвета для элементов управления плеера при наведении указателя мыши.
Цвет экранаУказывается код цвета для экрана плеера.
Дополнительные переменные SilverlightУказываются дополнительные переменные для плеера.
Режим окнаУказывается режим окна WMW плеера:
  • Обычный - окно плеера будет убрано за HTML элементы страницы;
  • Прозрачный - окно плеера будет отображаться непосредственно в клиентской области обозревателя или внутри специально созданного окна.


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

ПолеОписание
Значения свойств участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания данного свойства в форме создания/редактирования элементов информационного блока.


Данный параметр недоступен для свойств типа Привязка к элементам по XML_ID.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом параметре определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию. С помощью кнопки Календарь можно выбрать дату из календаря.


Деньги

Тип свойства "Деньги" (доступен только при наличии установленного модуля Валюты).

ПолеОписание
Значения свойства участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойствуОпределяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Выводить поле для описания значенияОпределяется, будет ли выводиться поле для описания данного свойства в форме создания/редактирования элементов информационного блока.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Размер поля для ввода значения (Строк х Столбцов)Определяется длина и ширина поля для ввода значения данного свойства в форме создания/редактирования элементов инфоблока. Длина и ширина поля задаются числом столбцов и строк соответственно.
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию (указывается сумма и валюта).


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

ПолеОписание
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию.
Дополнительные настройки
Ключ JavaScript APIAPI-ключ для работы с сервисом Google Maps.

Данный параметр доступен только для типа свойств Привязка к карте Google Maps.


Привязка к разделам с автозаполнением, Привязка к товарам (SKU), Привязка к элементам с автозаполнением

ПолеОписание
Выводить на странице списка элементов поле для фильтрации по этому свойствуОпределяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Информационный блокВыбирается тип информационного блока и инфоблок из которого получаются значения для свойства. Если инфоблок не выбран, то кнопка добавления элемента (раздела) выводиться не будет при указании значения свойства.
Настройки привязки к разделамм (элементам) с автозаполнением/Настройки SKU
Интерфейс показаВ выпадающем списке выберите один из вариантов интерфейса показа элементов:
  • Строка с автозаполнением - данные для автозаполнения отображаются в виде всплывающего окна с подсказками.
  • Строка с автозаполнением и выбор из списка - данные для автозаполнения отображаются в виде всплывающего окна с подсказками либо выбираются из окна списка.
    Данный вариант показа недоступен для типа "Привязка к разделам с автозаполнением".
  • Строка с автозаполнением и выбор из окна поиска - данные для автозаполнения отображаются в виде всплывающего окна с подсказками либо выбираются из окна поиска.
Показывать кнопку добавления элементов (разделов)Под полем строки с автозаполнением появится кнопка Добавить элемент (Добавить раздел). С помощью этой кнопки можно быстро добавить элемент (раздел) в инфоблок, выбранный в поле Информационный блок.

Данное поле не отображается для типа Привязка к товарам (SKU).
Брать название кнопки добавления из настроек связанного инфоблокаНазвание кнопки Добавить элемент (Добавить раздел) смениться на название из настроек выбранного инфоблока.
Максимальная ширина поля ввода в пикселах (0 - не ограничивать)Можно задать ограничение ширины поля ввода.
Минимальная высота поля ввода в пикселах, если свойство множественноеМожно задать ограничение высоты поля ввода, при множественном свойстве.
Максимальная высота поля ввода в пикселах, если свойство множественноеМожно задать ограничение высоты поля ввода, при множественном свойстве. Применяется, если надо ограничить высоту формы при большом числе свойств.
Заменяемые при показе символыВозможны проблемы с отображением названий элементов (разделов), содержащих в названии ряд символов. Например, при использовании запятой. Проблема проявляется в размножении таких названий в списке. Избежать этой ситуации можно, указав в настройках свойства перечень таких символов и выбрав символ автозамены в поле ниже. Сами названия элементов (разделов) от такой замены не меняются.
Символ, который заменит при показе запрещенные символыВ выпадающем списке или в пустом поле рядом со списком укажите символ, который заменит искажающие символы в названиях.


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

ПолеОписание
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Значение по умолчаниюЗначение данного свойства, присваиваемое всем вновь создаваемым элементам информационного блока по умолчанию. С помощью кнопки Календарь можно выбрать дату из календаря.


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

ПолеОписание
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Информационный блокИнформационный блок, к элементам которого может осуществляться привязка элементов данного инфоблока.
Дополнительные настройки
Высота спискаЕсли данное свойство является множественным, то в этом определяется количество строк, отображаемых в окне множественного значения. Если число элементов значения превысит число, выбранное в этом поле, то весь список можно будет просмотреть с помощью полосы прокрутки.
Ограничить по ширине задание в пикслах ширины окна списка. При значении равном 0 поле ограничивается длиной самого большого названия элемента.
Группировать по разделамЕсли инфоблок, выбранный в поле "Информационный блок" обладает древовидной структурой, то вывод элементов в списке будет осуществляться по разделам с выделением названия раздела жирным шрифтом.
Отображать в виде списка множественного выбораПри установленной опции список привязанных элементов доступен для множественного выбора элементов в одном поле, при снятой - каждый элемент выбирается в виде отдельной строки.


Справочник

Тип свойства "Справочник" (доступен только при наличии установленного модуля Highload-блоки).

ПолеОписание
Значения свойства участвуют в поискеРазрешается или запрещается индексация значений данного свойства для внутреннего поиска.
Выводить на странице списка элементов поле для фильтрации по этому свойствуОпределяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Дополнительные настройки
Выберите справочникВыбирается Highload-блок, который будет использоваться в качестве справочника. Если указывается значение Создать новый справочник, то становятся доступным поле Название справочника.
Название справочникаНазвание нового справочника (Highload-блока). Если задан кириллицей, то будет выполнена его транслитерация.
Записи справочникаСоздание и редактирование записей выполняется с помощью следующих полей:
ПолеОписание
НазваниеНазвание записи справочника.
Сортировка"Вес" записи справочника, определяющий положение записи в списке.
Внешний кодВнешний код записи справочника (служит для создания связей и выгрузки в 1С).
ИзображениеКартинка записи справочника. Кнопка Обзор... служит для выбора файла.
СсылкаСсылка на некоторую страницу. Используется при отображении записи в публичном разделе.
По умолчаниюПризнак того, что именно текущая запись будет отображаться по умолчанию в списке записей в публичном разделе. По умолчанию может быть только одна запись.
ОписаниеОписание записи. Например, при использовании компонента брендов будет отображаться в публичном разделе при отсутствии изображения у записи.
Полное описаниеПолное описание записи. Например, при использовании компонента брендов выводится в качестве всплывающей подсказки в публичном разделе.

Для удаления записи следует нажать на "крестик", расположенный в соответствующей строке записи.



Счетчик

ПолеОписание
Выводить на странице списка элементов поле для фильтрации по этому свойству Определяет возможность вывода в фильтре на странице со списком элементов отдельного поля, с помощью которого будет осуществляться фильтрация элементов по значениям данного свойства.
Количество полей для ввода новых множественных значенийЕсли данное свойство является множественным, то в этом определяется количество полей для ввода значений свойства (т.е. количество возможных значений свойства).
Дополнительные настройки
Разрешается изменять значенияПри отмеченной опции пользователю будет разрешено изменять значения счетчика.
Текущее значение счетчикаЗадается начальное значение счетчика, от которого будет происходить отсчет.





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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх