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

Создание и редактирование пользовательского поля

В этом разделе

  • Контекстная панель
  • Форма редактирования
  • Контекстная панель

    КнопкаОписание
    Список Переход к списку пользовательских полей.
    Добавить Переход к добавлению нового пользовательского поля.

    Кнопка отображается при редактировании существующего пользовательского поля.
    Удалить Удаление редактируемого пользовательского поля.

    Кнопка отображается при редактировании существующего пользовательского поля.

    Форма редактирования

    Форма предназначена для управления параметрами пользовательского поля.

    number
    ПолеОписание
    ID Уникальный идентификатор пользовательского поля. Присваивается после сохранения.
    *Тип данных (можно задать только для нового поля) Выбирается один из возможных типов данных:
  • Привязка к элементам highload-блоков;
  • Документ из библиотеки документов;
  • Число;
  • Да/Нет;
  • Видео;
  • Деньги;
  • Шаблон;
  • Список;
  • Строка;
  • Дата со временем или Дата;
  • Привязка к сотруднику (Для коробочной версии Битрикс24, дополнительных полей не имеет);
  • Привязка к разделам или элементам инф. блоков;
  • Привязка к элементам CRM;
  • Привязка к справочникам CRM;
  • Файл;
  • Целое число;
  • Опрос.
  • Ссылка.
  • Адрес.

  • Примечание: в зависимости от выбранного типа секция Дополнительные настройки поля будет иметь различный вид.
    *Объект Код объекта, к которому относится поле. Можно задать только для нового поля.
    *Код поля (можно задать только для нового поля) Код самого поля. Можно задать только для нового поля.
    XML_ID Указывается идентификатор поля для работы с внешними источниками.
    Сортировка Индекс сортировки, определяющий положение поля в общем списке.
    Множественное (можно задать только для нового поля) При отмеченной опции значение поля будет множественным. Можно задать только для нового поля.
    Обязательное При отмеченной опции поле будет обязательным для заполнения.
    Показывать в фильтре списка Указывается способ отображения поля в фильтре:
    • не показывать - поле не будет показано в фильтре;
    • точное совпадение - поле будет показано в фильтре. Для нахождения элемента требуется точное совпадение условию поиска;
    • поиск по маске - поле будет показано в фильтре. Для поиска элемента в списке по данному полю можно использовать маску;
    • поиск по подстроке - поле будет показано в фильтре. Для нахождения элемента выполнятся поиск по подстроке.
    Не показывать в списке При отмеченной опции поле не будет отображаться в списке элементов в месте применения.
    Не разрешать редактирование пользователем При отмеченной опции значение поля нельзя редактировать, только вычислять и устанавливать через API.
    Значения поля участвуют в поиске При отмеченной опции значения поля будут участвовать в поиске в публичной части после переиндексации сайта.
    Дополнительные настройки поля (зависят от типа)
    Привязка к элементам highload-блоков
    Highload-блок Задается highload-блок и поле для показа.
    Значение по умолчанию Можно определить значение по умолчанию.
    Внешний вид Указывается тип внешнего вида:
    • Список;
    • Флажки.
    Высота списка Указывается высота списка.
    Документ из библиотеки документов (для коробочной версии Битрикс24)
    Инфоблок библиотеки документов Указывается тип информационного блока и инфоблок из доступных в системе.
    Пользовательское свойство для сохранения настроек редактирования Уникальный символьный код свойства.
    Число
    Точность (количество знаков после запятой) Определяется точность числа - количество знаков после запятой.
    Значение по умолчанию Можно определить значение по умолчанию.
    Размер поля ввода для отображения Указывается размер поля, каким он будет отображен в форме, где используется данное поле. По умолчанию указано 20.
    Минимальне значение (0 - не проверять) Можно установить минимальное допустимое значение. Если установлено 0, то не проверять.
    Максимальное значение (0 - не проверять) Можно установить максимальное допустимое значение. Если установлено 0, то не проверять.
    Да/Нет
    Подписи для значений Задание собственных название полей Да и Нет.
    Значение по умолчанию Устанавливается, что будет значением по умолчанию, Да или Нет.
    Внешний вид Выбирается один из возможных внешних видов поля:
    • Флажок;
    • Радио кнопки;
    • Выпадающий список.
    Подпись флажка Задание надписи для флажка. Действует при выборе Флажок в поле Внешний вид.
    Видео
    Общие настройки
    Размер буфера в секундах Указывается сколько секунд воспроизведения ролика сохранять в буфере обмена, прежде чем начать проигрывать. Рекомендуется для медленного трафика.
    Расположение панели управления Указывается расположение панели управления плеера:
    • внизу (bottom) - снизу окна просмотра;
    • не показывать (none) - панель управления будет скрыта.
    Автоматически начать проигрывать При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.
    Уровень громкости в процентах от максимального Указывается уровень громкости звука в процентах от максимального заданного в системе.
    Настройки Flash-плеера
    Скин Выбирается скин Flash плеера. Стандартный скин Flash плеера доступен в любом случае.
    Дополнительные переменные Flashvars Указываются дополнительные переменные для плеера.
    Режим окна (WMode) Указывается режим окна Flash плеера:
    • Обычный - медиафайл будет проигрываться на странице в собственном прямоугольном окне. Этот вариант дает наибольший выигрыш в скорости воспроизведения анимации;
    • Непрозрачный - медиафайл будет помещен на задний план страницы;
    • Прозрачный - фон страницы будет "проглядывать" через все прозрачные места медиафайла при проигрывании. Этот вариант может замедлить скорость воспроизведения анимации.
    Настройки WMV-плеера
    Цвет фона панели управления Указывается код цвета для фона панели управления плеера.
    Цвет элементов управления Указывается код цвета для элементов управления плеера.
    Цвет элементов управления при наведении указателя мыши Указывается код цвета для элементов управления плеера при наведении указателя мыши.
    Цвет экрана Указывается код цвета для экрана плеера.
    Дополнительные переменные Silverlight Указываются дополнительные переменные для плеера.
    Режим окна Указывается режим окна WMW плеера:
    • Обычный - окно плеера будет убрано за HTML элементы страницы;
    • Прозрачный - окно плеера будет отображаться непосредственно в клиентской области обозревателя или внутри специально созданного окна.
    Деньги
    Значение по умолчанию Устанавливается валюта, которая будет значением по умолчанию. Изначально стоит базовая валюта.
    Шаблон
    Шаблон вывода (#VALUE# - значение)Указывается требуемый шаблон, например, <a href="callto:#VALUE#">#VALUE#</a>
    Значение по умолчанию Можно определить значение по умолчанию.
    Размер поля ввода для отображения Указывается размер поля ввода, каким он будет отображен в форме, где используется данное поле.
    Количество строчек поля ввода Указывается количество строчек поля ввода.
    Минимальная длина строки (0 - не проверять) Можно ограничить размер строки по минимальному значению. Если 0, то не ограничивать.
    Максимальная длина строки (0 - не проверять) Можно ограничить ограничить размер строки по максимальному значению. Если 0, то не ограничивать.
    Регулярное выражение для проверки Можно ввести регулярное выражение для ограничения вводимых значений поля. Регулярное выражение необходимо ограничить любыми удобными символами, например, /^T.+N$/ либо #^T.+N$#.
    Список
    Внешний вид Указывается тип внешнего вида:
    • Список;
    • Флажки.
    Высота списка Указывается высота списка.
    Подпись при отсутствии значения Добавляется текст, который будет выводиться при отсутствии значений.
    Пункты списка задаются после сохранения изменений (кнопка Применить) на закладке Список.
    Строка
    Значение по умолчанию Можно определить значение по умолчанию.
    Размер поля ввода для отображения Указывается размер поля ввода, каким он будет отображен в форме, где используется данное поле.
    Количество строчек поля ввода Указывается количество строчек поля ввода.
    Минимальная длина строки (0 - не проверять) Можно ограничить размер строки по минимальному значению. Если 0, то не ограничивать.
    Максимальная длина строки (0 - не проверять) Можно ограничить ограничить размер строки по максимальному значению. Если 0, то не ограничивать.
    Регулярное выражение для проверки Можно ввести регулярное выражение для ограничения вводимых значений поля. Регулярное выражение необходимо ограничить любыми удобными символами, например, /^T.+N$/ либо #^T.+N$#.
    Дата со временем или Дата
    Значение по умолчанию Выбирается один из возможных вариантов:
    • нет - значения по умолчанию не будет;
    • текущее время - значением по умолчанию будет текущая дата на момент заполнения;
    • также значение по умолчанию может быть установлено вручную с использованием календаря. При выборе даты в типе Дата со временем возможна установка времени.
    Привязка к разделам (элементам) инф. блоков
    Инфоблок Указывается тип информационного блока и инфоблок из доступных в системе.
    Значение по умолчанию Можно определить значение по умолчанию.
    Внешний вид Указывается тип внешнего вида:
    • Список;
    • Флажки.
    Высота списка Указывается высота списка.
    Показывать только активные разделы (элементы) [Y|N] При отмеченной опции будут выведены только активные разделы. Неактивные будут скрыты.
    Привязка к элементам CRM (для коробочной версии Битрикс24)
    Доступная сущность Выбираются сущности CRM: Лид, Контакт, Компания, Сделка.
    Для разработчиков: формат хранения информации в поле типа "Привязка к элементам CRM":
    array("L_1", "D_2", "C_3", "CO_4")

    где:

    • L - лид
    • D - сделка
    • C - контакт
    • CO - компания
    • цифра - ID сущности
    Привязка к справочникам CRM (для коробочной версии Битрикс24)
    Доступная сущность Выбираются сущности из списка.
    Файл
    Размер поля ввода для отображения Указывается размер поля ввода, каким он будет отображен в форме, где используется данное поле. По умолчанию указано 20.
    Максимальные ширина и высота для отображения в списке Указывается максимальная ширина и высота изображения для отображения в списке. Если размер изображения больше заданного, то изображение будет уменьшено (<img src="..." width="<w>" height="<h>">).
    Максимально допустимый размер для показа в списке (0 - не ограничивать) Указывается максимально допустимый размер изображения для показа в списке. Если размер изображения больше указанного, то в списке будет выведена ссылка на изображение. Если указано 0, то не ограничивать.
    Максимально допустимый размер файла для загрузки (0 - не проверять) Указывается максимально допустимый размер файла в байтах для загрузки. Если указано 0, то не проверять.
    Расширения Указываются допустимые расширения файлов через запятую. Например: jpg,png,bmp.
    Целое число
    Значение по умолчанию Можно определить значение по умолчанию.
    Размер поля ввода для отображения Указывается размер поля ввода, каким он будет отображен в форме, где используется данное поле. По умолчанию указано 20.
    Минимальне значение (0 - не проверять) Можно установить минимальное допустимое значение. Если установлено 0, то не проверять.
    Максимальное значение (0 - не проверять) Можно установить максимальное допустимое значение. Если установлено 0, то не проверять.
    Опросы
    Группа опросов Выбор группы опросов, ссылка перехода к созданию новой группы.
    Заголовок Заголовок опроса.
    Символьный идентификатор Символьный код (на латинице).
    Использовать CAPTCHA Опция используется, если необходимо использовать CAPTCHA (для неавторизованных пользователей).
    Список групп - уровень прав Отображается список всех групп пользователей в системе. Задаются права для доступа к опросам. По умолчанию все авторизованные могут участвовать в опросе, а неавторизованные - просматривать результаты.
    Оповещать автора опроса о голосе Выбор уведомления автора и способ уведомления.
    Не голосовать дважды Задание ограничений на головасание. с одним cookie - голосовать можно один раз в сессию, с одного IP голосовать можно только с разных IP, с одним ID пользователя - голосовать можно только раз для каждого пользователя.
    Запретить голосование пользователям, зарегистрированным после даты начала опроса Флажок в этом поле разрешит голосование только для тех пользователей, которые зарегистрировались на сайте до начала опроса.
    Ссылка
    Открывать в новом окне Открывать ссылку в новом или в текущем окне. По умолчанию - в новом.
    Значение по умолчанию Значение, которое будет показываться до замены на нужную ссылку.
    Размер поля ввода для отображения Размер окна для ввода ссылки в знаках.
    Минимальная длина строки Ограничение на минимальную длину ссылки. Если число знаков в ссылке меньше значения этого пол, то ссылка добавлена не будет. Значение "0" - длина проверяться не будет.
    Максимальная длина строки Ограничение на максимальную длину ссылки. Если число знаков в ссылке больше значения этого пол, то ссылка добавлена не будет. Значение "0" - длина проверяться не будет.
    Адрес
    Показывать карту При установке флажка будет выведена карта для этого пользовательского поля.
    Языковые настройки
    Поле служит для задания языковых настроек пользовательского поля.
    Язык Подпись в форме редактирования Заголовок в списке Подпись фильтра в списке Сообщение об ошибке (не обязательное) Помощь
    [1] [2] [3] [4] [5] [6]
    ПолеОписание
    [1] ЯзыкПеречислены все языки, установленные в системе.
    [2] Подпись в форме редактированияМожно определить для каждого из установленных языков подпись поля в форме редактирования. Если поле пусто в форме редактирования будет выведен код поля.
    [3] Заголовок в спискеМожно определить для каждого из установленных языков подпись поля в списке, т.е. в отчетной форме. Если поле пусто в списке поле будет представлено кодом (в случае, если настроено, что поле должно отображаться в списке).
    [4] Подпись фильтра в спискеМожно определить для каждого из установленных языков подпись поля в фильтре, т.е. как поле будет отображено в форме поиска. Если поле пусто в фильтре поле будет представлено кодом (в случае, если настроено, что поле должно отображаться в фильтре).
    [5] Сообщение об ошибкеСообщение об ошибке, которое будет выводиться в форме, где применяется поле. Действует для типа данных Строка, например, при несоответствии введенного значения регулярному выражению, определённому для поля.
    [6] ПомощьПоле для ввода сообщений помощи. Поле ведется внутри системы, но пока нигде не выводится. Вы можете вывести его самостоятельно там, где необходимо.

    * - поля, обязательные для заполнения.

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

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

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

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

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