Строка конструктора справочников

Элемент управления Строка конструктора справочников предназначен для отображения и выбора строки из Конструктора справочников.

Вариант отображения ЭУ зависит от свойства Режим редактирования:

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

    Элемент управления "Строка конструктора справочников" в режиме редактирования
    Рисунок 1. Элемент управления "Строка конструктора справочников" в режиме редактирования

    Быстрый поиск осуществляется по названию записи, а в режиме выбора из справочника — по названию и описанию.

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

    Элемент управления "Строка конструктора справочников" в режиме редактирования по месту
    Рисунок 2. Элемент управления "Строка конструктора справочников" в режиме редактирования по месту

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

Для ЭУ можно настроить ограничение области выбора:

  • Ограничить выбор записи определённым узлом Конструктора справочников.

  • Ограничить быстрый поиск для выбора организации или подразделения.

  • Ограничить область выбора: только узел или узел и дочерние узлы.

Если ЭУ используется в разметке с режимом Создание или Редактирование и разметка не была сохранена явным образом, при обновлении страницы выбранное в элементе значение будет сброшено даже если ЭУ находится в режиме редактирования по месту.

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Внешний вид

Заполнитель

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

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

Использовать описание

Данное свойство влияет на отображение поля описание при открытии справочника.

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

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

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

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

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

Подсказка

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

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

Текст метки

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

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

Данные

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

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

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

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

Чтобы выбрать источник данных, нажмите кнопку Три точки. Будет открыто окно:

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

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

Настройки источника содержат следующие элементы:

"Секция"

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

Столбец "Доступность выбора"

Регулирует доступность выбора узлов и/или записей справочнике в элементе управления при помощи настроек в полях Узел и Запись.

Узел

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

Запись

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

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

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

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

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

Поведение

Видимость

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

Адаптивный

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

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

Доступные изменения

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

Доступные варианты:

  • Никакие — любые изменения запрещены.

  • Узлы — разрешено изменять только узлы.

  • Строки — разрешено изменять только строки.

  • Узлы и строки — разрешено изменять и узлы и строки.

Редактирование и работа с ЭУ описаны в разделе "Строка конструктора справочников".

Задержка поиска (мс)

Определяет время задержки (в мс) от ввода последнего символа в строку поиска до выполнения быстрого поиска по справочнику.

Значение по умолчанию

Строка Конструктора справочников, выбранная по умолчанию.

Область выбора

Устанавливает ограничение возможности выбора пользователем строк из узла Конструктора справочников:

  • Только выбранный узел. Пользователю будут доступны для выбора только строки выбранного узла.

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

  • Выбранный и дочерние к нему. Пользователю будут доступны для выбора узлы и строки выбранного узла и его подчиненных узлов.

Данная настройка отображается, только когда в свойстве Узел выбран узел.

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

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

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

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

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

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

  • Когда флаг Видимость установлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования.

  • Когда флаг Видимость установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда.

  • Когда флаг Видимость НЕ установлен, ЭУ всегда скрыт.

Отключен

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

Адаптивный

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

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

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

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

Разрешить поиск узла

Флаг позволяет выполнять поиск узлов. Если флаг установлен (по умолчанию), поиск узлов доступен.

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

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

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

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

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

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

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

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

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

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

Узел

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

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

События

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

При щелчке

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