Записи справочников

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

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Внешний вид

Вертикальная ориентация

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

Заполнитель

Текст, отображаемый в элементе управления, если значение не выбрано.

Локализуемый

Отображать метку без значения

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

  • Для режима просмотра:

    • Когда флаг установлен, текст метки отображается всегда.

    • Когда флаг не установлен, текст метки отображается, только если задано значение ЭУ.

  • Для режима редактирования:

    • Когда флаг установлен, текст метки отображается всегда.

    • Когда флаг не установлен, текст метки отображается только если поле содержит значение или редактируется. Для полей в режиме редактирования рекомендуется указывать Заполнитель.

Подсказка

Содержимое всплывающей подсказки.

Локализуемый

Текст метки

Содержимое метки, отображаемой слева от элемента управления.

Локализуемый

Данные

Расширенный источник данных

Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.

Источник данных

Секция карточки, содержащая данные элемента управления.

Типы значений

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

Окно "Типы значений"
Рисунок 1. Окно "Типы значений"

  • Внешний вид

    • Название — отображаемое название типа

    • CSS-класс иконки — класс иконки, которая будет отображаться слева от названия элемента данного типа, а также слева от названия типа элемента при выборе из нескольких доступных типов.

  • Данные

    • Поле данных — поле типа RefId со ссылкой на строку карточки справочника, в которое будет сохранено значение данного типа.

    • Справочник — карточка справочника, из которой будет выбираться значение ЭУ данного типа. Например, если выбран один из справочников, поддерживающих редактирование, становятся доступными для редактирования свойства: Редактирование справочника, Узел.

    • Секция справочника — табличная или древовидная секция выбранной карточки справочника, из строк которой будет выбираться значение ЭУ данного типа. Если в параметре Справочник выбран один из справочников, поддерживающих редактирование, и в текущем параметре выбрано Сотрудники, становятся доступными для редактирования свойства Редактирование справочника и Узел.

    • Отображаемое поле — строковое поле секции справочника, значение которого будет использовано в качестве строки отображения элемента данного типа.

    • Отображаемое поле родительской секции — строковое поле, значение которого используется в качестве строки отображения для родительского элемента при построении иерархических структур (например, в справочниках с древовидной вложенностью).
      Поле становится доступным, если в свойстве "Секция справочника" выбрана табличная секция.

    • Поле для поиска — строковые поля секции справочника, по которым будет осуществляться поиск строки секции (объединяются по ИЛИ) данного типа.

      Выбор полей для поиска
      Рисунок 2. Выбор полей для поиска

    • Дополнительные поля — список полей и их названий, которые будут отображены в выпадающем списке элементов и форме поиска, выбора элементов и отображения значения. Появившееся окно позволяет добавить необходимое количество дополнительных полей. Для каждого добавленного поля можно задать отображаемое имя. Можно выбрать как простые поля, так и ссылочные.
      Если в колонке "Отображать в выбранном значении" установлен флаг, значение данного поля отображается в скобках через запятую. Например, если в ЭУ выбраны подразделения, а в дополнительных полях указана почта с включенным флагом, то в итоге отображение будет таким: User (user@example.com).

    • Имя плагина для доп. полей — можно указать плагин, который будет использован для получения дополнительных полей кодом. Это будет полезно для получения данных из, например, карточек сотрудников, подразделений, строк конструктора справочников, либо по какой-либо другой сложной логике. См. подробнее "Расширение возможностей ЭУ "Записи справочников"" в документации для разработчиков.

  • Редактирование

    • Редактирование справочника — параметр, который в форме выбора из одного типа значений отображает кнопку добавления новых значений для справочников, поддерживающих редактирование.

    • Узел — ID узла, в котором должны создаваться записи по кнопке добавления новых значений. Если узел не указан, элементы будут добавляться в текущий выбранный узел (добавление доступно когда выбран только один тип значений).

  • Ограничение

    • Только дочерние элементы — если флаг установлен и указано Ограничение, то поиск и выбор будут осуществляться только из дочерних элементов строки ограничения, а не всех потомков.

    • Ограничение — ID строки секции справочника, которая будет выступать ограничением при поиске строки секции (например, ID подразделения при выборе сотрудников).

      Если выбрана табличная секция, выбираемые элементы будут ограничены по полю ParentRowID. Если выбрана древовидная секция, то выбираемые элементы будут ограничены по полю ParentTreeRowID.

Операция редактирования

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

Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).

Поведение

Выбор одного элемента

Позволяет настроить возможность выбора только одной строки справочника. Если выбор одного элемента запрещён, ЭУ должен быть привязан к табличной секции.

Не показывать недоступные значения

Даёт возможность выбирать строки справочника, помеченные как недоступные для выбора. Если поля NotAvailable нет в секции справочника, данная настройка игнорируется.

Поисковой индекс

Количество символов в текстовом поле, необходимое для начала поиска значений элементом управления.

Кол-во загружаемых за раз элементов

Количество результатов на "порцию" поиска. В зависимости от значения количество результатов поиска, отображаемых за один раз может изменяться.

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Обязательное

Определяет требование к заполнению значения ЭУ до сохранения карточки:

  • Когда флаг установлен, значение ЭУ должно быть присвоено, иначе карточка не будет сохранена. При этом ЭУ помечается предупреждающим сообщением.

  • Когда флаг не установлен, присваивать значение необязательно.

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

Показывать иконку

Свойство регулирует отображение иконки элемента управления. Когда флаг установлен (по умолчанию) иконка ЭУ отображается. Когда флаг снят, иконка не отображается.

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

Определяет вариант отображения элемента управления и возможность изменения его значения:

  • По месту. Значение изменяется нажатием на элемент управления.

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

  • Редактирование. Значение изменяется непосредственно в элементе управления.

    Данный вариант может быть выбран в разметке режима редактирования и просмотра.

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

  • Без редактирования. Значение изменить нельзя.

В зависимости от выбранного режима редактирования ЭУ отображается по-разному. См. подробнее "Записи справочников" в руководстве пользователя.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

События

После закрытия окна справочника

Вызывается после закрытия окна выбора значения из справочника.

После открытия окна справочника

Вызывается после открытия окна выбора значения из справочника.

После загрузки результатов поиска

Вызывается после загрузки результатов поиска.

Перед закрытием окна справочника

Вызывается перед закрытием окна выбора значения из справочника.

Перед открытием окна справочника

Вызывается перед открытием окна выбора значения из справочника.

Перед загрузкой результатов поиска

Вызывается перед загрузкой результатов поиска.

При потере фокуса

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

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.

После смены данных

Вызывается после изменения содержимого элемента управления.

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

Вызывается после закрытия окна редактирования в режиме редактирования По месту.

Перед закрытием окна редактирования

Вызывается перед закрытием окна редактирования в режиме редактирования По месту.

После открытия окна редактирования

Вызывается после открытия окна редактирования в режиме редактирования По месту.

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

Вызывается перед открытием окна редактирования в режиме редактирования По месту.

При получении фокуса

Вызывается, когда элемент управления выбирается.

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

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